Accueil › Architecture & design patterns › Le contexte et les conséquences
Le contexte et les conséquences
Documenter les décisionsavance
Le contexte et les conséquences sont les deux sections qu'on bâcle, et les deux seules qui servent encore dans deux ans.
La décision elle-même, on peut la déduire du code. La raison, non.
## Contexte
Mauvais : « Nous avons trois services et une base PostgreSQL. »
Bon : « La facturation est arrêtée pour maintenance quatre heures par mois.
Pendant ces fenêtres, la prise de commande échoue. »
La première phrase décrit l'état du système : elle sera fausse bientôt, et elle n'explique rien. La seconde nomme une pression : on comprend immédiatement pourquoi un appel direct a été écarté.
Les conséquences obéissent à la règle symétrique. Elles nomment ce que la décision rend plus difficile.
## Conséquences
La facture peut arriver plusieurs heures après la commande ; le support
doit le savoir. Les messages non consommés deviennent une métrique à
surveiller. Le traitement côté facturation doit être idempotent.
Trois phrases, trois coûts. Un lecteur futur sait alors que la latence de facturation n'est pas un bogue, mais un prix accepté. Sans cette section, il ouvrira un ticket, et quelqu'un passera une semaine à « corriger » un comportement voulu.
La contrainte peut disparaître. C'est normal, et c'est précisément pour cela qu'il faut l'écrire : le jour où la facturation cesse d'être indisponible, la décision redevient discutable — et on sait pourquoi.
Les termes à connaître
- Contexte
La force qui rendait le statu quo intenable au moment du choix : une panne, une mesure, un audit, une contrainte d'équipe ou de calendrier.
- Conséquence
Ce que la décision rend plus difficile. Une conséquence qui n'est qu'un bénéfice n'est pas une conséquence, c'est un argument.
- Contrainte périmée
Une contrainte qui a justifié un choix et qui a disparu depuis. Sans trace écrite, personne ne sait que la décision peut être rouverte.
- Culte du cargo
Reproduire une pratique sans sa raison. Il naît directement de l'absence de contexte écrit.
- Déclencheur de réexamen
Une condition écrite à l'avance qui rendra la décision discutable : un seuil de charge, la fin d'un contrat, le départ d'une contrainte.
- Prix accepté
Un inconvénient connu et assumé lors du choix. Non écrit, il est redécouvert plus tard comme un défaut.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.