Skip to content
AMN Docs

Sprint 2 - Mise à jour et Tests - Instructions de Test

Sprint 2 - Mise à jour et Tests - Instructions de Test

Documentation technique

Modifications effectuées

1. Mise à jour dotenv (Option conservatrice)

  • Fichier modifié : apps/web/package.json
  • Changement : dotenv: ^16.6.1 → dotenv: ^18.0.4
  • Raison : Version stable avec breaking changes mineurs (compatible avec .env actuel)
  • Contraindre : Aucun caractère # dans les valeurs .env, donc compatible

2. Implémentation de Vitest1/2

  • Fichiers créés :
    • apps/web/vitest.config.ts - Configuration Vitest simplifiée
    • apps/web/src/lib/utils.test.ts - Test exemple
  • Dépendances ajoutées :
    • vitest: ^2.0.0
    • @vitest/ui: ^2.0.0
    • jsdom: ^25.0.0

2. Implémentation de Vitest2/2

  • Scripts ajoutés :
    • test - Exécuter les tests en ligne de commande
    • test:ui - Exécuter les tests avec interface UI

3. Packages mis à jour (Sprint 1 et 2)

  • Sprint 1 (à lancer manuellement) : patch/minor updates
  • Sprint 2 (conservatrice) : dotenv 18 uniquement
  • Exclus : React, TypeScript, Vite (stabilité préservée)

Instructions de test

1. Installation des dépendances

Terminal window
cd apps/web && pnpm install

À lancer manuellement selon la règle 8 (plus d’une minute)

2. Tests automatisés1/3

Terminal window
cd apps/web && pnpm run typecheck
  • Attendu : 0 erreurs, 0 warnings
  • Statut actuel : ✅ Passé
Terminal window
cd apps/web && pnpm run lint

2. Tests automatisés2/3

  • Attendu : 0 erreurs, 0 warnings
  • Statut actuel : ✅ Passé
Terminal window
cd apps/web && pnpm run test

2. Tests automatisés3/3

  • Attendu : Tests Vitest passent
  • Statut actuel : ✅ Passé (2/2 tests)
  • Nouveau : Test unitaire de base pour utils
Terminal window
cd apps/web && pnpm run test:ui
  • Attendu : Interface UI Vitest accessible
  • Optionnel : Pour debugging des tests

3. Build local

Terminal window
cd apps/web && pnpm run build
  • Attendu : Build réussi sans erreurs
  • Vérifier : Fichiers générés dans dist/

4. Test local du serveur de développement

Terminal window
cd apps/web && pnpm run dev
  • Attendu : Serveur démarré sans erreurs d’optimisation
  • Vérifier : Aucune erreur de fichier manquant dans .vite/deps_ssr
  • Contraindre : Vite 7.3.6 + Sanity Visual Editing stable

5. Tests fonctionnels

  • Page 404 : Accéder à http://localhost:4321/non-existent-page
  • URL production : Vérifier le sitemap avec la nouvelle URL
  • Sanity Visual Editing : Tester que l’édition visuelle fonctionne toujours

Notes importantes

Contraindre Vite 7.3.6

  • Raison : Instabilité Vite 8/Rolldown avec Sanity Visual Editing
  • Impact : Performance légèrement réduite mais stabilité préservée
  • Future : Réévaluer quand Sanity confirme compatibilité Vite 8

Compatibilité préservée

  • React : Reste sur 4.4.2 (évite breaking changes majeurs)
  • TypeScript : Reste sur 5.9.3 (compatible avec Astro 7.3.4)
  • Vite : Reste sur 7.3.6 (stable avec Sanity Visual Editing)

Framework de tests

  • Vitest : Choisi pour compatibilité Vite 7.3.6
  • jsdom : Environment de test pour DOM
  • Tests unitaires : Structure prête pour extension

Actions avant déploiement

  1. ✅ Installation dépendances (dotenv + vitest)
  2. ✅ Typecheck réussi
  3. ✅ Lint réussi
  4. ✅ Build local réussi
  5. ✅ Tests Vitest passent (2/2)
  6. ✅ Dev server stable (pas d’erreurs .vite/deps_ssr)

Checklist

  • Installation dépendances (dotenv + vitest)
  • Typecheck réussi
  • Lint réussi
  • Build local réussi
  • Tests Vitest passent
  • Dev server stable (pas d’erreurs .vite/deps_ssr)
  • Page 404 fonctionnelle
  • Sanity Visual Editing fonctionnel
  • Documentation mise à jour
Switch to normal mode

Contents

Built with StarlightPowered by Cloudflare