Add the implementation plan of the Explore mockup; color the grid by deviation from the first 24 h (D-053)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-16 14:50:27 +02:00
1 parent 6e52bbc66a
commit 6587a08723
3 files changed
+781 -7

No files matched your search

+2 -2
View File
@@ -588,9 +588,9 @@ Règles du journal :
- **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 ;
- 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 des 24 premières heures de la fenêtre, mesuré en variation d'un pas à l'autre (le critère du rapport PR17 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).
- **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) ; colorer la grille par l'écart à la médiane de toute la fenêtre (MAD, comme `resume.py`) : le palier de PR17, plus de la moitié de la fenêtre, déplace la médiane, et la ligne s'allume avant le saut au lieu de pendant ; par l'écart aux 24 h glissantes : seuls les sauts s'allument, pas le palier ; 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.
@@ -0,0 +1,769 @@
# Maquette Explore avec l'onglet Diagnosis : plan d'implémentation
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal :** une maquette HTML de la page Explore de la plateforme (Carrière TROYDO (B), cas NORDEND), avec ses deux onglets en décor et un troisième, `Diagnosis` : image de la caméra à l'instant T et grille capteurs × temps reliées, détail d'un capteur minimal.
**Architecture :** un script Python (`explore.py`, bibliothèque standard) lit l'export « advanced » avec l'outil `donnees.py` de l'agent, calcule l'écart de chaque mesure et injecte un JSON dans un gabarit HTML (`explore_template.html`) ; la page dessine tout en plotly.js, avec un peu de JS pour la liaison. Même schéma que `maquettes/user/summary.py`.
**Tech Stack :** Python 3 (bibliothèque standard), plotly.js 4.1.1 par CDN, Chrome headless (Windows, depuis WSL) pour les captures de vérification, `node --check` pour la syntaxe JS.
**Spec :** `vues-deplacements/maquette/spec.md` (D-053). La lire avant chaque tâche.
## Global Constraints
- Python : bibliothèque standard seulement ; ni pandas ni nouvelle dépendance. Les scripts du dépôt importent `src/common/page.py`, qui relance le script sous `.venv/bin/python` si plotly manque : lancer les vérifications Python avec `.venv/bin/python`.
- plotly.js : `<script src="https://cdn.plot.ly/plotly-4.1.1.min.js"></script>`, comme `maquettes/user/summary_template.html`.
- Texte affiché par la page en anglais (D-023) ; commentaires, docstrings et documents en français ; messages de commit en anglais, terminés par `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
- Toute heure en UTC, au format `2026-10-08T02:30Z` (`donnees.iso`).
- Pas de tests automatisés ni de fichier de test (D-008) : on vérifie en lançant le script, par des assertions en ligne de commande (non commitées) et par des captures Chrome headless lues avec Read.
- Couleur de la grille : `(valeur − niveau) / pas` ; `niveau` = médiane des valeurs des 24 premières heures de la fenêtre ; `pas` = médiane des écarts absolus entre deux valeurs successives ; plafond ±10 ; case ou ligne sans valeur en gris (spec §2).
- Image la plus proche de T à 10 min près ; zoom de départ sur les positions médianes des capteurs, 150 px de marge (spec §1).
- Graphiques temporels du détail : zoom dans le temps seulement, ordonnée recalée sur la plage visible (D-013, `AUTOSCALE_Y_JS` de `src/common/page.py`).
- Aucun identifiant (`SIM_CCID`, `ip`) dans la page ; données réelles seulement.
## Review Focus
- Instant T sans image à 10 min près (le 05/10 de 22:00 à 23:45 : les images commencent le 06/10 à 00:00) : « No image at this time », marqueurs gardés. Testé tâche 2 (capture `#t=2026-10-05T22:00Z`).
- Cas sans dossier `plateforme/` (ex. `data/PS_DES_COUDRES`) : les onglets décor affichent « No capture of this page. », sans erreur. Testé tâche 1 (assertion).
- Dossier sans export « advanced » (mauvais chemin) : message clair et code de sortie 1, pas de trace Python. Testé tâche 1.
- Capteur demandé deux fois (clic répété, `open=PR17,PR17`) : un seul bloc de détail. Testé tâche 3 (capture).
- Grandeur imposée par l'adresse avec un détail ouvert (`col=error_value&open=PR17`) : la grille, les marqueurs et le détail suivent la même grandeur. Testé tâche 3 (capture).
## Fichiers
- Créer `vues-deplacements/maquette/explore.py` : lecture, calcul des écarts, JSON, écriture de la page.
- Créer `vues-deplacements/maquette/explore_template.html` : habillage, onglets, JS de la page.
- Modifier `vues-deplacements/CLAUDE.md` (rangement), `CLAUDE.md` (commande, carte, état).
- Lus sans modification : `agents/diagnostic/outils/donnees.py` (`trouver`, `charger`, `heure_image`, `iso`), `src/common/page.py` (`open_html`, `AUTOSCALE_Y_JS`), `maquettes/user/summary_template.html` (habillage repris).
---
### Task 1 : le script, la page et ses deux onglets décor
**Files :**
- Create : `vues-deplacements/maquette/explore.py`
- Create : `vues-deplacements/maquette/explore_template.html`
- Modify : `vues-deplacements/CLAUDE.md`, `CLAUDE.md`
**Interfaces :**
- Consumes : `donnees.trouver(dossier) -> {"advanced": [chemins], "images": [chemins], ...}` ; `donnees.charger(dossier) -> {capteur: [mesure]}`, mesure = dict avec `t` (datetime UTC), `pattern_type`, et `x`, `y`, `error_value`, `error_threshold`, `corr_x`, `corr_y`… (float ou None) ; `donnees.heure_image(chemin) -> datetime | None` ; `donnees.iso(t) -> "2026-10-08T02:30Z"` ; `common.page.open_html(chemin)`.
- Produces : `deviation(values, first_day) -> list[float | None]` ; `build(folder) -> dict` ; `page(folder) -> Path`. JSON de la page (`const D` dans le gabarit) :
- `platform` (str) ; `times` (liste de `"AAAA-MM-JJTHH:MMZ"`, triée) ;
- `sensors` : liste ordonnée (références `global_ref`, puis `ref`, puis cibles, chacune par nom) de `{"name", "kind", "threshold", "x": [...], "y": [...], "home": [x, y] | None, "values": {"corr_x": [...], "corr_y": [...], "error_value": [...]}, "dev": {même clés}}`, chaque liste alignée sur `times` (None = vide) ;
- `images` : `[{"t": "AAAA-MM-JJTHH:MMZ", "src": URL relative depuis out/}]`, triées ; `view` : `{"x": [x0, x1], "y": [y0, y1]}` ou None ; `captures` : `{"time_series": [URL], "advanced": [URL]}`.
- Gabarit : `<!--PLATFORM-->` (nom échappé, toutes les occurrences), `/*DATA*/null` (le JSON) ; éléments `#period`, `.tabs button[data-pane]`, `#time_series`, `#advanced`, `#diagnosis`, `#columns`, `#instant`, `#image`, `#grid`, `#details`.
- [ ] **Step 1 : écrire `vues-deplacements/maquette/explore.py`**
```python
"""Maquette de la page Explore avec un onglet Diagnosis (D-053) ; spec : vues-deplacements/maquette/spec.md.
Lit l'export « advanced » d'un dossier de station avec l'outil donnees.py de l'agent, calcule l'écart de chaque mesure
au niveau des 24 premières heures, en variation d'un pas à l'autre, liste les images et les captures de la plateforme,
puis remplit explore_template.html. Écrit out/vues_deplacements_<STATION>.html et l'ouvre dans le navigateur.
Usage : python3 vues-deplacements/maquette/explore.py [dossier de station] (défaut : le cas NORDEND d'octobre 2026)
"""
import html
import json
import os
import statistics
import sys
from datetime import timedelta
from pathlib import Path
from urllib.parse import quote
HERE = Path(__file__).resolve().parent
ROOT = HERE.parents[1]
OUT = ROOT / "out"
DEFAULT = ROOT / "vues-deplacements" / "cas" / "2026-10_NORDEND" / "NORDEND"
sys.path.insert(0, str(ROOT / "src"))
sys.path.insert(0, str(ROOT / "agents" / "diagnostic" / "outils"))
from common.page import open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
import donnees # noqa: E402 (lecture des exports, bibliothèque standard)
COLUMNS = ("corr_x", "corr_y", "error_value") # grandeurs de la grille (spec §2)
KINDS = ("global_ref", "ref", "target") # ordre des lignes : références de la compensation, local reference, cibles
LEVEL_WINDOW = timedelta(hours=24) # niveau = médiane des 24 premières heures de la fenêtre (spec §2, choix de l'utilisateur)
MARGIN_PX = 150 # marge autour des capteurs, zoom de départ de l'image (spec §1)
CAPTURES = {"time_series": ("01", "02", "03"), "advanced": ("04", "05")} # captures de cas/<cas>/plateforme/ par onglet
def deviation(values, first_day):
"""Valeurs alignées sur les instants (None = vide), nombre d'instants des 24 premières heures -> écarts
(valeur − niveau) / pas ; tout à None sans valeur dans les 24 premières heures ou si le pas est nul (spec §2)."""
present = [x for x in values if x is not None]
head = [x for x in values[:first_day] if x is not None]
steps = [abs(b - a) for a, b in zip(present, present[1:])]
if not head or not steps:
return [None] * len(values)
level, step = statistics.median(head), statistics.median(steps)
if step == 0:
return [None] * len(values)
return [None if x is None else (x - level) / step for x in values]
def url(path):
"""Chemin -> URL relative depuis out/, où la page est écrite."""
return quote(Path(os.path.relpath(path, OUT)).as_posix())
def build(folder):
"""Dossier de station -> données de la page ; quitte avec un message s'il n'a pas d'export « advanced »."""
files = donnees.trouver(str(folder))
if not files["advanced"]:
sys.exit(f"Pas d'export « advanced » dans {folder}")
mesures = donnees.charger(str(folder))
minute = lambda t: t.replace(second=0, microsecond=0) # noqa: E731 (instants à la minute, comme donnees.iso)
instants = sorted({minute(m["t"]) for ms in mesures.values() for m in ms})
col = {t: j for j, t in enumerate(instants)}
first_day = sum(1 for t in instants if t < instants[0] + LEVEL_WINDOW)
order = lambda s: (KINDS.index(mesures[s][0]["pattern_type"]) if mesures[s][0]["pattern_type"] in KINDS # noqa: E731
else len(KINDS), s)
sensors = []
for name in sorted(mesures, key=order):
ms = mesures[name]
row = {c: [None] * len(instants) for c in ("x", "y") + COLUMNS}
for m in ms:
for c in row:
row[c][col[minute(m["t"])]] = m[c]
xs, ys = [v for v in row["x"] if v is not None], [v for v in row["y"] if v is not None]
sensors.append({"name": name, "kind": ms[0]["pattern_type"], "threshold": ms[0]["error_threshold"],
"x": row["x"], "y": row["y"],
"home": [statistics.median(xs), statistics.median(ys)] if xs and ys else None,
"values": {c: row[c] for c in COLUMNS},
"dev": {c: deviation(row[c], first_day) for c in COLUMNS}})
homes = [s["home"] for s in sensors if s["home"]]
view = {a: [min(h[k] for h in homes) - MARGIN_PX, max(h[k] for h in homes) + MARGIN_PX]
for k, a in enumerate(("x", "y"))} if homes else None
images = sorted(({"t": donnees.iso(t), "src": url(p)} for p in files["images"] if (t := donnees.heure_image(p))),
key=lambda im: im["t"])
plateforme = Path(folder).resolve().parent / "plateforme"
captures = {tab: [url(p) for n in prefixes for p in sorted(plateforme.glob(f"{n}_*"))[:1]]
for tab, prefixes in CAPTURES.items()}
return {"platform": Path(files["advanced"][0]).name.split("_advanced_")[0], "times": [donnees.iso(t) for t in instants],
"sensors": sensors, "images": images, "view": view, "captures": captures}
def page(folder):
"""Dossier de station -> chemin de la page écrite dans out/."""
data = build(folder)
text = (HERE / "explore_template.html").read_text()
text = text.replace("<!--PLATFORM-->", html.escape(data["platform"]))
text = text.replace("/*DATA*/null", json.dumps(data).replace("</", "<\\/"))
OUT.mkdir(exist_ok=True)
out = OUT / f"vues_deplacements_{Path(folder).resolve().name}.html"
out.write_text(text)
return out
if __name__ == "__main__":
out = page(sys.argv[1] if len(sys.argv) > 1 else DEFAULT)
print(out)
open_html(out)
```
- [ ] **Step 2 : vérifier le calcul et les données (doit afficher `ok`)**
Run :
```bash
.venv/bin/python -c "
import statistics as st, sys
sys.path.insert(0, 'vues-deplacements/maquette')
import explore as e
assert e.deviation([1.0, 3.0, None, 2.0, 4.0], 2) == [-0.5, 0.5, None, 0.0, 1.0]
assert e.deviation([None, None, 5.0, 6.0], 2) == [None] * 4 # rien dans les 24 premières heures
assert e.deviation([1.0, 1.0, 1.0], 2) == [None] * 3 # pas nul
d = e.build('vues-deplacements/cas/2026-10_NORDEND/NORDEND')
names = [s['name'] for s in d['sensors']]
assert d['platform'] == 'Carrière TROYDO (B)', d['platform']
assert names[:5] == ['CTR02', 'CTR03', 'CTR04', 'CTR01', 'PR01'] and len(names) == 22, names
assert len(d['times']) == 980 and d['times'][0] == '2026-10-05T22:00Z' and d['times'][-1] == '2026-10-16T05:15Z'
assert len(d['images']) == 985 and d['images'][0]['src'].startswith('../vues-deplacements/cas/2026-10_NORDEND/NORDEND/images/')
assert [len(d['captures'][k]) for k in ('time_series', 'advanced')] == [3, 2]
ctr01 = d['sensors'][names.index('CTR01')]
gaps = [j for j, v in enumerate(ctr01['values']['corr_y']) if v is None]
assert gaps and all(ctr01['dev']['corr_y'][j] is None for j in gaps) # mesure rejetée : case grise
pr17 = d['sensors'][names.index('PR17')]['dev']['corr_y']
palier = [abs(x) for x, t in zip(pr17, d['times']) if '2026-10-08T03:00Z' <= t <= '2026-10-12T22:00Z' and x is not None]
assert st.median(palier) > 20, st.median(palier) # 23,6 mesuré (spec §2)
assert e.build('data/PS_DES_COUDRES')['captures'] == {'time_series': [], 'advanced': []}
print('ok')
"
```
Expected : `ok`. Si une assertion échoue, lire la valeur affichée et corriger `explore.py`, pas l'assertion (les valeurs viennent de la spec et des données).
- [ ] **Step 3 : écrire `vues-deplacements/maquette/explore_template.html`**
```html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title><!--PLATFORM--> · Explore</title>
<script src="https://cdn.plot.ly/plotly-4.1.1.min.js"></script>
<style>
/* Maquette de la page Explore avec l'onglet Diagnosis (D-053, vues-deplacements/maquette/spec.md). Données injectées
par explore.py. Habillage repris de maquettes/user/summary_template.html. */
:root {
--sidebar: #2a3f54; --topbar: #ededed; --page: #f7f7f7; --panel-border: #e6e9ed;
--muted: #73879c; --text: #333; --line: #dee2e6; --blue: #2a78d6;
}
* { box-sizing: border-box; }
body { margin: 0; background: var(--page); color: var(--muted);
font: 13px/1.47 "Helvetica Neue", Roboto, Arial, "Droid Sans", sans-serif; }
svg.i { width: 15px; height: 15px; fill: currentColor; vertical-align: -2px; }
.sidebar { position: fixed; inset: 0 auto 0 0; width: 230px; background: var(--sidebar); color: #fff; }
.brand { height: 57px; padding: 0 10px; display: flex; align-items: center; font-size: 22px; }
.profile { display: flex; align-items: center; gap: 22px; padding: 18px 12px 24px; }
.avatar { width: 56px; height: 56px; border-radius: 50%; background: #9b59b6; border: 3px solid #fff;
display: grid; place-items: center; font-size: 19px; box-shadow: 0 0 0 1px rgba(0,0,0,.15); }
.profile small { display: block; color: #bab8b8; font-size: 13px; }
.profile span { font-size: 14px; }
.section { padding: 0 23px 18px; font-size: 11px; font-weight: bold; letter-spacing: .3px; }
.nav a { display: flex; align-items: center; gap: 4px; padding: 13px 15px; color: #e7e7e7;
text-decoration: none; font-weight: bold; }
.nav a .chev { margin-left: auto; }
.topbar { margin-left: 230px; height: 52px; background: var(--topbar); border-bottom: 1px solid #d9dee4;
display: flex; align-items: center; justify-content: space-between; padding: 0 15px; }
.topbar .burger { color: #5a738e; width: 26px; height: 26px; }
.user { display: flex; align-items: center; gap: 10px; color: #515356; }
.user .avatar { width: 29px; height: 29px; border-width: 0; font-size: 11px; box-shadow: none; }
main { margin-left: 230px; padding: 10px 28px; }
.panel { background: #fff; border: 1px solid var(--panel-border); padding: 10px 17px 20px; }
.panel-title { display: flex; align-items: center; border-bottom: 2px solid var(--panel-border); padding: 4px 6px 12px; }
.panel-title h2 { margin: 0; font-size: 18px; font-weight: 400; }
.panel-title h2 small { font-size: 14px; margin-left: 10px; }
.panel-title .tools { margin-left: auto; color: #c5c7cb; }
/* Période (inerte) et onglets, comme la page Explore de la plateforme. */
.period { display: flex; margin: 22px 22px 0; }
.period span { border: 1px solid #ced4da; border-radius: 4px 0 0 4px; padding: 7px 12px; color: var(--text); font-size: 15px; }
.period b { background: #6c757d; color: #fff; padding: 7px 12px; font-weight: normal; font-size: 15px; border-radius: 0 4px 4px 0; }
.tabs { display: flex; margin: 18px 22px 0; border-bottom: 1px solid var(--line); }
.tabs button { border: 1px solid transparent; border-bottom: 0; background: none; padding: 7px 16px; margin-bottom: -1px;
font: inherit; font-size: 15px; color: var(--blue); cursor: pointer; border-radius: 4px 4px 0 0; }
.tabs button.active { color: var(--text); background: #fff; border-color: var(--line); }
.pane { display: none; margin: 0 22px; padding-top: 14px; }
.pane.active { display: block; }
.pane > img { display: block; width: 100%; margin-bottom: 8px; border: 1px solid var(--line); }
.empty { padding: 30px 0; color: var(--muted); }
</style>
</head>
<body>
<svg style="display:none">
<symbol id="home" viewBox="0 0 20 20"><path d="M10 2 1 10h3v8h5v-5h2v5h5v-8h3z"/></symbol>
<symbol id="list" viewBox="0 0 20 20"><path d="M1 3h3v3H1zm5 0h13v3H6zM1 8.5h3v3H1zm5 0h13v3H6zM1 14h3v3H1zm5 0h13v3H6z"/></symbol>
<symbol id="cog" viewBox="0 0 20 20"><circle cx="10" cy="10" r="6" fill="none" stroke="currentColor" stroke-width="4" stroke-dasharray="2.4 2.3"/><circle cx="10" cy="10" r="5" fill="none" stroke="currentColor" stroke-width="3"/></symbol>
<symbol id="chev" viewBox="0 0 20 20"><path d="M4 7l6 6 6-6" fill="none" stroke="currentColor" stroke-width="2.2"/></symbol>
<symbol id="burger" viewBox="0 0 20 20"><path d="M2 4h16v2.4H2zm0 4.8h16v2.4H2zm0 4.8h16V16H2z"/></symbol>
<symbol id="wrench" viewBox="0 0 20 20"><path d="M13.5 1.5a5 5 0 0 0-4.6 6.9L2 15.3 4.7 18l6.9-6.9a5 5 0 0 0 6.9-4.6l-3 3-2.8-.6-.6-2.8z"/></symbol>
</svg>
<aside class="sidebar">
<div class="brand">AIMsight monitoring</div>
<div class="profile"><div class="avatar">MP</div><div><small>Welcome,</small><span>Maxime Pasquier</span></div></div>
<div class="section">GENERAL</div>
<nav class="nav">
<a><svg class="i"><use href="#home"/></svg>Home</a>
<a><svg class="i"><use href="#list"/></svg>Explore<svg class="i chev"><use href="#chev"/></svg></a>
<a><svg class="i"><use href="#cog"/></svg>Settings<svg class="i chev"><use href="#chev"/></svg></a>
</nav>
</aside>
<header class="topbar">
<svg class="burger"><use href="#burger"/></svg>
<div class="user"><div class="avatar">MP</div>Maxime Pasquier ▾</div>
</header>
<main>
<section class="panel">
<div class="panel-title">
<h2><!--PLATFORM--><small>Explore</small></h2>
<span class="tools"><svg class="i"><use href="#wrench"/></svg> ▾</span>
</div>
<div class="period"><span id="period"></span><b>Apply</b></div>
<nav class="tabs">
<button type="button" data-pane="time_series">Time Series</button>
<button type="button" data-pane="advanced">Advanced</button>
<button type="button" data-pane="diagnosis" class="active">Diagnosis</button>
</nav>
<div class="pane" id="time_series"></div>
<div class="pane" id="advanced"></div>
<div class="pane active" id="diagnosis">
<div class="toolbar">Color <span id="columns"></span><span class="meta" id="instant"></span></div>
<div id="image"></div>
<div id="grid"></div>
<div id="details"></div>
</div>
</section>
</main>
<script>
const D = /*DATA*/null;
const day = t => `${+t.slice(8, 10)}/${+t.slice(5, 7)}/${t.slice(0, 4)}`;
document.getElementById("period").textContent = `${day(D.times[0])} → ${day(D.times[D.times.length - 1])}`;
// Onglets : un seul volet visible ; Plotly recalcule la taille des graphiques du volet qui s'affiche.
for (const b of document.querySelectorAll(".tabs button")) b.addEventListener("click", () => {
document.querySelectorAll(".tabs button, .pane").forEach(e => e.classList.remove("active"));
b.classList.add("active");
const pane = document.getElementById(b.dataset.pane);
pane.classList.add("active");
pane.querySelectorAll(".js-plotly-plot").forEach(p => Plotly.Plots.resize(p));
});
// Time Series et Advanced : les captures de la plateforme, telles quelles (décor, spec « La page »).
for (const [tab, srcs] of Object.entries(D.captures)) {
const pane = document.getElementById(tab);
if (!srcs.length) pane.innerHTML = '<p class="empty">No capture of this page.</p>';
for (const src of srcs) pane.insertAdjacentHTML("beforeend", `<img src="${src}" alt="">`);
}
</script>
</body>
</html>
```
- [ ] **Step 4 : lancer le script et vérifier la sortie d'erreur**
Run :
```bash
python3 vues-deplacements/maquette/explore.py
E=$(mktemp -d) && .venv/bin/python vues-deplacements/maquette/explore.py "$E"; echo "exit $?"; rmdir "$E"
```
Expected : la première commande affiche `/home/maxime/Support-Agent/out/vues_deplacements_NORDEND.html` et ouvre la page ; la seconde affiche `Pas d'export « advanced » dans /tmp/…` puis `exit 1`, sans trace Python.
- [ ] **Step 5 : vérifier la syntaxe du JS de la page**
Run :
```bash
.venv/bin/python -c "import re; s = open('out/vues_deplacements_NORDEND.html').read(); open('out/check_explore.js', 'w').write(re.findall(r'<script>(.*?)</script>', s, re.S)[-1])" && node --check out/check_explore.js && echo syntax-ok
```
Expected : `syntax-ok`.
- [ ] **Step 6 : capturer les deux onglets décor et regarder les captures**
Le premier onglet affiché est `Diagnosis` (vide à ce stade) ; pour voir le décor, capturer la page et vérifier l'habillage, puis contrôler que les captures existent dans `out/` (URL relatives) :
```bash
U=$(wslpath -w out/vues_deplacements_NORDEND.html | sed 's|\\|/|g; s|^//|file://|')
timeout 90 "/mnt/c/Program Files/Google/Chrome/Application/chrome.exe" --headless=new --disable-gpu --window-size=1600,900 --virtual-time-budget=10000 --screenshot="$(wslpath -w out)\\check_task1.png" "$U" 2>/dev/null
ls out/../vues-deplacements/cas/2026-10_NORDEND/plateforme/01_* out/../vues-deplacements/cas/2026-10_NORDEND/plateforme/05_*
```
Puis Read `out/check_task1.png`. Expected : barre latérale « AIMsight monitoring », en-tête « Carrière TROYDO (B) Explore », période « 5/10/2026 → 16/10/2026 », trois onglets, `Diagnosis` actif. Les deux `ls` trouvent leur fichier.
- [ ] **Step 7 : documenter le rangement et la commande**
Dans `vues-deplacements/CLAUDE.md`, remplacer :
```
Le code et les maquettes du chantier viendront ici aussi ; leur rangement se décide au premier besoin.
```
par :
```
Le code et les maquettes du chantier vivent dans `maquette/` (D-053) : `explore.py` (maquette de la page Explore avec l'onglet Diagnosis, `python3 vues-deplacements/maquette/explore.py [dossier de station]`, page dans `out/`), son gabarit `explore_template.html` et sa spec `spec.md`.
```
Dans `CLAUDE.md`, section « Commandes », après la ligne `python3 maquettes/support/home.py [début] [fin] # maquette support : out/maquette_support_home.html`, ajouter :
```
python3 vues-deplacements/maquette/explore.py [dossier] # maquette Explore + onglet Diagnosis (D-053) : out/vues_deplacements_<STATION>.html (défaut : cas NORDEND)
```
Dans `CLAUDE.md`, « Carte du dépôt », remplacer la fin de la ligne `vues-deplacements/` :
```
sa carte : `vues-deplacements/CLAUDE.md`.
```
par :
```
sa carte : `vues-deplacements/CLAUDE.md` ; maquette de la page Explore avec l'onglet Diagnosis dans `vues-deplacements/maquette/` (D-053).
```
- [ ] **Step 8 : commit**
```bash
git add vues-deplacements/maquette/explore.py vues-deplacements/maquette/explore_template.html vues-deplacements/CLAUDE.md CLAUDE.md
git commit -m "Add the Explore mockup script and page with its two platform tabs (D-053)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>"
```
---
### Task 2 : l'onglet Diagnosis, image et grille reliées
**Files :**
- Modify : `vues-deplacements/maquette/explore_template.html`
**Interfaces :**
- Consumes : le JSON `D` de la tâche 1 (`times`, `sensors[*].x|y|values|dev`, `images`, `view`) ; les éléments `#columns`, `#instant`, `#image`, `#grid`.
- Produces (pour la tâche 3) : constantes et fonctions JS globales `S`, `NAMES`, `COLUMNS`, `CONFIG`, `ASKED` (URLSearchParams du `#` de l'adresse), `col` (grandeur, let), `T` (index dans `D.times`, let), `tLine()` (shape du trait de T), `utc(t)`, `drawGrid()`, `drawImage()` (promesses Plotly), `setT(j)`, `markColumn()`. Les trois lignes que la tâche 3 modifie sont citées telles quelles dans ses étapes : ne pas les reformuler.
- [ ] **Step 1 : ajouter le style de la barre d'outils**
Dans `explore_template.html`, remplacer :
```
.empty { padding: 30px 0; color: var(--muted); }
</style>
```
par :
```
.empty { padding: 30px 0; color: var(--muted); }
/* Onglet Diagnosis (spec §1 à §3). */
.toolbar { display: flex; align-items: center; gap: 8px; margin-bottom: 8px; color: var(--text); font-size: 14px; }
.toolbar button { border: 1px solid var(--line); background: #fff; border-radius: 4px; padding: 4px 10px;
font: inherit; cursor: pointer; }
.toolbar button.active { background: var(--blue); border-color: var(--blue); color: #fff; }
.toolbar .meta { margin-left: auto; color: var(--muted); }
</style>
```
- [ ] **Step 2 : ajouter le JS de l'image et de la grille**
Dans `explore_template.html`, remplacer :
```
</script>
</body>
```
par :
```
// Onglet Diagnosis (spec §1 à §3) : image à l'instant T et grille capteurs × temps, reliées.
const S = D.sensors, NAMES = S.map(s => s.name);
const COLUMNS = ["corr_x", "corr_y", "error_value"]; // grandeurs de la grille (spec §2)
const CAP = 10; // plafond de l'échelle de couleur, ±10 pas : choix d'affichage, pas un seuil (spec §2)
const TOL = 10 * 60e3; // image la plus proche de T, à 10 min près (spec §1)
const SCALE = "RdBu"; // divergente : négatif en rouge, positif en bleu, blanc au niveau des 24 premières heures
const GAP = "#c8c8c8"; // case sans valeur, ligne sans niveau (spec §2)
const CONFIG = { responsive: true, scrollZoom: true, displaylogo: false };
const ASKED = new URLSearchParams(location.hash.slice(1)); // état de départ lu dans l'adresse (spec §3)
let col = COLUMNS.includes(ASKED.get("col")) ? ASKED.get("col") : "corr_y";
let T = D.times.includes(ASKED.get("t")) ? D.times.indexOf(ASKED.get("t")) : D.times.length - 1;
let W = 0, H = 0; // taille des images de la caméra, lue sur la première
const utc = t => t.replace("T", " ").replace("Z", " UTC");
const tLine = () => ({ type: "line", xref: "x", yref: "paper", x0: D.times[T], x1: D.times[T], y0: 0, y1: 1,
line: { color: "#111", width: 1.5 } });
function nearestImage() {
const t = Date.parse(D.times[T]);
let best = null, gap = Infinity;
for (const im of D.images) {
const g = Math.abs(Date.parse(im.t) - t);
if (g < gap) { gap = g; best = im; }
}
return gap <= TOL ? best : null;
}
function drawGrid() {
return Plotly.react("grid", [{
type: "heatmap", x: D.times, y: NAMES, z: S.map(s => s.dev[col]), customdata: S.map(s => s.values[col]),
zmin: -CAP, zmax: CAP, colorscale: SCALE, hoverongaps: false, colorbar: { title: { text: "steps" }, thickness: 12 },
hovertemplate: `%{y} · %{x|%d %b %H:%M} UTC<br>${col} %{customdata:.4g} · %{z:.1f} steps<extra></extra>`,
}], {
height: 80 + 18 * S.length, margin: { l: 60, r: 10, t: 10, b: 40 }, plot_bgcolor: GAP, uirevision: "grid",
xaxis: { type: "date" }, yaxis: { autorange: "reversed", fixedrange: true, dtick: 1 }, shapes: [tLine()],
}, CONFIG);
}
function drawImage() {
const im = nearestImage();
const seen = S.map((s, i) => i).filter(i => S[i].x[T] !== null && S[i].y[T] !== null);
const markers = (ids, marker) => ({
type: "scatter", mode: "markers+text", x: ids.map(i => S[i].x[T]), y: ids.map(i => S[i].y[T]),
text: ids.map(i => NAMES[i]), customdata: ids, textposition: "top center", textfont: { color: "#fff", size: 11 },
marker: { size: 13, line: { color: "#fff", width: 1 }, ...marker }, hovertemplate: "%{text}<extra></extra>",
showlegend: false,
});
const valued = seen.filter(i => S[i].dev[col][T] !== null), blank = seen.filter(i => S[i].dev[col][T] === null);
const v = D.view || { x: [0, W || 1], y: [0, H || 1] };
return Plotly.react("image", [
markers(valued, { color: valued.map(i => S[i].dev[col][T]), cmin: -CAP, cmax: CAP, colorscale: SCALE }),
markers(blank, { color: GAP }),
], {
height: 520, margin: { l: 10, r: 10, t: 34, b: 10 }, plot_bgcolor: "#000", uirevision: "image",
title: { text: im ? `Image ${utc(im.t)}` : "", font: { size: 13 } },
xaxis: { range: v.x, showgrid: false, zeroline: false, showticklabels: false },
yaxis: { range: [v.y[1], v.y[0]], showgrid: false, zeroline: false, showticklabels: false, scaleanchor: "x" },
images: im && W ? [{ source: im.src, xref: "x", yref: "y", x: 0, y: 0, sizex: W, sizey: H,
xanchor: "left", yanchor: "top", sizing: "stretch", layer: "below" }] : [],
annotations: im ? [] : [{ text: "No image at this time", xref: "paper", yref: "paper", x: 0.5, y: 0.5,
showarrow: false, font: { color: "#fff", size: 15 } }],
}, CONFIG);
}
function setT(j) {
T = j;
document.getElementById("instant").textContent = `T = ${utc(D.times[T])}`;
Plotly.relayout("grid", { shapes: [tLine()] });
drawImage();
}
const columns = document.getElementById("columns");
columns.innerHTML = COLUMNS.map(c => `<button type="button" data-col="${c}">${c}</button>`).join("");
const markColumn = () => columns.querySelectorAll("button").forEach(b => b.classList.toggle("active", b.dataset.col === col));
columns.addEventListener("click", ev => {
if (!ev.target.dataset.col) return;
col = ev.target.dataset.col;
markColumn();
drawGrid();
drawImage();
});
markColumn();
document.getElementById("instant").textContent = `T = ${utc(D.times[T])}`;
Promise.all([drawGrid(), drawImage()]).then(() => {
document.getElementById("grid").on("plotly_click", ev => setT(ev.points[0].pointNumber[1]));
});
if (D.images.length) { // la taille de l'image, lue sur la première, place la photo sous les marqueurs
const probe = new Image();
probe.onload = () => { W = probe.naturalWidth; H = probe.naturalHeight; drawImage(); };
probe.src = D.images[0].src;
}
</script>
</body>
```
- [ ] **Step 3 : régénérer la page et vérifier la syntaxe**
Run :
```bash
python3 vues-deplacements/maquette/explore.py
.venv/bin/python -c "import re; s = open('out/vues_deplacements_NORDEND.html').read(); open('out/check_explore.js', 'w').write(re.findall(r'<script>(.*?)</script>', s, re.S)[-1])" && node --check out/check_explore.js && echo syntax-ok
```
Expected : le chemin de la page, puis `syntax-ok`.
- [ ] **Step 4 : capturer quatre états et les regarder**
Run :
```bash
U=$(wslpath -w out/vues_deplacements_NORDEND.html | sed 's|\\|/|g; s|^//|file://|')
C="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
timeout 90 "$C" --headless=new --disable-gpu --window-size=1600,1300 --virtual-time-budget=15000 --screenshot="$(wslpath -w out)\\check_default.png" "$U" 2>/dev/null
timeout 90 "$C" --headless=new --disable-gpu --window-size=1600,1300 --virtual-time-budget=15000 --screenshot="$(wslpath -w out)\\check_0230.png" "$U#t=2026-10-08T02:30Z" 2>/dev/null
timeout 90 "$C" --headless=new --disable-gpu --window-size=1600,1300 --virtual-time-budget=15000 --screenshot="$(wslpath -w out)\\check_noimage.png" "$U#t=2026-10-05T22:00Z" 2>/dev/null
timeout 90 "$C" --headless=new --disable-gpu --window-size=1600,1300 --virtual-time-budget=15000 --screenshot="$(wslpath -w out)\\check_error.png" "$U#col=error_value" 2>/dev/null
```
Puis Read chacune des quatre captures `out/check_*.png`. Expected :
- `check_default.png` : bouton `corr_y` actif, « T = 2026-10-16 05:15 UTC » ; photo zoomée sur les réflecteurs, un marqueur nommé sur chacun ; grille de 22 lignes (CTR02 en haut), la ligne PR17 nettement colorée à partir du 08/10, les autres pâles ; trait vertical au bout de la grille.
- `check_0230.png` : titre « Image 2026-10-08 02:30 UTC », trait de T le 08/10 ; marqueur PR17 coloré fort.
- `check_noimage.png` : « No image at this time », marqueurs gardés sur fond noir.
- `check_error.png` : bouton `error_value` actif ; colonnes colorées pour de nombreux capteurs le 09/10 et le 14/10.
Si la photo est décalée par rapport aux marqueurs (axe y), corriger l'ancrage de `images` dans `drawImage()` (`y: 0`, `yanchor: "top"` avec l'axe inversé) et recapturer `check_0230.png`.
- [ ] **Step 5 : contrôle des clics par l'utilisateur**
Les captures ne cliquent pas. Demander à l'utilisateur, dans la page ouverte par l'étape 3 : cliquer une case de PR17 le 08/10 vers 02:30 (T change, l'image suit, trait vertical déplacé), puis changer de grandeur (la grille et les marqueurs changent, le zoom de l'image est gardé). Noter sa réponse ; corriger avant de commiter si un clic ne marche pas.
- [ ] **Step 6 : commit**
```bash
git add vues-deplacements/maquette/explore_template.html
git commit -m "Add the Diagnosis tab: camera image at T and sensor-by-time grid, linked (D-053)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>"
```
---
### Task 3 : le détail d'un capteur
**Files :**
- Modify : `vues-deplacements/maquette/explore_template.html`
- Modify : `vues-deplacements/maquette/explore.py`
- Modify : `CLAUDE.md` (état et prochaine étape)
**Interfaces :**
- Consumes : de la tâche 2, `S`, `NAMES`, `CONFIG`, `ASKED`, `col`, `tLine()`, `drawGrid()`, `drawImage()`, `setT(j)` ; `AUTOSCALE_Y_JS` de `src/common/page.py` (texte JS contenant `'{plot_id}'`, à remplacer par `plotId`, comme `maquettes/user/summary.py`).
- Produces : `opened` (index des capteurs dépliés), `detailFigure(i) -> [data, layout]`, `drawDetail(i)`, `openDetail(i)`, `autoscale(plotId)`.
- [ ] **Step 1 : injecter le recalage de l'ordonnée dans la page**
Dans `explore.py`, remplacer :
```python
from common.page import open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
```
par :
```python
from common.page import AUTOSCALE_Y_JS, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
```
et remplacer :
```python
text = text.replace("/*DATA*/null", json.dumps(data).replace("</", "<\\/"))
```
par :
```python
text = text.replace("/*DATA*/null", json.dumps(data).replace("</", "<\\/"))
text = text.replace("/*AUTOSCALE*/", AUTOSCALE_Y_JS.replace("'{plot_id}'", "plotId")) # ordonnée recalée (D-013)
```
- [ ] **Step 2 : ajouter le style du détail**
Dans `explore_template.html`, remplacer :
```
.toolbar .meta { margin-left: auto; color: var(--muted); }
</style>
```
par :
```
.toolbar .meta { margin-left: auto; color: var(--muted); }
/* Détail d'un capteur (spec §4). */
.detail { border: 1px solid var(--line); border-radius: 4px; margin-top: 10px; }
.detail header { display: flex; justify-content: space-between; align-items: center; padding: 6px 12px;
border-bottom: 1px solid var(--line); color: var(--text); font-size: 15px; }
.detail header button { border: 0; background: none; color: var(--muted); font-size: 20px; cursor: pointer; }
</style>
```
- [ ] **Step 3 : ajouter les fonctions du détail**
Dans `explore_template.html`, remplacer :
```
markColumn();
document.getElementById("instant").textContent = `T = ${utc(D.times[T])}`;
```
par :
```
// Détail d'un capteur (spec §4, version 0) : la grandeur de la grille, puis error_value et son seuil ; T marqué.
const opened = []; // index des capteurs dépliés, dans l'ordre d'ouverture
function autoscale(plotId) {
/*AUTOSCALE*/
}
function detailFigure(i) {
const s = S[i], ends = [D.times[0], D.times[D.times.length - 1]];
return [[
{ type: "scatter", mode: "lines", x: D.times, y: s.values[col], name: col, line: { color: "#2a78d6", width: 1.5 } },
{ type: "scatter", mode: "lines", x: D.times, y: s.values.error_value, name: "error_value", yaxis: "y2",
line: { color: "#d03b3b", width: 1.5 } },
{ type: "scatter", mode: "lines", x: ends, y: [s.threshold, s.threshold], name: "error_threshold", yaxis: "y2",
line: { color: "#d03b3b", width: 1, dash: "dash" }, hoverinfo: "skip" },
], {
height: 380, margin: { l: 60, r: 10, t: 30, b: 40 }, legend: { orientation: "h", x: 0, y: 1.12 },
xaxis: { type: "date", anchor: "y2" },
yaxis: { domain: [0.55, 1], fixedrange: true, title: { text: col } },
yaxis2: { domain: [0, 0.45], fixedrange: true, title: { text: "error_value" } },
shapes: [tLine()],
}];
}
function drawDetail(i) {
const id = `detail-plot-${i}`;
Plotly.purge(id);
Plotly.newPlot(id, ...detailFigure(i), CONFIG).then(() => autoscale(id));
}
function openDetail(i) {
if (opened.includes(i)) return;
opened.push(i);
const box = document.createElement("div");
box.className = "detail";
box.innerHTML = `<header><b></b><button type="button" title="Close">×</button></header><div id="detail-plot-${i}"></div>`;
box.querySelector("b").textContent = `${NAMES[i]} · ${S[i].kind}`;
box.querySelector("button").addEventListener("click", () => {
Plotly.purge(`detail-plot-${i}`);
box.remove();
opened.splice(opened.indexOf(i), 1);
});
document.getElementById("details").append(box);
drawDetail(i);
}
markColumn();
document.getElementById("instant").textContent = `T = ${utc(D.times[T])}`;
```
- [ ] **Step 4 : relier le détail à T, à la grandeur et aux clics**
Dans `explore_template.html`, remplacer :
```
Plotly.relayout("grid", { shapes: [tLine()] });
drawImage();
}
```
par :
```
Plotly.relayout("grid", { shapes: [tLine()] });
drawImage();
opened.forEach(i => Plotly.relayout(`detail-plot-${i}`, { shapes: [tLine()] }));
}
```
Remplacer :
```
drawGrid();
drawImage();
});
```
par :
```
drawGrid();
drawImage();
opened.forEach(i => drawDetail(i));
});
```
Remplacer :
```
document.getElementById("grid").on("plotly_click", ev => setT(ev.points[0].pointNumber[1]));
```
par :
```
document.getElementById("grid").on("plotly_click", ev => { // une case : T devient son instant, son capteur se déplie
const [i, j] = ev.points[0].pointNumber;
setT(j);
openDetail(i);
});
document.getElementById("image").on("plotly_click", ev => openDetail(ev.points[0].customdata)); // un marqueur
for (const name of (ASKED.get("open") || "").split(",")) if (NAMES.includes(name)) openDetail(NAMES.indexOf(name));
```
- [ ] **Step 5 : régénérer la page et vérifier la syntaxe**
Run :
```bash
python3 vues-deplacements/maquette/explore.py
.venv/bin/python -c "import re; s = open('out/vues_deplacements_NORDEND.html').read(); open('out/check_explore.js', 'w').write(re.findall(r'<script>(.*?)</script>', s, re.S)[-1])" && node --check out/check_explore.js && echo syntax-ok
grep -c "AUTOSCALE" out/vues_deplacements_NORDEND.html
```
Expected : le chemin de la page, `syntax-ok`, puis `0` (le repère `/*AUTOSCALE*/` a été remplacé par le script).
- [ ] **Step 6 : capturer les détails et les regarder**
Run :
```bash
U=$(wslpath -w out/vues_deplacements_NORDEND.html | sed 's|\\|/|g; s|^//|file://|')
C="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
timeout 90 "$C" --headless=new --disable-gpu --window-size=1600,2400 --virtual-time-budget=15000 --screenshot="$(wslpath -w out)\\check_detail.png" "$U#t=2026-10-08T02:30Z&open=PR17,PR18,PR17" 2>/dev/null
timeout 90 "$C" --headless=new --disable-gpu --window-size=1600,2000 --virtual-time-budget=15000 --screenshot="$(wslpath -w out)\\check_detail_error.png" "$U#col=error_value&open=PR17" 2>/dev/null
```
Puis Read `out/check_detail.png` et `out/check_detail_error.png`. Expected :
- `check_detail.png` : deux blocs seulement, « PR17 · target » puis « PR18 · target » (PR17 demandée deux fois) ; dans PR17, la courbe `corr_y` forme un palier du 08/10 au 12/10, `error_value` sous son seuil pointillé à 0,4 ; trait de T le 08/10 dans les deux blocs.
- `check_detail_error.png` : bouton `error_value` actif ; le bloc PR17 a `error_value` dans ses deux graphiques, le seuil à 0,4 en bas.
- [ ] **Step 7 : contrôle des clics par l'utilisateur**
Demander à l'utilisateur, dans la page ouverte : cliquer une case de PR17 (son détail se déplie, T change), cliquer un marqueur de l'image (son détail se déplie, T ne change pas), cliquer encore PR17 (pas de second bloc), changer de grandeur (les détails suivent), zoomer dans le temps dans un détail (l'ordonnée se recale), fermer un bloc (×). Corriger avant de commiter si un geste ne marche pas.
- [ ] **Step 8 : mettre à jour l'état du projet**
Dans `CLAUDE.md`, section « État et prochaine étape », remplacer :
```
- **Prochaine étape** : **déplacements (D-052)** : l'utilisateur (l'expert) apporte dans `vues-deplacements/` un nouveau cas réel avec les pages de la plateforme qu'il a consultées ; on en tire, pas à pas, des vues lisibles pour le client et l'expert, puis l'agent dans une maquette ;
```
par :
```
- **Prochaine étape** : **déplacements (D-052, D-053)** : maquette de la page Explore avec l'onglet Diagnosis (`vues-deplacements/maquette/`, cas NORDEND : image à l'instant T et grille capteurs × temps reliées, détail minimal) ; la remplir pas à pas avec l'utilisateur (l'expert), d'abord le détail d'un capteur, puis l'agent dans la page ;
```
- [ ] **Step 9 : commit**
```bash
git add vues-deplacements/maquette/explore_template.html vues-deplacements/maquette/explore.py CLAUDE.md
git commit -m "Add the sensor detail to the Diagnosis tab (D-053)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>"
```
+10 -5
View File
@@ -30,16 +30,21 @@ De haut en bas.
- 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.
- 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.
- Limite connue : un palier long (PR17, presque la moitié de la fenêtre) gonfle la MAD de son capteur et ressort moins fort.
- 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)
@@ -51,7 +56,7 @@ De haut en bas.
- `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 ;
- 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.
@@ -62,7 +67,7 @@ De haut en bas.
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 ;
- 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 ;