Architecture Decision Records (ADR)¶
Documentation des décisions architecturales importantes du projet ProbatioVault Backend
Qu'est-ce qu'un ADR ?¶
Un Architecture Decision Record (ADR) est un document qui capture une décision architecturale importante, son contexte, les alternatives considérées, et les conséquences.
Format¶
Chaque ADR suit ce format :
# ADR XXX : Titre de la décision
**Date** : YYYY-MM-DD
**Status** : ✅ Accepté / 📋 Proposé / ❌ Rejeté / ⚠️ Déprécié
**Décideurs** : Qui a pris la décision
**Tags** : `tag1`, `tag2`
## Contexte
Pourquoi cette décision ?
## Décision
Qu'avons-nous décidé ?
## Options considérées
Alternatives explorées
## Justification
Pourquoi ce choix ?
## Conséquences
Impact de cette décision
## Références
Liens et ressources
ADRs disponibles¶
| # | Titre | Date | Statut | Tags |
|---|---|---|---|---|
| 001 | Choix de NestJS comme framework backend | 2025-01-13 | ✅ Accepté | architecture, framework |
Principes¶
Quand créer un ADR ?¶
Créez un ADR pour : - ✅ Choix de technologies majeures (framework, ORM, base de données) - ✅ Décisions architecturales importantes (microservices, monolithe) - ✅ Choix de patterns (CQRS, Event Sourcing, etc.) - ✅ Décisions de sécurité critiques - ✅ Changements de direction technique
Ne créez pas d'ADR pour : - ❌ Décisions mineures ou réversibles facilement - ❌ Choix de libraries utilitaires - ❌ Conventions de code (utilisez le style guide)
Statuts¶
- 📋 Proposé : En discussion
- ✅ Accepté : Décision validée et appliquée
- ⚠️ Déprécié : Remplacé par un nouvel ADR
- ❌ Rejeté : Proposition refusée
Numérotation¶
Les ADRs sont numérotés séquentiellement : 001, 002, 003, etc.