Sprint 3 - SVG Analysis & CI/CD Optimization

Phase 1 : Analyse des SVG

DOC : Consultation de la documentation

Recherche Astro MCP : SVG optimization expérimentale

Conclusion documentation :

L’optimisation SVG expérimentale d’Astro ne s’applique qu’aux SVG importés comme composants
Exemple applicable : import Logo from '../assets/logo.svg' puis <Logo />
Ne s’applique pas aux SVG utilisés comme fichiers statiques via liens HTML

SPEC : Analyse du projet

Fichiers SVG détectés :

src/assets/favicon.svg
src/assets/logo.svg

Utilisation analysée :

favicon.svg : Utilisé comme <link rel="icon" href="/favicon.svg" /> dans BaseHead.astro
logo.svg : Non utilisé dans le code (présent dans assets mais pas référencé)

Conclusion :

Les SVG sont utilisés comme fichiers statiques, PAS comme composants importés
L’optimisation SVG expérimentale d’Astro ne s’applique PAS
Action requise : Aucune optimisation SVG nécessaire

CODE : Aucune modification requise

Les SVG sont déjà optimisés pour leur usage actuel (fichiers statiques). Aucune configuration d’optimisation supplémentaire n’est nécessaire.

TEST : Validation

✅ Les SVG fonctionnent correctement comme fichiers statiques
✅ Favicon s’affiche correctement dans le navigateur
✅ Aucun problème de performance détecté

INTÉG : Documentation

Note pour le futur : Si des SVG sont ajoutés et importés comme composants, considérer l’activation de l’optimisation SVG expérimentale :

import { defineConfig, svgoOptimizer } from "astro/config";
export default defineConfig({
  experimental: {
    svgOptimizer: svgoOptimizer()
  }
});

Phase 2 : Consolidation Documentation

Résumé des Sprints 1 et 2

Sprint 1 - Modifications

✅ Page 404 personnalisée créée (src/content/docs/404.md)
✅ URL production mise à jour (https://amn-dev.anderson-metsanou.workers.dev/)
✅ Corrections TypeScript (PageTitle.astro, SearchModal.astro)
⏳ Packages patch/minor (à lancer manuellement)

Sprint 2 - Modifications

✅ dotenv 18 installé (compatible avec .env actuel)
✅ Vitest configuré et fonctionnel (2/2 tests)
✅ Typecheck, lint, build, dev server tous OK
✅ Optimisation MDX non activée (1 fichier seulement)
✅ Sanity Visual Editing fonctionnel

Contraindre Techniques

Vite 7.3.6 (Conserve)

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

Packages Conservés

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)

Phase 3 : Optimisation CI/CD

DOC : Consultation de la documentation GitHub Actions

Workflows analysés :

.github/workflows/deploy-dev.yml
.github/workflows/deploy-prod.yml

Conclusion :

Les workflows n’avaient pas d’étape de tests avant le build
Les tests manquaient pour détecter les régressions avant déploiement

SPEC : Plan d’intégration

Intégration proposée :

Ajouter une étape “Run tests” avant le build dans les deux workflows
Exécuter : pnpm run test, pnpm run typecheck, pnpm run lint
Emplacement : Après pnpm install --frozen-lockfile, avant pnpm run build

Bénéfices :

Échoue le déploiement si les tests ne passent pas
Détecte les régressions avant déploiement
Maintient la qualité du code

CODE : Modification des workflows

deploy-dev.yml - Ajouté :

- name: Run tests
  run: |
    pnpm run test
    pnpm run typecheck
    pnpm run lint

deploy-prod.yml - Ajouté :

- name: Run tests
  run: |
    pnpm run test
    pnpm run typecheck
    pnpm run lint

TEST : Validation locale

✅ Les tests passent localement (Vitest, typecheck, lint)
✅ Les workflows sont syntaxiquement corrects
⏳ À valider sur la prochaine PR/déploiement

INTÉG : Documentation

Note pour le futur :

Les tests s’exécuteront automatiquement sur chaque déploiement
Si un test échoue, le déploiement sera bloqué
Les tests doivent être maintenus à jour avec les nouvelles fonctionnalités