Files
Support-Agent/vues-deplacements/CLAUDE.md
T
maximeandClaude Opus 5.5 d5bae7a696 Add the loop's end-of-session page and a detector benchmark on the case base
- End-of-session page for /boucle: the session's curves, the analyst's
  labels against the detectors' events per category, a plain score table
  and the benchmark (comparaison.py, D-066)
- Detectors moved to vues-deplacements/detectors/ (D-067)
- Detectors must detect everything; what the client sees is a separate
  layer (D-068)
- Benchmark: each case keeps its labels from creation (etiquettes.json),
  benchmark.py scores the detectors on every case, history in
  vues-deplacements/benchmark/historique.csv; run by /boucle at each lot,
  after each change and at the end, read by the upgrader and validator;
  labels for C-001..C-005 from one analyst pass corrected by their files,
  C-006..C-008 from lot 01 (D-069)
- Fixes from the releveur's notes: /boucle arguments and other sessions,
  branch name in the spec, detector name in categories.py output, learned
  case header, anonymiser.py (camera/, no empty CSVs, --etiquettes),
  ensemble.py (clock-aligned steps, title), plages.py (same-sign merge),
  labeling request written into /nouveau-cas
- Also carries the other session's uncommitted D-065 edits in the same
  files; data/, .gitignore, pomper.py and stations.py are left out

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 16:48:13 +01:00

5.3 KiB

Vues des déplacements

Chantier à part (D-052) : rendre les données de déplacement lisibles par un humain, client comme expert, et intégrer l'agent de diagnostic dans une maquette. Le but est de montrer à l'utilisateur ce que l'agent utilise pour diagnostiquer. On part de cas réels, apportés par l'utilisateur (l'expert) avec les pages de la plateforme qu'il a consultées, et on avance pas à pas.

Rangement

vues-deplacements/
├── CLAUDE.md        cette carte
├── contexte/        ce qui ne tient pas à un cas : designs actuels de la plateforme, documents, notes
└── cas/<cas>/       un cas réel par dossier (nom libre)
    ├── <STATION>/   données de la station, rangées comme dans data/ : displacement/ (export « advanced », horaire), images/
    ├── plateforme/  pages de la plateforme, dans l'ordre où l'utilisateur les a ouvertes (01_…, 02_…)
    └── parcours.md  la démarche de l'utilisateur, qu'il décrit étape par étape en conversation et que Claude note ici : pages ouvertes, ce qu'il y cherchait, où il a bloqué, son verdict

Le code et les maquettes du chantier vivent dans maquette/ (D-053, D-054) : explore.py (maquette de la page Explore avec les onglets View, Diagnosis et Displacements, python3 vues-deplacements/maquette/explore.py [dossier de station], page dans out/), son gabarit explore_template.html et sa spec spec.md.

Détection mécanique des anomalies (D-055) : faire ressortir les courbes qui comptent, sans toucher aux données : les sauts (décalage soudain qui dure) et les tendances (hausse ou baisse lente), ce que regarde le client ; onglet Displacements de la maquette ; idée, méthode, résultats et pistes dans contexte/detection-d-anomalies.md, savoir métier dans docs/displacement/domaine/ce-que-regarde-le-client.md.

Journal du matin du client (D-056), le cap actuel : onglet Journal de la maquette ; un détecteur élémentaire par fichier dans detectors/ (detect(mesures) -> épisodes start, end, kind, label, text, ignore, sensors), chargés et classés en événements des onze catégories du journal par detectors/categories.py (python3 vues-deplacements/detectors/categories.py <dossier> : une ligne par événement), que explore.py affiche ; brainstorming et pistes dans contexte/journal-du-matin.md, registre des seuils provisoires dans contexte/seuils-du-journal.md, lissage dans contexte/lissage.md, données en masse et boucle Claude dans contexte/donnees-et-boucle.md.

Boucle automatique (D-057), lancée par l'utilisateur seul, sur les lots qu'il choisit : /boucle <dossier de station> [--du … --au …] fait juger les détecteurs du journal, lot après lot, par un analyste, les fait corriger par un upgrader contrôlé par un validateur, et ajoute les nouveautés à la base de cas par un builder ; une séance par branche boucle/<séance>_<STATION>, ses rendus dans boucle/<séance>_<STATION>/lot-NN/ (dont les étiquettes de l'analyste, etiquettes.json, D-061, et score-avant.txt, le score des détecteurs face à toutes les étiquettes, D-062) et son bilan.md, hors de tout dossier de station ; en fin de séance, la page out/boucle_<séance>.html montre l'analyste face aux détecteurs (D-066) ; à chaque lot et après chaque modification, le benchmark des détecteurs sur la base de cas (.claude/skills/boucle/benchmark.py, historique dans benchmark/historique.csv, D-069) ; spec contexte/boucle-automatique.md.

Aiguiser la lecture (D-059), lancé par l'utilisateur seul, sur les lots qu'il choisit : /aiguiser <dossier de station> [--du … --au …] améliore les outils de lecture (agents/diagnostic/outils/) et leur mode d'emploi, le skill lire-les-donnees, que suivent l'analyste et l'agent de diagnostic : un lecteur lit le lot avec le skill, un correcteur le lit à fond avec ses propres scripts et mesure l'écart, un optimiseur modifie le skill, un changement sans gain est annulé ; commandes des fiches lancées en fin de séance (D-064) ; une séance par branche aiguiser/<séance>_<STATION>, ses rendus dans aiguiser/<séance>_<STATION>/lot-NN/ et bilan.md, hors de tout dossier de station ; spec contexte/aiguiser-la-lecture.md.

Règles

  • Les données restent seules dans <STATION>/ : les outils de l'agent lisent tout le dossier qu'on leur donne, et une capture PNG y passerait pour une image de la caméra. Le verdict de l'utilisateur, dans parcours.md, reste hors de la vue de l'agent.
  • Les exports reçus (« advanced », horaire) n'ont pas tout ce que montrent les graphiques de la plateforme : par exemple, le tilt de la caméra n'y est pas (constaté sur NORDEND, octobre 2026). Le pompage (extraction/) le récupère : camera/ du dossier pompé, pan, tilt, scale, rotation et sigma0 à chaque mesure.
  • Chantier très expérimental (utilisateur, 2026-10-16) : essayer des choses et converger pas à pas vers une solution qui marche ; pas de revue ni de haute qualité exigée ; vérifier par un lancement et une capture.
  • Agent sur un cas, seulement si l'utilisateur le demande : @agent-diagnostic vues-deplacements/cas/<cas>/<STATION>/ [question].
  • Les règles du projet (CLAUDE.md à la racine) s'appliquent : heures en UTC, documents en français, texte du site en anglais (D-023), pas de données synthétiques, identifiants (SIM_CCID, ip) jamais recopiés, décisions dans docs/decisions.md.