Aller au contenu
English

Décisions d'architecture

  • Leçon 17
  • 50 min
  • Module 6 : Présenter la proposition

Où nous en sommes

Dans le module 5, nous avons planifié les défaillances et la croissance. La conception repose maintenant sur plusieurs grands choix : une seule application, le petit modèle, une base de données gérée, un plan de restauration. Mais un choix sans sa raison sera débattu de nouveau par la personne suivante. Dans cette leçon, nous consignons chaque décision dans une courte fiche, avec ses options, son coût et le moment de la réexaminer, comme la note d'une famille sur le réfrigérateur.

Ce que vous saurez faire

Consignez chaque grand choix de conception dans une courte fiche. Elle indique votre décision, les options comparées, les raisons, le coût et le moment de réexaminer le choix. La personne suivante peut alors vérifier les raisons au lieu de reprendre le débat.

Avant de commencerCe qu’il faut savoir et avoir sous la mainEnviron 50 minutes

Ce que vous devez savoir

Ce qu’il vous faut sur votre ordinateur

  • Votre dossier design-pack du dernier module, où python -m pytest -q affiche 46 passed (46 tests réussis).
  • Le dossier des laboratoires nextia-learning-labs à côté, comme dans chaque module.

Testé avec Python 3.12 sur macOS (Apple silicon). Les commandes Windows (PowerShell) et Linux sont fournies, mais n’ont pas été testées.

Une famille change de forfait téléphonique. Elle compare trois forfaits. Le moins cher offre 5 Go de données par mois. La famille utilise environ 2 Go, alors elle le choisit. La mère écrit une note et la colle sur le réfrigérateur : « Forfait économique, parce que nous utilisons 2 Go. À réexaminer si nous dépassons 4 Go. »

Un an plus tard, le fils dit : « Ce forfait est trop petit. Pourquoi l’avons-nous choisi? » Sans la note, la famille reprend le débat depuis le début. Personne ne se souvient des 2 Go ni des deux autres forfaits. Avec la note, la réponse prend une minute. La famille vérifie l’écran de consommation de données du téléphone. Il indique 2,3 Go, donc le forfait convient encore. S’il indiquait 4,5 Go, la note dirait qu’il est temps de changer, sans que personne se sente en faute.

La note est courte. Elle garde quatre choses : le choix, sa raison chiffrée, les options écartées et le signal de réexamen.

Six mois après le lancement, un client se plaint d’une réponse. Omar demande en réunion : « Pourquoi on n’utilise pas le modèle puissant? Il doit être meilleur. » Tomás est d’accord. Amira n’a pas participé au travail sur le routage, et Priya est en vacances. Personne ne peut montrer la mesure.

L’équipe passe donc à chat-strong pour toutes les réponses. Le tableau de sensibilité d’Économie unitaire montre le coût. À la fin du cours, il atteint 173,99 $ US par mois au lieu de 51,90 $ US : +235 %. Et la qualité ne change pas. Sur les 67 questions de Grace, chat-strong avait 85,8 % de réponses correctes et chat-small 86,6 %. Les erreurs viennent de la recherche. L’équipe paie plus de trois fois plus pour rien. La mesure avait été faite; seule la raison s’est perdue.

L’échec inverse est tout aussi fréquent. Tomás propose encore Kubernetes et quatre services. L’équipe passe une semaine à reprendre le débat de Simplicité et évolution. Une bonne décision que personne ne peut expliquer se prend deux fois, ou se fait annuler par accident.

Une décision d’architecture est un choix sur la structure d’un système qui coûtera cher à changer plus tard. Par exemple : une application ou plusieurs services, la base de données qui conserve les données, ou le modèle qui répond. Le choix d’un nom de variable n’en est pas une; le choix d’une base de données en est une.

Une fiche de décision d’architecture, ou ADR, est un court fichier qui conserve une telle décision. C’est la note sur le réfrigérateur d’un système. Chaque fiche comprend six sections :

  • Statut : proposée, acceptée ou remplacée par une fiche ultérieure, et les personnes qui ont décidé.
  • Contexte : le problème, l’exigence visée (Q1 à Q8) et les nombres importants, chacun marqué comme mesure, prix ou hypothèse.
  • Options : deux ou trois vrais choix, avec le coût, les points forts et les points faibles de chacun.
  • Décision : l’option choisie, en une phrase.
  • Conséquences : ce qui devient plus facile, ce qui devient plus difficile et ce que vous devez faire maintenant.
  • À réexaminer quand : le signal mesuré qui vous amène à réexaminer la décision.

Pourquoi un fichier, et pourquoi une décision par fichier? Un fichier reste à côté de la conception, dans le même dossier et le même historique. Une nouvelle personne le trouve là où se fait le travail. Une décision par fichier garde chaque fiche courte, ce qui encourage sa lecture. Et l’idée de « consigner » compte. Vous ne modifiez pas une fiche acceptée pour lui faire dire autre chose. Vous écrivez une nouvelle fiche qui la remplace, et l’ancienne reste dans l’historique.

Un petit exemple : la première fiche, section par section

Section intitulée « Un petit exemple : la première fiche, section par section »

Kwame écrit la première fiche sur le choix du module 2. Chaque valeur qu’elle contient vient du dossier. Voici le fichier decisions/adr-0001-one-modular-application.md au complet :

# ADR-0001: One modular application with a background worker
## Status
Accepted. Kwame, with Amira.
## Context
The assistant has an interactive part (answers, J1 and J2) and a slow part (ingestion, J3). Tomás proposed separate services (an answer service, an ingestion service, a search service) on Kubernetes. Demand is small and uncertain: 1,465 questions a day in the base scenario, 0.58 requests in flight at the busiest minute (cost model, from measured times). One developer (Amira) maintains it (Q6).
## Options
1. One application, two processes: the API and an ingestion worker from the same code, the queue in PostgreSQL. One deployment, one set of tests.
2. Three services with their own deployments and an HTTP or message link between them. Each can scale alone; three pipelines, three sets of logs, network calls that can fail between them.
3. Kubernetes with the three services. All of option 2, plus a cluster to run.
## Decision
Option 1: one modular application (modules `answers`, `ingestion`, `search`, `tenants`) that runs as an API process and a worker process.
## Consequences
- One deployment and one test suite; the modules call each other as functions, not over the network.
- The worker can still run on its own and scale to zero, because it reads jobs from the queue.
- A split later is cheaper because the modules already have clear boundaries.
## Revisit when
- Ingestion needs a different machine (for example a GPU) or a different release rhythm from the API, or
- the API needs more than 4 replicas at the busiest minute, or
- a second team owns part of the code.

Relisez-le, section par section :

  1. Statut nomme les personnes, pour savoir à qui poser une question.
  2. Contexte contient les deux nombres qui déterminent le choix : 0,58 requête en cours à la minute la plus chargée et un développeur. Il nomme aussi l’exigence Q6. Les 1 465 questions par jour sont une hypothèse du module 1. Le 0,58 vient de cette hypothèse et de durées mesurées.
  3. Options conserve les deux options écartées et leur coût en travail : trois pipelines, trois ensembles de journaux (logs), des appels réseau qui peuvent échouer. La fiche présente l’idée de Tomás de façon juste. C’est pourquoi il peut accepter la décision.
  4. Décision tient en une phrase.
  5. Conséquences présente honnêtement les deux côtés. Un seul déploiement est plus simple; respecter des limites strictes entre les modules devient une obligation.
  6. À réexaminer quand reprend mot pour mot les trois déclencheurs de séparation du module 2. Chacun est un signal observable : le choix du modèle, les journaux de requêtes, la liste de l’équipe.
Six cases dans l'ordre de lecture, les sections d'ADR-0001. Statut : acceptée, Kwame avec Amira. Contexte : 0,58 requête en cours à la minute la plus chargée; un développeur, Q6. Options : une application, trois services, Kubernetes. Décision, avec une bordure épaisse : option 1, une application modulaire, une API et un processus en arrière-plan. Conséquences : un déploiement; le processus peut passer à zéro instance; une séparation ultérieure coûte moins cher. À réexaminer quand, en orange : l'ingestion nécessite un GPU; plus de 4 répliques d'API; une deuxième équipe. Une flèche pointillée part de À réexaminer quand, avec l'étiquette « un signal se déclenche », vers une dernière case : une nouvelle fiche remplace celle-ci.
Les six sections d'une fiche de décision d'architecture, remplies avec la première fiche. Les déclencheurs de réexamen ferment la boucle : quand l'un se déclenche, une nouvelle fiche remplace celle-ci.
Description textuelle du diagramme

La première fiche en six sections. Le statut indique qu’elle est acceptée, par Kwame avec Amira. Le contexte donne les nombres : 0,58 requête en cours à la minute la plus chargée, et un développeur. Les options sont une application, trois services et Kubernetes. La décision est l’option 1, une application modulaire avec une API et un processus en arrière-plan. Les conséquences sont un déploiement, un processus qui peut passer à zéro instance et une séparation moins chère plus tard. À réexaminer quand présente trois déclencheurs : l’ingestion nécessite un GPU, l’API nécessite plus de 4 répliques ou une deuxième équipe arrive. Quand l’un se déclenche, l’équipe écrit une nouvelle fiche qui remplace celle-ci.

Une fiche change de statut, jamais d’histoire. Elle commence au statut proposée, pendant que les responsables la lisent. Elle devient acceptée quand ils sont d’accord. Si un signal de réexamen se déclenche et que l’équipe décide autrement, elle accepte une nouvelle fiche. Une seule ligne change dans l’ancienne : « Remplacée par ADR-0006 ». Rien d’autre ne change. Chacun peut donc encore lire pourquoi le premier choix avait du sens à ce moment-là.

Quatre états. Proposée, écrite mais sans accord. Une flèche étiquetée « les responsables sont d'accord » mène à Acceptée, l'équipe la met en œuvre, avec une bordure épaisse. Depuis Acceptée, une flèche étiquetée « un signal de réexamen se déclenche; une nouvelle fiche est acceptée » mène à Remplacée par ADR-NNNN, conservée, jamais supprimée. Depuis Proposée, une flèche étiquetée « les responsables disent non » mène à Rejetée, conservée avec la raison.
Les statuts d'une fiche. Une fiche n'est jamais supprimée : une fiche rejetée ou remplacée explique encore un choix que quelqu'un proposera de nouveau.
Description textuelle du diagramme

Une fiche commence au statut proposée. Si les responsables sont d’accord, elle est acceptée et l’équipe la met en œuvre. Plus tard, un signal de réexamen peut se déclencher et l’équipe peut décider autrement. L’équipe accepte alors une nouvelle fiche et marque l’ancienne comme « Remplacée par » la nouvelle. Si les responsables refusent une proposition, ils la marquent comme rejetée, avec la raison. Dans les deux cas, le fichier reste dans le dossier.

Beaucoup d’équipes écrivent aussi la date dans la ligne de statut. Le dossier conserve les fichiers dans git, donc chaque commit (enregistrement des modifications) conserve la date pour vous.

Un registre des décisions est l’ensemble des fiches, dans l’ordre. Le registre du dossier en contient cinq. Chacune vient d’un module de ce cours :

Fiche Décision Le nombre qui détermine le choix Type Responsable
ADR-0001 une application modulaire avec un processus en arrière-plan 0,58 requête en cours à la minute la plus chargée durées mesurées × demande supposée Kwame, Amira
ADR-0002 PostgreSQL pour les enregistrements, les vecteurs, la file d’attente et le cache de réponses environ 18 Mo stockés au mois 0; recherche vectorielle en 0,22 ms sur 10 000 vecteurs mesure Mei, Kwame
ADR-0003 chat-small pour chaque réponse, sans routage 86,6 % de réponses correctes contre 85,8 % pour chat-strong, à 1/19 du coût par question mesure Priya, Kwame
ADR-0004 PostgreSQL géré 77,55 $ US par mois contre 413,58 $ US, temps des personnes compris prix + hypothèse Mei
ADR-0005 restauration à un instant précis, testée chaque trimestre RPO de 5 minutes, RTO d’environ 70 minutes hypothèse, à tester Mei, Omar

L’illustration ci-dessous ajoute la colonne la plus utile : ce que chaque fiche attend. Chaque déclencheur de réexamen affiche la valeur actuelle à côté, pour voir à quelle distance il se trouve.

Cinq fiches à gauche, chacune avec une flèche vers son déclencheur de réexamen et la valeur actuelle. ADR-0001, une application modulaire : plus de 4 répliques d'API à la minute la plus chargée; aujourd'hui, 0,58 requête en cours, 1 réplique. ADR-0002, PostgreSQL pour tout : p95 de recherche supérieur à 100 ms ou 5 millions de segments; aujourd'hui, 0,22 ms sur 10 000 vecteurs, mesuré. ADR-0003, chat-small, sans routage : chat-strong meilleur de 5 points sur un nouveau jeu de questions; aujourd'hui, 85,8 % contre 86,6 %. ADR-0004, PostgreSQL géré : une extension manquante, ou plus de 4 vCores; aujourd'hui, 1 vCore, B1ms. ADR-0005, restauration à un instant précis : un test de restauration de plus de 2 h; aujourd'hui, environ 70 minutes, une estimation. Le dernier déclencheur est rouge, parce que sa valeur actuelle n'est pas encore mesurée.
Le registre des décisions de Larkfield : chaque fiche avec son déclencheur de réexamen et la valeur actuelle. Quatre sont loin de leur seuil. La cinquième, en rouge, n'a pas encore de valeur mesurée : le premier test de restauration doit en fournir une.
Description textuelle du diagramme

Les cinq fiches et ce que chacune attend. L’application modulaire attend plus de 4 répliques d’API; aujourd’hui, il y en a 1, avec 0,58 requête en cours. PostgreSQL pour tout attend un p95 de recherche supérieur à 100 ms; aujourd’hui, une recherche vectorielle prend 0,22 ms. Chat-small attend que chat-strong soit meilleur de 5 points sur un nouveau jeu de questions. Aujourd’hui, chat-strong est moins bon de 0,8 point. La base de données gérée attend un besoin dépassant 4 vCores; aujourd’hui, elle en a 1. Le plan de restauration attend un test de plus de 2 h. Aujourd’hui, les 70 minutes sont une estimation, donc ce déclencheur apparaît en rouge.

Regardez la case rouge. Quatre fiches reposent sur des mesures. La cinquième repose sur une estimation : la plupart des 70 minutes sont des durées supposées pour les personnes et le serveur. Le registre rend cette faiblesse visible. La feuille de route de la dernière leçon de ce module lui attribue une tâche.

Deux décisions du cours n’ont pas leur propre fiche. Le cache de réponses se trouve dans ADR-0002, et le traitement par lots des plongements (embeddings) ne change aucune structure. Une fiche sert à consigner un choix coûteux à annuler, pas chaque bonne idée.

Exercice guidé : les fiches de décision dans le dossier

Section intitulée « Exercice guidé : les fiches de décision dans le dossier »
  1. Dans votre dossier design-pack, avec l’environnement actif, essayez la nouvelle commande :

    Fenêtre de terminal
    python -m costmodel check
    This command arrives in Module 6. Download the end-of-module-6 snapshot or keep going.
  2. Copiez la vérification du dossier depuis l’instantané end-of-m06.

    Fenêtre de terminal
    S=../nextia-learning-labs/C26/snapshots/end-of-m06
    cp "$S/costmodel/packcheck.py" costmodel/
  3. Relancez la vérification. Elle pose les questions qu’un réviseur pose sur l’ensemble du dossier :

    Fenêtre de terminal
    python -m costmodel check
    PASS requirements: journeys, out of scope, measurable quality attributes
    PASS demand: every value has evidence (verified or assumed)
    PASS prices: every price has its source
    PASS measured: every value names its run
    PASS architecture: every component has a job, an owner and a place on the diagram
    FAIL decisions: every ADR has status, context, options, decision, consequences, revisit: decisions/ has no adr-*.md
    PASS failures: at least 5, each with owner, mitigation and signal
    FAIL roadmap: every ADR appears in the roadmap: decisions/roadmap.md does not exist yet
    FAIL presentation: assumptions, risks and an unresolved assumption: decisions/presentation-outline.md does not exist yet
    Design pack check: 6 of 9 passed

    Les cinq premiers modules réussissent la vérification. Les trois échecs correspondent au travail de ce module, un par leçon.

  4. Copiez le modèle de fiche dans le dossier decisions :

    Fenêtre de terminal
    cp "$S/decisions/template-adr.md" decisions/
  5. Faites une copie du modèle nommée decisions/adr-0001-one-modular-application.md. Ouvrez-la et remplissez les six sections à partir du petit exemple ci-dessus. Utilisez vos propres mots si vous voulez, mais gardez les six titres exactement.

  6. Copiez les quatre autres fiches et le tableau des défaillances. Le tableau des défaillances relie maintenant les lignes F2 et F6 à ADR-0004 et ADR-0005.

    Fenêtre de terminal
    cp "$S"/decisions/adr-000[2-5]*.md decisions/
    cp "$S/decisions/failure-modes.md" decisions/
  7. Lancez la vérification :

    Fenêtre de terminal
    python -m costmodel check
    PASS requirements: journeys, out of scope, measurable quality attributes
    PASS demand: every value has evidence (verified or assumed)
    PASS prices: every price has its source
    PASS measured: every value names its run
    PASS architecture: every component has a job, an owner and a place on the diagram
    PASS decisions: every ADR has status, context, options, decision, consequences, revisit
    PASS failures: at least 5, each with owner, mitigation and signal
    FAIL roadmap: every ADR appears in the roadmap: decisions/roadmap.md does not exist yet
    FAIL presentation: assumptions, risks and an unresolved assumption: decisions/presentation-outline.md does not exist yet
    Design pack check: 7 of 9 passed
  8. Lancez les tests. Ils affichent encore 46 passed : cette leçon a ajouté des documents et la vérification, mais aucun nouveau test.

    Fenêtre de terminal
    python -m pytest -q
    .............................................. [100%]
    46 passed in 0.08s

    Pour obtenir un dossier identique à l’instantané à la fin du module, remplacez maintenant votre ADR-0001 par celui de l’instantané. Gardez votre texte dans un autre dossier pour comparer.

La vérification des décisions a réussi. Mais essayez ceci : avant d’écrire ADR-0001, enregistrez une copie du modèle vide sous le nom adr-0001-one-modular-application.md. La vérification affiche encore PASS decisions (vérification des décisions réussie). Elle cherche les six titres, pas les raisons en dessous.

La vérification est donc le minimum, pas la révision. Une personne doit encore lire chaque fiche et poser cinq questions :

  1. Chaque nombre du contexte est-il marqué comme mesure, prix ou hypothèse?
  2. Les options sont-elles réelles, et l’option écartée est-elle présentée de façon juste?
  3. La décision tient-elle en une phrase?
  4. Les conséquences nomment-elles un coût, et pas seulement des avantages?
  5. Peut-on observer chaque déclencheur de réexamen dans un journal, un test ou une liste, aujourd’hui?

La cinquième question détecte le plus de problèmes. « À réexaminer quand nous grandirons » réussit la vérification, mais échoue à la révision.

Écrivez-en une quand un choix coûte cher à annuler, quand les personnes étaient en désaccord ou quand sa raison repose sur une mesure exigeante. Les cinq fiches de Larkfield répondent chacune à au moins deux de ces critères. Écrire une fiche prend environ une demi-heure et évite le prochain débat.

N’en écrivez pas pour les choix faciles à changer : une version de bibliothèque, un nom de variable, la couleur d’un bouton. Un registre de cinquante petites fiches cache les cinq qui comptent.

Le coût de maintien : quelqu’un doit surveiller les déclencheurs. Le plan de croissance de Larkfield, au module 5, examine déjà trois signaux chaque mois. Les autres se trouvent dans les journaux de requêtes, le jeu d’évaluation et la liste de l’équipe.

Erreur courante

Une fiche sans sa section de réexamen

Symptôme : la vérification échoue sur les décisions :

FAIL decisions: every ADR has status, context, options, decision, consequences, revisit: adr-0003-chat-small-without-routing.md has no ## Revisit when

Cause : quelqu’un a renommé ou supprimé le titre ## Revisit when (à réexaminer quand) dans ADR-0003. Sans lui, la fiche n’indique pas quelle mesure changerait la décision, donc personne ne la réexaminera.

Correction : remettez le titre avec un déclencheur mesuré. Pour ADR-0003 : « un nouveau jeu de questions montre que chat-strong dépasse chat-small d’au moins 5 points ».

Erreur courante

Une fiche acceptée, réécrite

Symptôme : ADR-0003 dit maintenant « chat-strong répond à chaque question ». Personne ne retrouve la mesure du routage, et le prochain réviseur demande pourquoi le coût a triplé.

Cause : quelqu’un a modifié l’ancienne fiche pour refléter une nouvelle décision. L’historique de la raison a disparu.

Correction : restaurez l’ancien texte depuis git. Écrivez une nouvelle fiche, ADR-0006, avec son propre contexte et ses propres options. Dans ADR-0003, changez seulement la ligne de statut pour « Remplacée par ADR-0006 ».

Changez une condition. Priya crée des données d’évaluation pour Bramble Books : 40 questions sur les conditions des fournisseurs, avec de longs tableaux. Sur ces données, chat-strong obtient 7 points de plus que chat-small. Ce cas est construit pour l’exercice; le cours ne l’a pas mesuré.

Le déclencheur d’ADR-0003 était « au moins 5 points de plus ». Rédigez la nouvelle fiche, ADR-0006, dans un fichier temporaire hors de votre dossier, pour qu’il reste identique à l’instantané. Donnez-lui les six sections. Utilisez les coûts mesurés par question du module 4. Chat-small coûte 0,000171 $ US, le routage coûte 0,000815 $ US et chat-strong coûte 0,003197 $ US. Dans le scénario de base, Bramble Books pose environ 65 questions par jour, soit environ 1 950 par mois. Ensuite, écrivez la seule ligne qui change dans ADR-0003.

Afficher une solution détaillée
# ADR-0006: Route Bramble Books' questions to chat-strong when chat-small declines
## Status
Proposed. Priya and Kwame. Replaces ADR-0003 for Bramble Books only.
## Context
Bramble Books' new evaluation set (40 questions on supplier terms) shows chat-strong 7 points
better than chat-small (constructed for this exercise; to measure on the real set). ADR-0003's
revisit trigger was 5 points. Bramble Books asks about 1,950 questions a month (assumption,
demand.toml base). Q4: at least 85% correct.
## Options
1. Keep chat-small for Bramble Books: US$0 more; 7 points below what chat-strong reaches.
2. Routed for Bramble Books (escalate when chat-small declines or a citation check fails):
(0.000815 - 0.000171) x 1,950 = about US$1.26 more a month (measured costs per question,
the routing measurement's escalation share; to check on the new set).
3. chat-strong for every Bramble Books question: (0.003197 - 0.000171) x 1,950 = about
US$5.90 more a month; p95 6.56 s against 3.79 s.
## Decision
Option 2 for Bramble Books; Larkfield stays on chat-small (ADR-0003).
## Consequences
- The model choice becomes a setting per tenant, so the tenants' table gets a column.
- Priya runs both evaluation sets before every model or prompt change.
## Revisit when
- Routed answers for Bramble Books are not at least 5 points better than chat-small on its set, or
- the escalation share passes 40%, where option 3 becomes simpler for about the same price.

La seule ligne qui change dans ADR-0003 est son statut : « Acceptée. Priya et Kwame. Remplacée par ADR-0006 pour Bramble Books. »

Vérifiez votre fiche à l’aide des cinq questions de révision. Chaque nombre est-il identifié? Les 7 points sont construits, les coûts par question sont mesurés et le volume est une hypothèse. Les options rejetées sont-elles présentées équitablement? L’option 3 offre la meilleure qualité, mais elle coûte plus cher et est plus lente. Chaque déclencheur est-il facile à comprendre? Les deux proviennent des données d’évaluation et du journal des requêtes.

Vérifiez votre compréhension

Pourquoi une fiche conserve-t-elle les options rejetées? Donnez une façon dont cela aide, avec un exemple de Larkfield.

Afficher la réponse

Les options rejetées montrent que l’équipe a comparé les choix, plutôt que de deviner. Elles conservent aussi équitablement les arguments de l’autre côté. Quand Tomás propose de nouveau Kubernetes, ADR-0001 le présente déjà comme l’option 3, avec ses coûts. Ce sont trois pipelines, un cluster à exploiter et des appels réseau qui peuvent échouer. L’équipe ne reprend pas le débat. Elle vérifie plutôt les déclencheurs de réexamen. Si aucun ne s’est activé, la réponse reste la même; sinon, l’équipe rédige une nouvelle fiche.

Vérifiez votre compréhension

Prédisez : à la fin de l'exercice guidé, vous supprimez le titre '## Options' d'ADR-0004 et lancez python -m costmodel check. Que dit la ligne decisions, et combien de vérifications réussissent?

Afficher la réponse

La ligne des décisions indique un échec : FAIL decisions: every ADR has status, context, options, decision, consequences, revisit: adr-0004-managed-postgresql.md has no ## Options (échec : chaque ADR doit contenir les six sections; ADR-0004 n’a pas de section Options). Seulement 6 vérifications sur 9 réussissent. La vérification des décisions échoue maintenant. La feuille de route et la présentation échouent encore, car leurs fichiers n’existent pas encore.

Vérifiez votre compréhension

Omar demande : « Peut-on supprimer le test de restauration? Il prend du temps aux gens chaque trimestre. » Quelle fiche lui répond, et que diriez-vous en trois ou quatre phrases?

Afficher la réponse

ADR-0005 lui répond. Sa décision prévoit une restauration à un instant précis, testée chaque trimestre. Le RTO d’environ 70 minutes repose surtout sur des hypothèses de temps humain et de temps serveur. Le test est la seule façon de le mesurer. Le journal des décisions indique que cette fiche est la seule sans valeur mesurée. Son déclencheur de réexamen est « un test de restauration prend plus de 2 h ». Sans test, ce déclencheur ne peut jamais s’activer. La fiche pourrait donc être erronée sans que personne le sache.

Récapitulatif

  • Une décision d’architecture est un choix de structure coûteux à modifier. Une ADR conserve cette décision dans un court fichier de six sections : statut, contexte, options, décision, conséquences et conditions de réexamen.
  • Identifiez chaque nombre du contexte : mesure, prix ou hypothèse. Conservez les options rejetées et présentez-les équitablement.
  • Ne réécrivez jamais une fiche acceptée. Une nouvelle fiche la remplace, et seule la ligne de statut de l’ancienne change.
  • Le journal des décisions de Larkfield compte cinq fiches. Quatre reposent sur des mesures; les 70 minutes d’ADR-0005 restent une estimation jusqu’au premier test de restauration.
  • python -m costmodel check affiche maintenant 7 of 9 passed (7 vérifications sur 9 réussies). Il vérifie la structure de chaque fiche; une personne révise le contenu.

Ensuite, vous expliquez la proposition en dix minutes aux personnes qui décident et à celles qui l’utilisent.

Leçon suivante : Présentation aux parties prenantes