# 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 : ``, 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 `. - 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 : `` (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_.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//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("", html.escape(data["platform"])) text = text.replace("/*DATA*/null", json.dumps(data).replace(" 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 <!--PLATFORM--> · Explore
MP
Maxime Pasquier ▾

Explore

▾
Apply
Color
``` - [ ] **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'', 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_.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 " ``` --- ### 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); } ``` 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); } ``` - [ ] **Step 2 : ajouter le JS de l'image et de la grille** Dans `explore_template.html`, remplacer : ``` ``` 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
${col} %{customdata:.4g} · %{z:.1f} steps`, }], { 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}", 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 => ``).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; } ``` - [ ] **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'', 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 " ``` --- ### 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 : ``` .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; } ``` - [ ] **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 = `
`; 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'', 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 " ```