Execute testes ponta a ponta (E2E)¶

Os testes E2E da Gitrust usam o Playwright para direcionar um navegador Chromium em uma instância do aplicativo configurada com um banco de dados dedicado e um diretório de repositório.

Pré-requisitos¶

• Node.js (já presente para Tailwind/DaisyUI)
• PostgreSQL acessível localmente (Docker via database/docker-compose.yml)
• psql, createdb, dropdb disponíveis no PATH
• Chromium instalado via Playwright (npx playwright install chromium)

Pedidos¶

# Créer (ou remettre à zéro) la base de données de test
npm run test:e2e:setup

# Lancer tous les tests E2E
npm run test:e2e

# Mode debug interactif (inspecteur Playwright, pas-à-pas)
npm run test:e2e:debug

# Mode UI (interface graphique Playwright)
npm run test:e2e:ui

# Consulter le rapport HTML après exécution
npm run test:e2e:report

Arquitetura¶

.env.test                         # Variables d'environnement de test
playwright.config.ts              # Configuration Playwright

scripts/
  e2e-setup-db.sh                 # Crée la DB gitrust_test + nettoie depot_test
  e2e-server.sh                   # Démarre l'app avec .env.test

tests/e2e/
  fixtures.ts                     # Fixtures partagées (loginAs, credentials)
  global-setup.ts                 # Seed : crée les utilisateurs via /register
  global-teardown.ts              # Nettoyage post-tests
  auth.spec.ts                    # Tests d'authentification
  repository.spec.ts              # Tests de gestion des dépôts
  admin.spec.ts                   # Tests du panneau d'administration
  navigation.spec.ts              # Tests de navigation et UI

Isolamento do ambiente de teste¶

Funcionamento¶

1. npm run test:e2e:setup exclui e recria o banco de dados gitrust_test e esvazia depot_test/.
2. Playwright inicia automaticamente o aplicativo via scripts/e2e-server.sh, que carrega as variáveis ​​de .env.test antes de executar cargo run.
3. A configuração global cria os usuários de teste (alice, bob, charlie) usando o formato /register — abordagem 100% E2E, sem inserção direta no banco de dados.
4. Os testes são executados sequencialmente (um único trabalhador) para evitar conflitos no banco de dados compartilhado.
5. O global-teardown é executado no final da sessão.

Jogos¶

O arquivo fixtures.ts fornece um fixture loginAs que é reutilizável em todos os testes:

import { test, expect } from './fixtures';

test('mon test', async ({ page, loginAs }) => {
  await loginAs('alice');
  // alice est connectée, on peut naviguer
});

Usuários disponíveis: admin, alice, bob, charlie.

Lista de testes¶

auth.spec.ts — Autenticação¶

repository.spec.ts — Gerenciamento de repositório¶

admin.spec.ts — Administração¶

navigation.spec.ts — Navegação e IU¶

Adicionar um novo teste¶

1. Crie um arquivo tests/e2e/mon-module.spec.ts
2. Importar fixtures: importar {test, expect} de './fixtures';
3. Use loginAs para testes que requerem autenticação
4. Execute com npm run test:e2e ou direcione o arquivo: npx playwright test my-module