Files
Support-Agent/vues-deplacements/CLAUDE.md
T
2026-10-26 14:14:38 +01:00

34 lines
5.1 KiB
Markdown

# 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 `journal/` (`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 `journal/categories.py` (`python3 vues-deplacements/journal/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 ; 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`.