001 — Processus de documentation et de validation du projet

Date : 07/07/2026 · Statut : 🟡 Proposée — à valider avec Cap Veggie · Validée par : —

Contexte

Le projet dispose d'un budget fixe de 4 sprints. Les échanges autour des maquettes ont montré qu'un même élément d'interface peut être compris très différemment (ex. une section « best-seller » comprise comme un score calculé alors qu'il s'agit d'une sélection éditoriale). Il faut un cadre qui sécurise les décisions, pour Cap Veggie comme pour l'équipe de développement.

Options envisagées

Option	Avantages	Inconvénients
a) Échanges au fil de l'eau (mail, réunions) sans référence écrite	Léger	Ambiguïtés découvertes en cours de développement, décisions rouvertes, budget non tenu
b) Cahier des charges exhaustif rédigé avant tout développement	Précis	Coût de cadrage incompatible avec le budget ; obsolète dès les premières maquettes
c) Documentation courte et vivante + circuit de validation par composant	Chaque ambiguïté levée au bon moment, traçabilité, effort proportionné	Demande la discipline de passer par les fiches et le journal

Décision

Option c :

1. Site de documentation (ce site) comme référence commune — ce qui n'y est pas écrit n'est pas dans la V1.
2. Circuit de validation des composants : maquette Figma → fiche composant (avec sources des données et « ne fait pas ») → validation actée → développement. Le Storybook sert ensuite de preuve de conformité entre l'implémentation et la fiche validée.
3. Journal des décisions : toute décision structurante est actée et ne se rouvre pas sans nouvelle décision.
4. Registre des demandes + règle d'arbitrage : les idées nouvelles sont notées puis arbitrées ; si l'une entre en V1, une autre de taille équivalente en sort.

Impacts

• Toutes les validations cliente passent par ce site (fiches composants, questions ouvertes, décisions).
• Le périmètre V1 fait foi contractuellement pour le contenu des 4 sprints.