Accueil › Architecture & design patterns › Auditer une décision écrite
Auditer une décision écrite
Exercice de la série « Documenter les décisions »intermediaire
Le besoin. Avant d'accepter une décision en revue, l'équipe vérifie qu'elle est complète et qu'elle contient un arbitrage. Trois défauts reviennent : un contexte sans aucun fait mesurable, une seule option « comparée », et des conséquences qui ne listent que des bénéfices.
Ce qu'on vous demande. Écrivez auditerDecision(doc). Le document
porte les clés titre, statut, contexte, options (tableau),
decision et consequences (tableau). Renvoyez
{ manquantes, defauts, verdict } :
manquantes: les sections absentes ou vides, dans l'ordretitre, statut, contexte, options, decision, consequences. Une chaîne vide ou blanche et un tableau vide comptent comme manquants.defauts: dans cet ordre, et seulement pour les sections présentes —"contexte-sans-fait"si le contexte ne contient aucun chiffre,"options-non-comparees"si les options sont moins de deux,"consequences-sans-cout"si toutes les conséquences correspondent au motif/meilleur|amélior|plus simple|plus rapide|gain/i.verdict:"incomplete"s'il manque une section, sinon"a-revoir"s'il reste un défaut, sinon"recevable".
| Appel | Résultat attendu |
|---|---|
| document complet et chiffré | verdict: "recevable" |
contexte: "" et consequences: [] |
manquantes: ["contexte","consequences"] |
| une seule option | verdict: "a-revoir" |
Le piège. Deux, et ils tombent sur les mêmes cas. Une clé présente avec une valeur vide n'est pas une section renseignée : tester l'existence de la clé laisse passer un contexte vide. Et un document complet n'est pas recevable pour autant — un défaut suffit à le renvoyer en discussion.
Cas de test
[{"titre":"Publier les événements en JSON","statut":"acceptee","contexte":"La facturation est arrêtée 4 heures par mois.","options":["appel direct","file de messages"],"decision":"Publier un événement","consequences":["La facture peut arriver avec du retard","Les messages non consommés deviennent une métrique"]}][{"titre":"Chiffrer les identifiants","statut":"acceptee","options":["hacher","chiffrer"],"decision":"Chiffrer"}][{"titre":"Chiffrer les identifiants","statut":"acceptee","contexte":" ","options":["hacher","chiffrer"],"decision":"Chiffrer","consequences":[]}][{"titre":"Passer en base documentaire","statut":"acceptee","contexte":"Le schéma a changé 7 fois en 3 mois.","options":["base documentaire"],"decision":"Migrer","consequences":["Les jointures disparaissent du moteur"]}][{"titre":"Extraire le module de paiement","statut":"acceptee","contexte":"Le module a provoqué 3 incidents depuis janvier.","options":["garder","extraire"],"decision":"Extraire","consequences":["Meilleure séparation des responsabilités","Le code devient plus simple"]}][{"titre":"Imposer la validation en entrée","statut":"acceptee","contexte":"Le couplage entre les deux modules gêne les livraisons.","options":["valider partout","valider en entrée"],"decision":"Valider en entrée","consequences":["Chaque adaptateur porte sa validation"]}]
Votre code s'exécute réellement dans le navigateur, et la correction compare son résultat à celui d'une solution de référence.