diff --git a/docs/decisions.md b/docs/decisions.md index db88841..71c0aa1 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -583,3 +583,14 @@ Règles du journal : - **Pourquoi** : demande de l'utilisateur, qui est l'expert, et qui veut aussi encapsuler ce gros développement à part. Dès qu'une anomalie apparaît, les pages actuelles de la plateforme ne servent ni le client ni l'expert : il faut passer de page en page, et le diagnostic est difficile. L'agent aide, mais l'humain n'a pas accès à ses preuves. La roadmap AIMsight (§4) prévoit les mêmes preuves déterministes pour les tableaux de bord et pour l'explication par un LLM. - **Options écartées** : approfondir d'abord l'agent (plus de cas, plus d'outils), écarté par l'utilisateur pour rester efficace ; concevoir tout de suite trois vues tirées des cas connus (capteurs × temps en écart à leur niveau habituel, image annotée par capteur, capteur et témoin avec brut, corrigé, erreur et vignettes), reporté : sans les pages actuelles ni un cas vécu, on risque de refaire l'existant ou de viser à côté. Ces trois vues restent des pistes. - **Conséquence** : les maquettes (D-022, D-039) gagneront un volet déplacements, pour le client comme pour l'expert ; le cadrage des déplacements (D-044) reste au second plan. + +## D-053 — 2026-10-16 — Vues des déplacements : maquette de la page Explore avec un onglet Diagnosis, vue d'ensemble d'abord +- **Statut** : active. +- **Décision** : + - première vue du chantier D-052 : une maquette HTML de la page Explore de la plateforme, avec ses deux onglets (`Time Series`, `Advanced`) et un troisième, `Diagnosis`, un ensemble de visualisations pour le diagnostic côté support (l'expert), peut-être côté client plus tard ; + - entrée par une vue d'ensemble, d'où l'on déplie les capteurs qui intéressent : l'image de la caméra à un instant T, chaque capteur marqué à sa position, et une grille capteurs × temps colorée par l'écart au niveau habituel (médiane, MAD, comme l'outil `resume.py` de l'agent), reliées ; le détail d'un capteur commence minimal et se remplit pas à pas avec l'utilisateur ; + - les deux onglets existants sont un décor : les captures de la plateforme, telles quelles ; + - construction : un script Python et un gabarit HTML (plotly.js), comme `maquettes/` ; code et spec dans `vues-deplacements/maquette/` (spec : `spec.md`). +- **Pourquoi** : demande de l'utilisateur ; une anomalie se lit en deux questions, où (l'image : dépôt sur la vitre, traînée sur CTR03 et PR18) et quand, local ou commun (la grille : une ligne ou une colonne) ; l'utilisateur ne sait pas encore ce que doit montrer le détail et préfère avancer doucement. +- **Options écartées** : entrer par une cible choisie, ou par le rapport de l'agent (« un peu des trois », mais la vue d'ensemble d'abord) ; redessiner les deux onglets existants depuis les exports (plus de code pour un décor, et sans le panneau Camera movement, absent des exports) ; figures construites en Python (la liaison image ↔ grille demande de toute façon du JS) ; fichier autonome aux images embarquées (985 images, basse résolution, réflecteurs illisibles). +- **Conséquence** : la page ne marche que sur le poste (images référencées dans `vues-deplacements/cas/`) ; elle sert de cadre aux étapes suivantes : détail d'un capteur, agent dans la page. diff --git a/vues-deplacements/maquette/spec.md b/vues-deplacements/maquette/spec.md new file mode 100644 index 0000000..2b1513f --- /dev/null +++ b/vues-deplacements/maquette/spec.md @@ -0,0 +1,73 @@ +# 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 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_.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 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.