Labels and journal: "Faulty target" renamed "Target issue" everywhere (user: the name was not clear), key cible_degradee -> cible_a_probleme; labels, events, detectors, Status page, labeling tool, documentation and history (D-109)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-03 09:31:18 +01:00
1 parent 6955adf6f5
commit f0ba5b9fcf
38 files changed
+167 -167

No files matched your search

+9 -9
View File
@@ -786,8 +786,8 @@ Règles du journal :
## D-074 — 2026-10-27 — Journal : les catégories du terrain, « À vérifier » pour tout ce qui reste inexpliqué
- **Statut** : active ; précise D-056 (catégories du journal) ; pas encore reportée dans la carte (section 4), `categories.py` ni les détecteurs.
- **Décision** : les catégories du journal se définissent par ce qui arrive sur le terrain, reliées dans `docs/displacement/eventualites-et-categories.drawio` (une éventualité peut donner plusieurs catégories). Définitions de l'utilisateur : **À vérifier** reçoit tout ce qui n'a pas d'explication, avec deux sous-groupes possibles, la dérive lente et le gros saut (mouvement soudain de l'ouvrage, tout a bougé) ; **Cible défaillante** (nouvelle) : une cible constamment problématique, mal orientée, mal installée ou dégradée avec le temps ; **Effet thermique** : le cycle jour / nuit, l'ouvrage qui bouge au soleil ou la caméra qui bouge par dilatation de son support ; **Passage** : un train, un engin de chantier, un véhicule ou tout autre objet qui passe devant les cibles ; **Pas de données** : aucune donnée reçue pour la plage ; **Saut bref** : saut soudain puis retour, explicable par une condition externe, vérifiable sans ambiguïté sur les images ; **Turbulences atmosphériques** : image brouillée par la chaleur (mirage). Visibilité réduite, Visibilité nulle et Cible masquée restent comme dans la carte. Après vérification, un `À vérifier` peut devenir **Cible déplacée** (cible endommagée ou bougée, ou altération de l'ouvrage).
- **Pourquoi** : ne pas alarmer le client : ce qui n'est pas expliqué n'est pas un mouvement annoncé, seulement à vérifier ; et la cible défaillante, présente dans les cas C-008 à C-011 et les étiquettes de l'analyste (cibles toujours rejetées, suivi qui hésite ou glisse), n'avait pas de catégorie.
- **Décision** : les catégories du journal se définissent par ce qui arrive sur le terrain, reliées dans `docs/displacement/eventualites-et-categories.drawio` (une éventualité peut donner plusieurs catégories). Définitions de l'utilisateur : **À vérifier** reçoit tout ce qui n'a pas d'explication, avec deux sous-groupes possibles, la dérive lente et le gros saut (mouvement soudain de l'ouvrage, tout a bougé) ; **Target issue** (nouvelle) : une cible constamment problématique, mal orientée, mal installée ou dégradée avec le temps ; **Effet thermique** : le cycle jour / nuit, l'ouvrage qui bouge au soleil ou la caméra qui bouge par dilatation de son support ; **Passage** : un train, un engin de chantier, un véhicule ou tout autre objet qui passe devant les cibles ; **Pas de données** : aucune donnée reçue pour la plage ; **Saut bref** : saut soudain puis retour, explicable par une condition externe, vérifiable sans ambiguïté sur les images ; **Turbulences atmosphériques** : image brouillée par la chaleur (mirage). Visibilité réduite, Visibilité nulle et Cible masquée restent comme dans la carte. Après vérification, un `À vérifier` peut devenir **Cible déplacée** (cible endommagée ou bougée, ou altération de l'ouvrage).
- **Pourquoi** : ne pas alarmer le client : ce qui n'est pas expliqué n'est pas un mouvement annoncé, seulement à vérifier ; et la cible à problème, présente dans les cas C-008 à C-011 et les étiquettes de l'analyste (cibles toujours rejetées, suivi qui hésite ou glisse), n'avait pas de catégorie.
- **Options écartées** : l'arbre de décision sur les données (Mermaid, puis draw.io) : trop gros, l'utilisateur veut les éventualités du terrain sans le détail des données ; une catégorie « Dérive lente » à part, alarmante.
- **Conséquence** : un véhicule qui fait vibrer l'ouvrage ou la caméra (caméra sur un pont) va en **Saut bref** (l'utilisateur, 2026-10-27, plutôt que Passage : il ne passe pas devant les cibles, il fait bouger l'ouvrage ou la caméra un instant) ; le vent et les à-coups de la caméra ne sont plus des turbulences mais des sauts brefs. Reste à reporter les définitions dans la carte (section 4), `categories.py`, le vocabulaire des étiquettes et les détecteurs (point 49 du plan).
@@ -947,9 +947,9 @@ Règles du journal :
## D-095 — 2026-10-29 — La hiérarchie des status de la page Status
- **Statut** : active. Complète D-094. Le regroupement thermique (Thermal movements) est suspendu dans `status.py` le 2026-10-29 : il ne vaut que pour deux phases aux mêmes cibles ; le document le garde, en attendant l'utilisateur.
- **Décision** : la page Status (`detectors-view/status.py`) n'affiche pas tous les événements des détecteurs tels quels : `detectors-view/hierarchie-des-status.md`, validé par l'utilisateur, dit lesquels se superposent et lesquels s'occultent. Familles : No visibility occulte Reduced visibility, Faulty target occulte Target hidden ; Thermal expansion et Thermal contraction forment un seul status, Thermal movements. Entre familles : No data occulte tout, No visibility occulte Target hidden ; le reste se superpose. Un status occulté est coupé, pas supprimé, et seulement si le plus fort concerne tous ses capteurs (règle 4).
- **Décision** : la page Status (`detectors-view/status.py`) n'affiche pas tous les événements des détecteurs tels quels : `detectors-view/hierarchie-des-status.md`, validé par l'utilisateur, dit lesquels se superposent et lesquels s'occultent. Familles : No visibility occulte Reduced visibility, Target issue occulte Target hidden ; Thermal expansion et Thermal contraction forment un seul status, Thermal movements. Entre familles : No data occulte tout, No visibility occulte Target hidden ; le reste se superpose. Un status occulté est coupé, pas supprimé, et seulement si le plus fort concerne tous ses capteurs (règle 4).
- **Pourquoi** : des status qui se chevauchent disent souvent la même chose ; le plus fort suffit, et la rangée des étiquettes reste lisible.
- **Options écartées** : choisir le gagnant entre les deux phases thermiques (l'utilisateur les regroupe) ; occulter sans regarder les capteurs (sur NIEDERHORN, une Faulty target de toute la plage aurait caché 7 Target hidden sur d'autres capteurs).
- **Options écartées** : choisir le gagnant entre les deux phases thermiques (l'utilisateur les regroupe) ; occulter sans regarder les capteurs (sur NIEDERHORN, une Target issue de toute la plage aurait caché 7 Target hidden sur d'autres capteurs).
- **Conséquence** : `status.py` transcrit le document (`FUSION`, `OCCULTE`) ; il ne change que l'affichage, pas les détecteurs ni `detecteurs.py`.
## D-096 — 2026-10-29 — Pompage des stations suivies, jusqu'à maintenant
@@ -1053,15 +1053,15 @@ Règles du journal :
- **Conséquence** : les étiquettes ne prennent plus toutes leurs clés dans le journal ; un script qui les compare aux détecteurs lit `deplacement_thermique` comme l'une ou l'autre.
## D-109 — 2026-11-02 — Les familles des étiquettes
- **Statut** : active, à l'essai ; point 71 du plan du journal du matin ; remplace les valeurs de `categorie` de D-107 et D-108 ; `turbulence` réunie à `visibilite` par D-110.
- **Décision** : le champ `categorie` d'une étiquette prend la clé d'une famille, décrite dans `labeling/familles.md` (ce qui arrive, la conclusion pour le client, les phénomènes de la carte des étiquettes, les frontières, ce qui ne s'étiquette pas, la correspondance avec le journal) : `visibilite` (Visibility), `obstruction` (Obstruction), `turbulence` (Atmospheric turbulence), `deplacement_thermique` (Thermal displacement), `deplacement` (Displacement), `cible_degradee` (Faulty target) ; l'outil garde `aucune` pour l'expert. L'`etiqueteur` lit ce fichier en entier, n'utilise que ces six clés ; un trou de mesures ne s'étiquette pas. Les 3 étiquettes automatiques de JUNGFRAU qui n'avaient pas déjà une clé de famille passées à la leur ; le journal et ses détecteurs gardent leurs douze catégories.
- **Pourquoi** : l'utilisateur, 2026-11-02 : cinq familles (Visibility, Obstruction, turbulences atmosphériques, Thermal displacements, Displacements), documentées dans ce que lit l'étiqueteur. Ajustements de Claude, acceptés : une sixième, Faulty target (une cible constamment problématique, dont la conclusion est d'intervenir sur elle) ; le saut puis retour dans la famille de sa cause ; pas d'étiquette pour un trou (un script le trouve) ; les frontières Visibility / Obstruction, Thermal / Displacement ; les familles pour les étiquettes seules. Une famille par cause et par conclusion pour le client ; moins de classes, plus d'accord entre l'étiqueteur et l'expert.
- **Statut** : active, à l'essai ; point 71 du plan du journal du matin ; remplace les valeurs de `categorie` de D-107 et D-108 ; `turbulence` réunie à `visibilite` par D-110 ; Faulty target (Cible défaillante, clé `cible_degradee`) renommée Target issue, clé `cible_a_probleme` (l'utilisateur, 2026-11-03 : nom pas clair), partout : familles, catégorie du journal, étiquettes, events, documentation et historique.
- **Décision** : le champ `categorie` d'une étiquette prend la clé d'une famille, décrite dans `labeling/familles.md` (ce qui arrive, la conclusion pour le client, les phénomènes de la carte des étiquettes, les frontières, ce qui ne s'étiquette pas, la correspondance avec le journal) : `visibilite` (Visibility), `obstruction` (Obstruction), `turbulence` (Atmospheric turbulence), `deplacement_thermique` (Thermal displacement), `deplacement` (Displacement), `cible_a_probleme` (Target issue) ; l'outil garde `aucune` pour l'expert. L'`etiqueteur` lit ce fichier en entier, n'utilise que ces six clés ; un trou de mesures ne s'étiquette pas. Les 3 étiquettes automatiques de JUNGFRAU qui n'avaient pas déjà une clé de famille passées à la leur ; le journal et ses détecteurs gardent leurs douze catégories.
- **Pourquoi** : l'utilisateur, 2026-11-02 : cinq familles (Visibility, Obstruction, turbulences atmosphériques, Thermal displacements, Displacements), documentées dans ce que lit l'étiqueteur. Ajustements de Claude, acceptés : une sixième, Target issue (une cible constamment problématique, dont la conclusion est d'intervenir sur elle) ; le saut puis retour dans la famille de sa cause ; pas d'étiquette pour un trou (un script le trouve) ; les frontières Visibility / Obstruction, Thermal / Displacement ; les familles pour les étiquettes seules. Une famille par cause et par conclusion pour le client ; moins de classes, plus d'accord entre l'étiqueteur et l'expert.
- **Options écartées** : les familles dans la carte des étiquettes (refaite par `/labels-map`, un ajout à la main s'y perdrait) ; les familles aussi dans le journal (pas demandé) ; un saut bref comme famille à part.
- **Conséquence** : la carte des étiquettes reste rangée par les familles de la carte des événements ; `familles.md` relie ses phénomènes aux familles des étiquettes. Comparer aux détecteurs passe par la correspondance de `familles.md`.
## D-110 — 2026-11-02 — Étiquettes : la turbulence dans Visibility
- **Statut** : active, à l'essai ; point 71 du plan du journal du matin ; précise D-109.
- **Décision** : la famille `turbulence` (Atmospheric turbulence) est réunie à `visibilite` (Visibility) : une gêne diffuse entre la caméra et la scène, l'image faible ou floue, ou qui tremble ; la description dit laquelle est vue. Cinq familles : `visibilite`, `obstruction`, `deplacement_thermique`, `deplacement`, `cible_degradee`. `labeling/familles.md`, l'`etiqueteur` et le menu Category de l'outil suivent ; les 6 étiquettes `turbulence` de WILDSTRUBEL (01.09 → 06.09) passées à `visibilite`. Le journal garde sa catégorie `turbulence` et son détecteur ; la correspondance la range dans `visibilite`.
- **Décision** : la famille `turbulence` (Atmospheric turbulence) est réunie à `visibilite` (Visibility) : une gêne diffuse entre la caméra et la scène, l'image faible ou floue, ou qui tremble ; la description dit laquelle est vue. Cinq familles : `visibilite`, `obstruction`, `deplacement_thermique`, `deplacement`, `cible_a_probleme`. `labeling/familles.md`, l'`etiqueteur` et le menu Category de l'outil suivent ; les 6 étiquettes `turbulence` de WILDSTRUBEL (01.09 → 06.09) passées à `visibilite`. Le journal garde sa catégorie `turbulence` et son détecteur ; la correspondance la range dans `visibilite`.
- **Pourquoi** : l'utilisateur, 2026-11-02, après l'essai WILDSTRUBEL : turbulence atmosphérique et Visibility, « la même chose ». Avis de Claude, accepté : deux mécanismes, mais pour une étiquette la même conclusion pour le client, et une séparation que les images fixes ne montrent pas (l'étiqueteur a tiré la turbulence du contexte de la station, sans la voir, en doutant de la lumière).
- **Options écartées** : garder deux familles, la signature de la turbulence (milieu de journée, soleil, surface chaude, bruit rapide sans rejet) dite dans la description à la place.
- **Conséquence** : aucune.
@@ -1075,7 +1075,7 @@ Règles du journal :
## D-113 — 2026-11-02 — `/support <STATION>` : le rapport de situation, à partir des étiquettes
- **Statut** : active, à essayer ; complète D-079, qui reste le mode « mail ».
- **Décision** : `/support <STATION> [--du --au]` (`.claude/skills/support/rapport.md`) fait le point sur une station pour le client, à partir des étiquettes de `labeling/auto/<STATION>.jsonl` et de `labeling/familles.md`, qui font le diagnostic ; les données de `data/` ne servent qu'à l'illustrer, une ou deux images par constat (la courbe des cibles touchées, plage grisée, et l'image de la caméra quand la cause s'y voit), chacune regardée avant d'être gardée. Il regroupe les étiquettes d'une même cause en constats, les classe par ce qui compte pour le client (Displacement, Faulty target, No data, puis Obstruction et Visibility, enfin Thermal displacement), et écrit `support/<AAAA-MM-JJ>_<STATION>_rapport-situation/rapport.md` : En bref, Ce qui s'est passé, À faire, Ce qui n'est pas établi, Chronologie, puis une partie interne (sources par `debut` d'étiquette, points à relire). Une section, une diapositive : les rapports seront mis en présentation ensuite. `/support <mail>` ne change pas.
- **Décision** : `/support <STATION> [--du --au]` (`.claude/skills/support/rapport.md`) fait le point sur une station pour le client, à partir des étiquettes de `labeling/auto/<STATION>.jsonl` et de `labeling/familles.md`, qui font le diagnostic ; les données de `data/` ne servent qu'à l'illustrer, une ou deux images par constat (la courbe des cibles touchées, plage grisée, et l'image de la caméra quand la cause s'y voit), chacune regardée avant d'être gardée. Il regroupe les étiquettes d'une même cause en constats, les classe par ce qui compte pour le client (Displacement, Target issue, No data, puis Obstruction et Visibility, enfin Thermal displacement), et écrit `support/<AAAA-MM-JJ>_<STATION>_rapport-situation/rapport.md` : En bref, Ce qui s'est passé, À faire, Ce qui n'est pas établi, Chronologie, puis une partie interne (sources par `debut` d'étiquette, points à relire). Une section, une diapositive : les rapports seront mis en présentation ensuite. `/support <mail>` ne change pas.
- **Pourquoi** : l'utilisateur, 2026-11-02 : l'agent de support produit un rapport de situation, un diagnostic fondé sur les étiquettes ; elles lui donnent tout ce qu'il faut pour comprendre ce qui ne va pas et répondre au client. Premier usage : trois stations étiquetées par l'`etiqueteur`, rapports à mettre en PowerPoint. Puis : des images pour appuyer ce qui est dit, dans le rapport et la présentation, mais un résultat concis, simple, clair et précis.
- **Options écartées** : remplacer le mode mail (validé sur LENZSPITZE) ; un sous-agent à part (le rapport se relit et se corrige dans la conversation, comme le mail) ; relire les données pour refaire ou vérifier le diagnostic (c'est le travail de l'étiqueteur et de la relecture de l'utilisateur) ; plusieurs figures par constat (concision).
- **Conséquence** : la qualité du rapport est celle des étiquettes ; une étiquette sans famille est rangée par l'agent et signalée « à relire ».