JOURNAL DES DÉCISIONS DEC-010
Nommer la nature d’une panne plutôt que l’afficher comme une absence
Contexte
Le cockpit interroge les produits du groupe par une route de santé. Quand l’appel échouait, la case restait vide.
Trois situations très différentes donnaient exactement le même écran : le produit répond qu’il ne va pas bien, le délai d’attente est dépassé, ou la sortie réseau du cockpit elle-même a échoué.
Tant que ces trois cas se ressemblent, le cockpit ne peut pas dire s’il diagnostique un produit ou sa propre panne.
Options envisagées
Décision
Chaque tentative de sonde est enregistrée avec la nature de son échec, et l’interface distingue une panne du produit d’une panne de la sortie réseau du cockpit.
Raisonnement
- Technique
- Un type énuméré en base porte les quatre natures d’échec. L’interface les traduit en une phrase lisible, sans jargon.
- Réglementaire
- Une absence non expliquée se lit comme une omission. Nommer la cause est la même discipline que nommer la source d’une valeur.
- Économique
- Une table de plus et une écriture par tentative, contre un diagnostic qui ne demande plus d’ouvrir un journal serveur.
Compromis accepté
Le cockpit écrit à chaque passage de sonde, y compris quand tout va bien. Cette table grossit, et personne ne la purge aujourd’hui.
DÉCISION · CODE · RÉSULTAT
- LA DÉCISION
Chaque tentative de sonde est enregistrée avec la nature de son échec, et l’interface distingue une panne du produit d’une panne de la sortie réseau du cockpit.
- LE CODE QU’ELLE A PRODUIT
- MigrationTable des sondes et natures d’échec
packages/db/migrations/0003_data_class.sql - FichierQualification de l’échec côté client
apps/web/lib/ecosystem/client.ts - TestComportement des passerelles vérifié
apps/web/tests/ecosystem-gateway.test.ts
- MigrationTable des sondes et natures d’échec
- LE RÉSULTAT OBSERVÉ
La table ecosystem_probes et le type énuméré des natures d’échec sont créés par la migration 0003. La nature de l’échec traverse jusqu’au client, elle est portée par le type des états de passerelle et affichée dans la Couche D. L’extrait technique d’erreur est révoqué pour la clé anonyme : une sonde ne doit pas devenir un journal de fuite.
Le principe que cette décision gouverne
Une panne doit se voir, et se nommer.
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.