Fiche de décision d'architecture (ADR)
Une ADR existe pour que dans dix-huit mois, personne ne rouvre une question réglée sans savoir pourquoi elle a été réglée, et pour que lorsque le contexte change, la décision puisse être réexaminée délibérément.
Où
docs/adr/NNNN-titre-court.md, numérotée séquentiellement. Vérifiez le répertoire pour le numéro suivant et le modèle de base ; suivez-le s'il existe.
Modèle
# NNNN. <Titre sous la forme de la décision : "Utiliser Aurora PostgreSQL pour le service de commandes">
Date : AAAA-MM-JJ
Statut : Proposée | Acceptée | Remplacée par NNNN | Dépréciée
Décideurs : <noms ou équipe>
## Contexte
<Quelles forces sont en jeu : exigences, contraintes, douleur actuelle, échéances, conformité,
compétences de l'équipe, enveloppe budgétaire. Deux à quatre paragraphes. Faits, pas d'opinions.>
## Décision
<Une ou deux phrases, au présent : "Nous allons …">
## Options envisagées
### Option A : <nom>
Avantages / Inconvénients / Coût approximatif / Charge opérationnelle
### Option B : <nom>
…
## Conséquences
<Ce qui devient plus facile, ce qui devient plus difficile, ce que nous devons maintenant faire (migrations, formations, nouveaux runbooks), ce que nous acceptons explicitement comme risque.>
## Suivi
- [ ] <tâches concrètes avec responsables si connus>
Conseils de rédaction
- Rédigez le contexte de sorte qu'un nouveau venu convienne que le problème est réel avant de lire la décision.
- Comparez les options sur les mêmes axes : coût, charge opérationnelle, verrouillage, familiarité de l'équipe, délai de livraison, sécurité/conformité. Mettez des chiffres lorsque vous en avez (estimation de coût mensuel, RTO/RPO, débit).
- Soyez honnête quant aux points forts des options perdantes. Une ADR qui caricature les alternatives sera méfiée.
- Les conséquences incluent les aspects négatifs. « Nous devons maintenant sauvegarder deux bases de données » y a sa place.
- Gardez-la sous deux pages. Liez aux études techniques (spikes), benchmarks et tickets plutôt que de les intégrer.
- Lors du remplacement, mettez à jour le statut de l'ancienne ADR et liez dans les deux sens.
Lorsque $ARGUMENTS est fourni
Utilisez-le comme titre ; dérivez le nom du fichier à partir de celui-ci.