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

5.8 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)).
  • 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.