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

14 KiB
Raw Blame History

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.