Développement
Modèle de décision d’architecture (ADR)
Dans six mois, quelqu’un demandera pourquoi le système fonctionne ainsi. Une décision d’architecture répond à cette question en une ou deux pages. Ce modèle couvre le contexte, les options envisagées, la décision, ses conséquences, le travail de suivi et les conditions d’une révision.
Ouvrir ce modèle dans l’éditeur- Catégorie
- Développement
- Style par défaut
- Technique
Quand l’utiliser
Rédigez une décision d’architecture quand un choix technique coûte cher à revenir en arrière : une base de données, un framework, un mode d’hébergement, un style d’API. Les futurs responsables, les nouveaux membres de l’équipe et les relecteurs le lisent pour comprendre les contraintes du moment. Rédigez-le à chaud et gardez la ligne de statut à jour au fil de la proposition.
Ce qu’il contient
- Un titre numéroté avec des champs à remplir pour le projet, l’auteur et la date, et une ligne de statut.
- Un tableau d’options comparant avantages et coûts, avec une ligne pour garder l’approche actuelle.
- La décision, les conséquences positives et négatives, une liste de contrôle de mise en œuvre et un déclencheur de révision.
Conseils pour un meilleur document
- Énoncez la décision en une phrase et donnez la raison la plus forte, une seule. S’il vous en faut cinq, le contexte a probablement besoin de plus de travail.
- Soyez honnête sur les conséquences négatives. Si un diagramme explique mieux le changement qu’un texte, ajoutez un bloc Mermaid : il s’affichera dans le PDF.
Aperçu du modèle
ADR-001 : Projet ou sujet
Auteur : Votre nom · Date : Date
État : Proposition
Contexte
Décrivez le problème et les contraintes qui orientent la décision.
Options étudiées
| Option | Avantages | Coûts |
|---|---|---|
| Option A | Avantage principal | Compromis principal |
| Option B | Avantage principal | Compromis principal |
| Approche actuelle | Pas de migration | Limite existante |
Décision
Indiquez l’approche retenue et sa raison principale.
Conséquences
Positives : Ce qui devient plus simple.
Négatives : Ce qui devient plus difficile ou coûteux.
Mise en œuvre
- Attribuer un responsable
- Prévoir migration et retour arrière
- Actualiser la documentation
Réexamen
Précisez les éléments qui justifieraient une nouvelle décision.
Les champs à remplir, comme votre nom et la date, sont remplacés quand vous ouvrez le modèle dans l’éditeur.