JOURNAL DES DÉCISIONS DEC-005
Aucune métrique sans source, plutôt qu’un repli chiffré
Cette décision en remplace une autre. Lire DEC-102, Un repli chiffré plutôt qu’une case vide
Contexte
La Couche D et la page des métriques affichaient des valeurs de repli quand la source ne répondait pas, pour éviter des cases vides.
Ces valeurs étaient plausibles, et rien à l’écran ne les distinguait des valeurs relevées.
Un chiffre inventé qui ne se signale pas devient vrai au bout de quelques semaines, y compris pour celui qui l’a écrit.
Options envisagées
Décision
Aucune valeur chiffrée n’est affichée sans sa source, sa méthode et sa date de relevé. Quand la source ne répond pas, l’absence est affichée telle quelle.
Raisonnement
- Technique
- La règle est portée par le type et non par la discipline : un composant d’affichage n’accepte pas un nombre, il accepte une affirmation qui porte sa provenance.
- Réglementaire
- C’est la discipline que les produits du groupe appliquent à la donnée de durabilité. Ne pas se l’appliquer à soi-même aurait été un argument contre le groupe.
- Économique
- Aucun coût direct, un coût commercial réel : un tableau de bord troué se montre moins bien qu’un tableau plein.
Compromis accepté
Le tableau de bord est incomplet les jours où une source est indisponible, y compris quand un recruteur le regarde. Personne ne peut le rendre présentable en écrivant un chiffre.
DÉCISION · CODE · RÉSULTAT
- LA DÉCISION
Aucune valeur chiffrée n’est affichée sans sa source, sa méthode et sa date de relevé. Quand la source ne répond pas, l’absence est affichée telle quelle.
- LE CODE QU’ELLE A PRODUIT
- CommitRetrait des métriques de repli
21e483b - TestVerrou sur l’absence de repli
apps/web/tests/layer-d.test.tsx - TestVerrou anti fabrication
apps/web/tests/no-fabrication.test.ts - FichierLe type qui porte la règle
apps/web/lib/proof/types.ts
- CommitRetrait des métriques de repli
- LE RÉSULTAT OBSERVÉ
Cent lignes ajoutées et soixante-treize retirées au commit 21e483b, sur la Couche D et la page des métriques. L’absence du repli est verrouillée par apps/web/tests/layer-d.test.tsx, et la règle générale par apps/web/tests/no-fabrication.test.ts, qui refuse tout littéral numérique de plus de deux chiffres dans un composant d’affichage de métrique.
Le principe que cette décision gouverne
La source précède l’affirmation.
Voir d’où viennent les six principesLE JOURNAL COMPLET
Toutes les décisions, au même format.
Elles se comparent : même gabarit, même vocabulaire, même exigence de trace.