Files
Support-Agent/vues-deplacements/maquette/spec.md
T

122 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Maquette Explore : onglet Diagnosis (version 0, le cadre)
Spec validée en conversation le 2026-10-16 (D-053). Cas de départ : `cas/2026-10_NORDEND/` (Carrière TROYDO (B), PR17).
## But
Donner au support (l'expert) un ensemble de visualisations pour diagnostiquer les déplacements sans passer de page en page ; peut-être aussi au client, plus tard. On part d'une **vue d'ensemble**, d'où l'on déplie les capteurs qui intéressent. Cette version 0 est un **cadre** : on le remplit ensuite pas à pas, avec l'utilisateur.
Réussi si, sur le cas NORDEND, la vue d'ensemble montre PR17 seule touchée du 08/10 02:30 au 12/10 23:00 UTC, les épisodes communs du 09/10 et du 14/10, et l'image du disque sous PR17 en un clic.
## La page
Maquette de la page Explore de la plateforme, texte en anglais (D-023).
- Habillage repris de `maquettes/user/summary_template.html` : barre latérale « AIMsight monitoring », en-tête `<nom plateforme> · Explore`, sélecteur de dates affiché seulement (inerte). Le nom plateforme est le préfixe du nom de l'export « advanced » (`Carrière TROYDO (B)_advanced_…` → `Carrière TROYDO (B)`).
- Quatre onglets : `Time Series`, `Advanced`, `View` (ouvert au chargement, ajouté le 2026-10-16 à la demande de l'utilisateur), `Diagnosis`. L'adresse peut choisir l'onglet de départ : `#tab=diagnosis`.
- `Time Series` et `Advanced` sont un décor : les captures de `cas/<cas>/plateforme/` affichées telles quelles, `01` à `03` dans `Time Series`, `04` et `05` dans `Advanced`. Elles couvrent le 1/10 au 16/10, les données le 5/10 au 16/10 : écart admis.
## L'onglet View
Parcourir les images de `images/` une à une, pour voir comment les cibles évoluent : une fonction absente du monitoring. Demande de l'utilisateur, 2026-10-16 : une vue toute simple pour commencer.
- L'image en grand, son heure UTC en surimpression ; dessous, un glisseur sur toutes les images (une étiquette par jour UTC). Départ : la dernière image.
- Bandes d'`error_value` (demande de l'utilisateur, 2026-10-16), sous le glisseur, une colonne par image, dans la couleur des cercles (vert loin du seuil, orange à son approche, rouge au-dessus, gris sans valeur) :
- en haut, le **système entier** : moyenne, sur les capteurs mesurés, de `error_value / error_threshold` du capteur (les seuils vont de 0,3 à 0,7), rouge si elle dépasse 1 ;
- en bas, la **cible du gros plan** : son `error_value` face à son seuil (d'abord en rouge et clair seulement, puis en dégradé).
- Survol : l'heure, la moyenne du système et le nombre de capteurs au-dessus de leur seuil, la valeur de la cible. Clic : l'image à cet endroit.
- Boutons `Previous rejection` / `Next rejection` : début de l'épisode de rejet (images rejetées consécutives) précédent ou suivant de la cible. À côté, le décompte : PR17, 13 images en 3 épisodes (09/10 vers 09:00 et 23:00, 14/10), le même que dans l'export.
- `◀` / `▶`, flèches du clavier : image précédente ou suivante ; Maj + flèche : même heure la veille ou le lendemain (image la plus proche à 10 min près).
- Film : `Play` / barre d'espace, 2, 4 ou 8 images/s ; l'image suivante n'arrive qu'une fois la précédente décodée (2,3 Mo, 3088 × 2064 px) ; arrêt à la dernière.
- Comparaison : `Off`, `−24 h`, `+24 h` : à droite, l'image la plus proche de la même heure la veille ou le lendemain (mêmes conditions, autre jour), ou « No image at this time » ; elle suit le glisseur et le film.
- Zoom à la molette autour du pointeur, déplacement à la souris, commun aux deux images ; départ et double-clic : cadre des capteurs (le même que Diagnosis) ; `Full image` : l'image entière.
- Une simple balise `<img>` zoomée en CSS, sans Plotly : changer d'image reste rapide en film.
- Capteurs (ajoutés le 2026-10-16 à la demande de l'utilisateur, « pour savoir ce qu'on regarde ») : sur chaque grande image, un cercle de 22 px (de l'image) et le nom de chaque capteur, à `x`, `y` mesurés à l'heure de cette image ; la cible du gros plan en gras souligné. Case `Sensors` pour les masquer. Couleur au choix (`colored by`) :
- `error_value` (défaut, demande de l'utilisateur) : la valeur à côté du nom ; vert loin du seuil du capteur (`error_threshold`), vers l'orange à son approche (teinte linéaire en `error_value / seuil`, un choix d'affichage), rouge en pointillés au-dessus (mesure rejetée), gris sans valeur ;
- `type` : jaune les cibles, bleu les références, orange la *local reference*. Ils zooment avec l'image ; les noms gardent 12 px à l'écran. Des noms voisins se chevauchent à l'image entière (CTR01 et PR01, PR08 et CTR04) : le zoom les sépare.
- Adresse : `#img=2026-10-08T02:30Z&cmp=-24` (image de départ, comparaison `-24` ou `24`).
- Vérifié par captures (image seule, comparaison −24 h le 08/10 02:30 : le disque et la buée sur l'image du 08/10, pas sur celle du 07/10). Pas encore essayés : glisseur, clavier, film, zoom à la souris.
### Gros plan d'une cible (sous la vue)
Demande de l'utilisateur, 2026-10-16. Il sépare deux besoins :
1. **L'aspect d'une cible** d'une heure ou d'un jour à l'autre (perte de visibilité, obstacle, buée…) : les images servent au diagnostic. C'est ce que fait le gros plan.
2. **Le déplacement d'une cible** : les images ne servent que pour un déplacement grossier (cible déplacée ou écrasée). Un déplacement fin, comme le saut de PR17 du 08/10 02:30 (−0,26 px en `y`), ne se voit pas à l'œil. Pas de vue pour ce besoin.
- Une liste des capteurs (défaut PR17, ou `#target=…` dans l'adresse), un demi-côté de cadre (±15, 30 par défaut, 75, 150, 300 px), un pas (15 min, 1 h par défaut, 3 h, 6 h, 1 jour) et un nombre d'images de chaque côté (2, 3 par défaut, 4, 6).
- Chaque vignette est **centrée sur `x`, `y` mesurés à sa propre heure** (mesure la plus proche, à 10 min près ; les mesures rejetées gardent leurs `x`, `y`), pas sur `corr`, et la page l'écrit. Sans mesure : la position médiane du capteur, signalée sous la vignette. Pixels non lissés.
- Sous chaque vignette : `error 0.65 > 0.4` (`error_value` à son heure face au seuil du capteur), en rouge au-dessus du seuil.
- Une rangée par image du haut : au centre, en grand (300 px, cadre bleu), l'image du haut ; de part et d'autre, les images d'avant et d'après, au pas choisi (140 px), avec leur décalage (−2 h…) et leur heure. Si la comparaison à ±24 h est active, une seconde rangée fait de même autour de l'image comparée. Clic sur une vignette : l'image du haut passe à son heure.
- Les rangées suivent le glisseur, le clavier et le film. Pendant le film, seule l'image du centre suit, pour ne pas charger 7 à 26 images de 2,3 Mo à chaque pas ; les autres reviennent à l'arrêt.
- Essayés puis retirés le 2026-10-16 : un cadre fixe autour de la position des 24 premières heures, avec des repères (position de départ, `x`, `y` brut, position corrigée par `corr`, cochables, et une amplification ×10 de leur écart), et une mosaïque sur une plage `from` → `to`. Le déplacement fin ne s'y voyait pas, et les repères embrouillaient la lecture.
- `error_value` vérifiée par une capture le 09/10 23:00 (17 mesures rejetées : cercles rouges en pointillés, taches pâles ; la veille, tout vert).
- Vérifié par une capture (PR17, 08/10 02:30, comparaison −24 h, pas de 1 h : la tache change d'aspect à 02:30, pas la veille). Pas encore essayés : clics, changements de réglage, film.
## L'onglet Diagnosis
De haut en bas.
### 1. Image à l'instant T
- L'image de `images/` dont l'heure (nom du fichier, D-045) est la plus proche de T, à 10 min près ; au-delà : « No image at this time ».
- Affichée en pleine résolution (3088 × 2064 px) dans un graphique Plotly (image de fond, axe y inversé), ouverte zoomée sur le cadre des positions médianes des capteurs, 150 px de marge ; zoom et déplacement libres.
- Un marqueur par capteur à sa position brute (`x`, `y`) à T, avec son nom, coloré comme sa case de la grille à T. Pas de position à T : pas de marqueur.
### 2. Grille capteurs × temps
- Une ligne par capteur : références `global_ref` (par nom), puis la *local reference* (`ref`), puis les cibles (par nom). Une colonne par instant de mesure de l'export « advanced » (15 min), à la minute.
- Trois boutons de grandeur : `corr_x`, `corr_y`, `error_value` (défaut : `corr_y`).
- Couleur = écart au niveau du début de la fenêtre, en variation d'un pas à l'autre : `(valeur − niveau) / pas`, par capteur et par grandeur, valeurs vides exclues :
- `niveau` : médiane des valeurs des 24 premières heures de la fenêtre (instants avant le premier instant de mesure + 24 h) ;
- `pas` : médiane des écarts absolus entre deux valeurs successives, sur toute la fenêtre (le critère du rapport PR17 de l'agent, qu'un palier ne gonfle pas) ;
- échelle linéaire et symétrique, bleu (négatif), blanc (au niveau), rouge (positif), plafonnée à ±10 : un choix d'affichage, pas un seuil de verdict. Écartée à l'essai : l'échelle « RdBu » de Plotly, dont le milieu gris se confondait avec le gris des cases sans valeur et qui saturait dès ±3,5.
- Case sans valeur (mesure rejetée, donc `corr_x` / `corr_y` vides, ou mesure absente) : grise, sans distinguer les deux en version 0. Aucune valeur dans les 24 premières heures, ou `pas` nul : ligne grise.
- Survol : capteur, instant UTC, valeur brute et écart.
- Vérifié sur NORDEND (`corr_y`, écart médian) : PR17 à 1,7 avant le saut, 23,6 sur le palier, 13,5 après le retour partiel ; PR16, PR18, CTR02 et CTR03 entre 1,6 et 4,1. Écartée : la médiane et la MAD de toute la fenêtre (comme `resume.py`), car le palier de PR17, plus de la moitié de la fenêtre, déplace la médiane : la ligne s'allumait avant le saut (2,3), pas pendant (1,1).
- Limite connue : si les 24 premières heures sont anormales, toute la ligne s'allume ; une dérive lente ou un changement de régime (le tilt à partir du 08/10) s'allume aussi.
### 3. Liaison
- Clic sur une case : T devient l'instant de sa colonne (un trait vertical le marque dans la grille et dans les détails ouverts ; l'image et ses marqueurs passent à T), et le détail du capteur de sa ligne se déplie sous la grille.
- Clic sur un marqueur de l'image : le détail de ce capteur se déplie, T ne change pas.
- T de départ : le dernier instant de mesure.
- L'état de départ peut se lire dans l'adresse : `#t=2026-10-08T02:30Z&col=error_value&open=PR17,PR18` (instant T, grandeur, détails dépliés ; une valeur inconnue est ignorée). Sert à la vérification par capture et à partager une vue.
### 4. Détail d'un capteur (version 0)
- Un bloc par capteur déplié, refermable (×), plusieurs à la fois, dans l'ordre d'ouverture ; un capteur déjà ouvert ne s'ouvre pas deux fois.
- Deux courbes empilées, même axe de temps : la grandeur choisie dans la grille (valeur brute, pas l'écart), puis `error_value` avec le seuil du capteur (`error_threshold`) en trait. T marqué. Changer de grandeur met à jour les détails ouverts.
- C'est ici que l'on ajoutera, pas à pas, ce que l'utilisateur demandera (brut, témoins, vignettes…).
## Fichiers et flux
- `vues-deplacements/maquette/explore.py [dossier de station]` (défaut `vues-deplacements/cas/2026-10_NORDEND/NORDEND/`) :
- lit l'export « advanced » avec `agents/diagnostic/outils/donnees.py` (`charger`, `trouver`, `heure_image`), sans le copier ;
- calcule l'écart de chaque mesure (niveau des 24 premières heures, pas d'une mesure à l'autre), la position médiane de chaque capteur, la liste des images avec leur heure ;
- injecte un JSON dans `explore_template.html` et écrit `out/vues_deplacements_<STATION>.html` (`<STATION>` : nom du dossier), puis l'ouvre (`src/common/page.py`, `open_html`).
- `vues-deplacements/maquette/explore_template.html` : habillage, onglets, plotly.js 4.1.1 par CDN (comme les maquettes existantes), JS de la liaison.
- Images et captures référencées par chemin relatif depuis `out/`, sans copie : la page ne marche que sur ce poste, assez pour une maquette.
- Bibliothèque standard côté Python ; ni pandas ni nouvelle dépendance.
- Identifiants : l'export « advanced » et les captures 01 à 05 n'en contiennent pas ; rien à masquer.
## Vérification
Pas de tests automatisés (D-008). Lancer `python3 vues-deplacements/maquette/explore.py`, ouvrir la page et contrôler :
- la ligne de PR17 en `corr_y` allumée à partir du 08/10 02:30, saturée jusqu'au 12/10 23:00, encore nette ensuite (retour partiel), ses voisines et les références pâles ;
- des colonnes allumées pour de nombreux capteurs le 09/10 et le 14/10 en `error_value` ;
- clic sur le 08/10 02:30 : l'image de 02:30 avec le disque sous PR17, les marqueurs sur les réflecteurs ;
- clic sur PR17 : son détail, avec le palier et le seuil 0,4 ;
- les onglets `Time Series` et `Advanced` montrent les captures.
## État (2026-10-16)
- **Construit** : `explore.py` et `explore_template.html` (plan : `docs/superpowers/plans/2026-10-16-maquette-explore-diagnosis.md`).
- **Vérifié** par des captures Chrome headless (adresse avec `#t=…&col=…&open=…`) : tous les points de « Vérification » ci-dessus, sauf les clics.
- **Pas encore vérifié** : les clics (case, marqueur, changement de grandeur avec détails ouverts, zoom d'un détail), à essayer par l'utilisateur.
- **Suite** : le retour de l'utilisateur sur cette version 0, puis le détail d'un capteur, pas à pas. Piste notée : des marqueurs en anneau plutôt qu'en pastille, pour voir le réflecteur sous chaque capteur.
## Hors version 0
Agent dans la page, rapport interactif, vue client, autres cas, données de la base de la plateforme (pan, tilt, roll), export horaire en mm : plus tard, à la demande de l'utilisateur.