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

41 KiB
Raw Blame History

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

"""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 :

.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
<!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 :

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 :

.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) :

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
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 :

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 :

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
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 :

from common.page import open_html  # noqa: E402  (bascule seule sur .venv si plotly manque)

par :

from common.page import AUTOSCALE_Y_JS, open_html  # noqa: E402  (bascule seule sur .venv si plotly manque)

et remplacer :

    text = text.replace("/*DATA*/null", json.dumps(data).replace("</", "<\\/"))

par :

    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 :

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 :

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
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>"