# 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 ` · 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//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 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 divergente symétrique, plafonnée à ±10 : 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. 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_.html` (`` : 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. ## 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.