ADR — Architecture Decision Records¶
Les ADR (Architecture Decision Records) documentent les décisions architecturales importantes prises lors du développement de Primatch.
Format d'un ADR
Chaque ADR documente : le contexte (quel problème ?), la décision (que choisit-on ?), et les conséquences (avantages, inconvénients, impacts).
Index des décisions¶
| # | Titre | Statut | Date |
|---|---|---|---|
| ADR-001 | Domain-Driven Design pour le backend | ✅ Accepté | Jan 2024 |
| ADR-002 | JWT pour l'authentification API | ✅ Accepté | Jan 2024 |
| ADR-003 | TanStack React Query pour le state serveur | ✅ Accepté | Jan 2024 |
Statuts possibles¶
| Statut | Signification |
|---|---|
| 🟡 Proposé | En discussion, pas encore décidé |
| ✅ Accepté | Décision prise et implémentée |
| ❌ Rejeté | Évalué mais non retenu (avec justification) |
| 🔄 Supersédé | Remplacé par une décision plus récente |
| 🗃️ Obsolète | Plus pertinent, mais conservé pour historique |
Ajouter un nouvel ADR¶
# Copier le template et le numéroter séquentiellement
cp docs/content/3-architecture/decisions/_template.md \
docs/content/3-architecture/decisions/adr-00X-titre.md
Puis ajouter la référence dans ce fichier index et dans le mkdocs.yml.