Ejecute pruebas de un extremo a otro (E2E)¶

Las pruebas E2E de Gitrust utilizan Playwright para comparar un navegador Chromium con una instancia de la aplicación configurada con una base de datos dedicada y un directorio de repositorio.

Requisitos previos¶

• Node.js (ya presente para Tailwind/DaisyUI)
• PostgreSQL accesible localmente (Docker a través de database/docker-compose.yml)
• psql, createdb, dropdb disponibles en la RUTA
• Chromium instalado a través de Playwright (npx playwright install chromium)

Órdenes¶

# 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

Arquitectura¶

.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

Aislamiento del entorno de prueba.¶

Marcha¶

1. npm run test:e2e:setup elimina, luego vuelve a crear la base de datos gitrust_test y vacía depot_test/.
2. Playwright inicia automáticamente la aplicación a través de scripts/e2e-server.sh, que carga las variables desde .env.test antes de ejecutar cargo run.
3. La configuración global crea los usuarios de prueba (alice, bob, charlie) usando el formulario /register: enfoque 100% E2E, sin inserción directa en la base de datos.
4. Las pruebas se ejecutan secuencialmente (un solo trabajador) para evitar conflictos en la base de datos compartida.
5. El desmontaje global se ejecuta al final de la sesión.

Calendario¶

El archivo fixtures.ts proporciona un dispositivo loginAs que es reutilizable en todas las pruebas:

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

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

Usuarios disponibles: admin, alice, bob, charlie.

Lista de pruebas¶

auth.spec.ts — Autenticación¶

repository.spec.ts — Gestión del repositorio¶

admin.spec.ts — Administración¶

navigation.spec.ts — Navegación y UI¶

Agregar una nueva prueba¶

1. Cree un archivo tests/e2e/mon-module.spec.ts
2. Importar accesorios: importar {prueba, esperar} desde './fixtures';
3. Utilice loginAs para pruebas que requieran autenticación
4. Ejecute con npm run test:e2e o apunte al archivo: npx playwright test my-module