PD-226 — Configuration Astro initiale¶

1. Objectif¶

Définir les exigences contractuelles pour l'initialisation d'un projet Astro servant de base au site vitrine ProbatioVault.

2. Périmètre / Hors périmètre¶

Périmètre : structure du projet, build statique, configuration de base.

Hors périmètre : contenu éditorial, design, déploiement.

3. Définitions¶

• Astro : générateur de site statique (SSG).

4. Invariants¶

1. Le site est entièrement statique (aucun SSR/ISR, aucune dépendance à un runtime serveur) et reste testable/offlinable ; seules les balises d’analytics peuvent ne pas fonctionner hors-ligne (toutes les polices et assets doivent être locaux).
2. Le rendu est fonctionnel sans JavaScript.
3. Fonctionnalités minimales garanties sans JS : navigation interne, menus, formulaires de contact, accès au contenu.
4. Les ressources critiques (polices, CSS, JS nécessaires à l’affichage) sont servies en local pour garantir l’offline.
5. Les dépendances externes sont limitées à une liste blanche explicite (CSP, COOP/COEP, Referrer-Policy) ; tout autre domaine est bloqué.
6. Analytics : uniquement domaines Google Analytics/Tag Manager autorisés ; absence de collecte en mode offline/no-JS ou sans consentement.
7. Formulaires Brevo : uniquement endpoints Brevo autorisés en connect-src ; dégradation acceptable sans JS/offline (message ou absence d’envoi).

5. Flux nominaux¶

• Initialisation du projet.
• Génération du build statique.

6. Cas d'erreur¶

• Échec de build.

7. Critères d'acceptation¶

• Le site se génère sans erreur.

8. Scénarios de test¶

Given un projet Astro initialisé When un build est exécuté Then des fichiers statiques sont produits

Given le projet Astro When astro check est exécuté Then aucun avertissement ni erreur de SSR/ISR/adaptateur serveur n’est signalé

9. Hypothèses explicites¶

• Astro est disponible.

10. Points à clarifier¶

• Version cible : Astro 5.16.

User Story¶

• Implementation Plan
• Critères d'acceptabilité
• Retour d'expérience