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

74 lines
5.8 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)`).
- Trois onglets : `Time Series`, `Advanced`, `Diagnosis` (ouvert au chargement).
- `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 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 habituel du capteur : `(valeur − médiane) / MAD`, médiane et MAD (écart absolu médian, non mis à l'échelle) calculées sur toute la fenêtre, valeurs vides exclues, comme `agents/diagnostic/outils/resume.py`. Échelle divergente symétrique, plafonnée à ±5 : un choix d'affichage, pas un seuil de verdict.
- Case sans valeur (mesure rejetée, donc `corr_x` / `corr_y` vides, ou mesure absente) : grise, sans distinguer les deux en version 0. MAD nulle : ligne grise.
- Survol : capteur, instant UTC, valeur brute et écart.
- Limite connue : un palier long (PR17, presque la moitié de la fenêtre) gonfle la MAD de son capteur et ressort moins fort.
### 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.
### 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 médiane et MAD par capteur et par grandeur, 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 du 08/10 02:30 au 12/10 23:00, ses voisines et les références non ;
- 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.
## 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.