Files
Support-Agent/docs/superpowers/plans/2026-10-16-maquette-explore-diagnosis.md

770 lines
41 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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>"
```