Aller au contenu
ADAMA OSESG · DATA · SYSTEMS

JOURNAL DES DÉCISIONS DEC-005

Aucune métrique sans source, plutôt qu’un repli chiffré

Statut
AcceptéeEn vigueur aujourd’hui.
Date
Portée
Ce cockpit
Impact
Produit
Réversibilité
Revenir en arrière est simple

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

  • Retenue

    Retirer le repli et afficher l’absence

    Une case vide dit quelque chose de vrai. Elle est désagréable, et c’est le prix.

  • Écartée

    Garder le repli en le signalant visuellement

    Une mention discrète disparaît à la première capture d’écran, au premier partage et au premier export imprimé.

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

  1. 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.

  2. LE CODE QU’ELLE A PRODUIT
  3. 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 principes

LE JOURNAL COMPLET

Toutes les décisions, au même format.

Elles se comparent : même gabarit, même vocabulaire, même exigence de trace.

Revenir au journal