veza/apps/web/e2e/README.md
senke 542e4750a9 test(e2e): add post-deploy smoke tests
- Add smoke-post-deploy.spec.ts for health checks
- Add playwright.config.smoke.ts (no webServer)
- Add smoke-post-deploy job to cd.yml (runs when STAGING_URL set)
- Document procedure in e2e/README.md
2026-02-14 22:45:10 +01:00

3.1 KiB

E2E Tests — Parcours critiques et fichiers

Ce document liste les parcours critiques couverts par les tests E2E Playwright et les fichiers associés.

Parcours critiques

Parcours Fichier(s) Description
Auth tests/auth.spec.ts Login, register, logout, route guards, token refresh. Optionnel : 2FA (compte test dédié).
Smoke tests/smoke.spec.ts Login → Upload → Création playlist → Ajout track.
Playlists tests/playlists.spec.ts Création, liste, modification, ajout/suppression de tracks, suppression playlist, recherche.
Search tests/search.spec.ts Navigation vers /search, saisie requête, vérification des résultats (tracks/playlists) ou état vide.
Play tests/play.spec.ts Après login : search → clic sur un track → page track ou player visible (ou état vide si pas de résultats).
Profile tests/profile.spec.ts Affichage profil, informations compte.
Upload tests/upload.spec.ts Upload fichier, upload par chunks.
Post-deploy smoke tests/smoke-post-deploy.spec.ts Health checks (homepage, login, API) against deployed URL.

Post-deploy smoke tests

Run against a deployed environment (staging/production) without starting the dev server:

PLAYWRIGHT_BASE_URL=https://staging.veza.com npx playwright test --config=playwright.config.smoke.ts

Or with VITE_FRONTEND_URL:

VITE_FRONTEND_URL=https://app.veza.com npx playwright test --config=playwright.config.smoke.ts

In CI (cd.yml), the smoke job runs after deploy when STAGING_URL (secret or variable) is configured.

Prérequis

  • Frontend servi (ex. npm run dev) sur l'URL configurée dans TEST_CONFIG.FRONTEND_URL.
  • Backend API disponible pour auth, search, playlists, upload.
  • Compte de test valide (voir e2e/utils/test-helpers.ts : TEST_USERS.default).

Lancer les E2E

cd apps/web
npm run test:e2e
# ou
npx playwright test

Pour un fichier précis :

npx playwright test e2e/tests/auth.spec.ts

Machine à ressources limitées : lancer un seul spec à la fois et un seul projet (chromium) pour éviter saturation CPU/RAM. Les specs auth, smoke, playlists, search nécessitent que le Backend API soit démarré (sinon les appels API échouent en 500). En CI, la suite complète tourne dans le cloud.

npx playwright test e2e/tests/auth.spec.ts --project=chromium

2FA E2E

Le test « should complete login with 2FA code » dans auth.spec.ts s'exécute uniquement lorsque E2E_2FA_CODE est défini. Pour lancer le test 2FA en CI ou en local :

  • Obligatoire : E2E_2FA_CODE — code TOTP valide au moment de l'exécution (ou code de test si l'env le permet).
  • Optionnel : E2E_2FA_EMAIL — email du compte 2FA (défaut : TEST_USERS.default.email).
  • Optionnel : E2E_2FA_PASSWORD — mot de passe du compte (défaut : TEST_USERS.default.password).

Exemple :

E2E_2FA_CODE=123456 E2E_2FA_EMAIL=user@example.com E2E_2FA_PASSWORD=secret npx playwright test e2e/tests/auth.spec.ts -g "2FA"