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

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 Vitest

• 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
• 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

cd apps/web && pnpm install

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

2. Tests automatisés

cd apps/web && pnpm run typecheck

• Attendu : 0 erreurs, 0 warnings
• Statut actuel : ✅ Passé

cd apps/web && pnpm run lint

• Attendu : 0 erreurs, 0 warnings
• Statut actuel : ✅ Passé

cd apps/web && pnpm run test

• Attendu : Tests Vitest passent
• Statut actuel : ✅ Passé (2/2 tests)
• Nouveau : Test unitaire de base pour utils

cd apps/web && pnpm run test:ui

• Attendu : Interface UI Vitest accessible
• Optionnel : Pour debugging des tests

3. Build local

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

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