DÉCISIONS / JOURNAL D’ARCHITECTURE
Ce que j’ai tranché,
et ce que ça coûte.
Une décision d’architecture ne se juge pas sur son résultat mais sur ce qu’elle a pesé. Chaque entrée porte donc le problème réel, les options sérieusement envisagées, ce qui les a disqualifiées, le compromis accepté, et ce que la décision a changé dans le code. Une décision revenue reste en ligne, datée, et pointe vers celle qui la remplace.
ÉTAT DU JOURNAL15
décisions publiées, dont 10 en vigueur et 5 sur lesquelles je suis revenu.
Voir les revirements ↗PORTÉE
IMPACT
STATUT
TRI15 décisions
- DEC-007Échouer explicitement plutôt que répondre sans sourceAcceptéeConformitéréversible
- DEC-008Vérification locale assumée plutôt qu’intégration continue décorativeAcceptéeCoûtréversible
- DEC-010Nommer la nature d’une panne plutôt que l’afficher comme une absenceAcceptéeArchitectureréversible
- DEC-005Aucune métrique sans source, plutôt qu’un repli chiffréAcceptéeProduitréversible
- DEC-006Registre de produits en base plutôt qu’un tableau écrit dans la pageAcceptéeArchitectureréversible à un coût
- DEC-009Cockpit d’un ensemble logiciel plutôt que vitrine d’un produitAcceptéeProduitréversible à un coût
- DEC-004Consommer ce que les produits exposent plutôt que recalculer dans le cockpitAcceptéeArchitectureréversible à un coût
- DEC-103Un tableau de produits écrit dans la page plutôt qu’un registre en baseRemplacéeArchitectureréversible à un coût
- DEC-105La vitrine d’un produit plutôt que le cockpit d’un ensembleRemplacéeProduitréversible à un coût
- DEC-102Un repli chiffré plutôt qu’une case videRemplacéeProduitréversible
- DEC-104Générer une réponse sans contexte plutôt qu’échouerRemplacéeConformitéréversible
- DEC-002Python plutôt que Node.js pour les moteurs de calculAcceptéeArchitectureréversible à un coût
- DEC-003Fournisseur de modèle établi dans l’Union européenne plutôt que hors UnionAcceptéeConformitéréversible
- DEC-101Un moteur de calcul dans le cockpit plutôt que dans le produitRemplacéeArchitectureréversible à un coût
- DEC-001Récupération documentaire plutôt que réentraînement de modèleAcceptéeArchitecturedifficilement réversible
COMMENT LIRE UNE LIGNE
AcceptéeEn vigueur aujourd’hui.
RemplacéeUne décision ultérieure l’a remplacée. Elle reste en ligne et pointe vers celle qui la remplace. Revenir sur une décision est ici une qualité, pas un aveu.
RéversibilitéLe coût du retour en arrière, du plus simple au plus lourd. Une décision difficilement réversible se prend plus lentement.
ReconstruiteL’entrée a été rédigée après coup, à partir du dépôt. Les options listées sont celles que le code démontre, elles ne prétendent pas décrire ce qui a été envisagé à l’époque.
CE QUI EN DÉCOULE
Des principes, pas un manifeste.
Cinq règles, chacune dérivée d’une décision ou d’une erreur réelle, et chacune avec le prix qu’elle fait payer.