diff --git a/docs/decisions.md b/docs/decisions.md index 71c0aa1..47feffd 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -588,9 +588,9 @@ Règles du journal : - **Statut** : active. - **Décision** : - première vue du chantier D-052 : une maquette HTML de la page Explore de la plateforme, avec ses deux onglets (`Time Series`, `Advanced`) et un troisième, `Diagnosis`, un ensemble de visualisations pour le diagnostic côté support (l'expert), peut-être côté client plus tard ; - - entrée par une vue d'ensemble, d'où l'on déplie les capteurs qui intéressent : l'image de la caméra à un instant T, chaque capteur marqué à sa position, et une grille capteurs × temps colorée par l'écart au niveau habituel (médiane, MAD, comme l'outil `resume.py` de l'agent), reliées ; le détail d'un capteur commence minimal et se remplit pas à pas avec l'utilisateur ; + - entrée par une vue d'ensemble, d'où l'on déplie les capteurs qui intéressent : l'image de la caméra à un instant T, chaque capteur marqué à sa position, et une grille capteurs × temps colorée par l'écart au niveau des 24 premières heures de la fenêtre, mesuré en variation d'un pas à l'autre (le critère du rapport PR17 de l'agent), reliées ; le détail d'un capteur commence minimal et se remplit pas à pas avec l'utilisateur ; - les deux onglets existants sont un décor : les captures de la plateforme, telles quelles ; - construction : un script Python et un gabarit HTML (plotly.js), comme `maquettes/` ; code et spec dans `vues-deplacements/maquette/` (spec : `spec.md`). - **Pourquoi** : demande de l'utilisateur ; une anomalie se lit en deux questions, où (l'image : dépôt sur la vitre, traînée sur CTR03 et PR18) et quand, local ou commun (la grille : une ligne ou une colonne) ; l'utilisateur ne sait pas encore ce que doit montrer le détail et préfère avancer doucement. -- **Options écartées** : entrer par une cible choisie, ou par le rapport de l'agent (« un peu des trois », mais la vue d'ensemble d'abord) ; redessiner les deux onglets existants depuis les exports (plus de code pour un décor, et sans le panneau Camera movement, absent des exports) ; figures construites en Python (la liaison image ↔ grille demande de toute façon du JS) ; fichier autonome aux images embarquées (985 images, basse résolution, réflecteurs illisibles). +- **Options écartées** : entrer par une cible choisie, ou par le rapport de l'agent (« un peu des trois », mais la vue d'ensemble d'abord) ; colorer la grille par l'écart à la médiane de toute la fenêtre (MAD, comme `resume.py`) : le palier de PR17, plus de la moitié de la fenêtre, déplace la médiane, et la ligne s'allume avant le saut au lieu de pendant ; par l'écart aux 24 h glissantes : seuls les sauts s'allument, pas le palier ; redessiner les deux onglets existants depuis les exports (plus de code pour un décor, et sans le panneau Camera movement, absent des exports) ; figures construites en Python (la liaison image ↔ grille demande de toute façon du JS) ; fichier autonome aux images embarquées (985 images, basse résolution, réflecteurs illisibles). - **Conséquence** : la page ne marche que sur le poste (images référencées dans `vues-deplacements/cas/`) ; elle sert de cadre aux étapes suivantes : détail d'un capteur, agent dans la page. diff --git a/docs/superpowers/plans/2026-10-16-maquette-explore-diagnosis.md b/docs/superpowers/plans/2026-10-16-maquette-explore-diagnosis.md new file mode 100644 index 0000000..d2413ed --- /dev/null +++ b/docs/superpowers/plans/2026-10-16-maquette-explore-diagnosis.md @@ -0,0 +1,769 @@ +# Maquette Explore avec l'onglet Diagnosis : plan d'implémentation + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal :** une maquette HTML de la page Explore de la plateforme (Carrière TROYDO (B), cas NORDEND), avec ses deux onglets en décor et un troisième, `Diagnosis` : image de la caméra à l'instant T et grille capteurs × temps reliées, détail d'un capteur minimal. + +**Architecture :** un script Python (`explore.py`, bibliothèque standard) lit l'export « advanced » avec l'outil `donnees.py` de l'agent, calcule l'écart de chaque mesure et injecte un JSON dans un gabarit HTML (`explore_template.html`) ; la page dessine tout en plotly.js, avec un peu de JS pour la liaison. Même schéma que `maquettes/user/summary.py`. + +**Tech Stack :** Python 3 (bibliothèque standard), plotly.js 4.1.1 par CDN, Chrome headless (Windows, depuis WSL) pour les captures de vérification, `node --check` pour la syntaxe JS. + +**Spec :** `vues-deplacements/maquette/spec.md` (D-053). La lire avant chaque tâche. + +## Global Constraints + +- Python : bibliothèque standard seulement ; ni pandas ni nouvelle dépendance. Les scripts du dépôt importent `src/common/page.py`, qui relance le script sous `.venv/bin/python` si plotly manque : lancer les vérifications Python avec `.venv/bin/python`. +- plotly.js : ``, 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 " +``` diff --git a/vues-deplacements/maquette/spec.md b/vues-deplacements/maquette/spec.md index 2b1513f..53e7b92 100644 --- a/vues-deplacements/maquette/spec.md +++ b/vues-deplacements/maquette/spec.md @@ -30,16 +30,21 @@ De haut en bas. - Une ligne par capteur : références `global_ref` (par nom), puis la *local reference* (`ref`), puis les cibles (par nom). Une colonne par instant de mesure de l'export « advanced » (15 min), à la minute. - Trois boutons de grandeur : `corr_x`, `corr_y`, `error_value` (défaut : `corr_y`). -- Couleur = écart au niveau habituel du capteur : `(valeur − médiane) / MAD`, médiane et MAD (écart absolu médian, non mis à l'échelle) calculées sur toute la fenêtre, valeurs vides exclues, comme `agents/diagnostic/outils/resume.py`. Échelle divergente symétrique, plafonnée à ±5 : un choix d'affichage, pas un seuil de verdict. -- Case sans valeur (mesure rejetée, donc `corr_x` / `corr_y` vides, ou mesure absente) : grise, sans distinguer les deux en version 0. MAD nulle : ligne grise. +- Couleur = écart au niveau du début de la fenêtre, en variation d'un pas à l'autre : `(valeur − niveau) / pas`, par capteur et par grandeur, valeurs vides exclues : + - `niveau` : médiane des valeurs des 24 premières heures de la fenêtre (instants avant le premier instant de mesure + 24 h) ; + - `pas` : médiane des écarts absolus entre deux valeurs successives, sur toute la fenêtre (le critère du rapport PR17 de l'agent, qu'un palier ne gonfle pas) ; + - échelle divergente symétrique, plafonnée à ±10 : un choix d'affichage, pas un seuil de verdict. +- Case sans valeur (mesure rejetée, donc `corr_x` / `corr_y` vides, ou mesure absente) : grise, sans distinguer les deux en version 0. Aucune valeur dans les 24 premières heures, ou `pas` nul : ligne grise. - Survol : capteur, instant UTC, valeur brute et écart. -- Limite connue : un palier long (PR17, presque la moitié de la fenêtre) gonfle la MAD de son capteur et ressort moins fort. +- Vérifié sur NORDEND (`corr_y`, écart médian) : PR17 à 1,7 avant le saut, 23,6 sur le palier, 13,5 après le retour partiel ; PR16, PR18, CTR02 et CTR03 entre 1,6 et 4,1. Écartée : la médiane et la MAD de toute la fenêtre (comme `resume.py`), car le palier de PR17, plus de la moitié de la fenêtre, déplace la médiane : la ligne s'allumait avant le saut (2,3), pas pendant (1,1). +- Limite connue : si les 24 premières heures sont anormales, toute la ligne s'allume ; une dérive lente ou un changement de régime (le tilt à partir du 08/10) s'allume aussi. ### 3. Liaison - Clic sur une case : T devient l'instant de sa colonne (un trait vertical le marque dans la grille et dans les détails ouverts ; l'image et ses marqueurs passent à T), et le détail du capteur de sa ligne se déplie sous la grille. - Clic sur un marqueur de l'image : le détail de ce capteur se déplie, T ne change pas. - T de départ : le dernier instant de mesure. +- L'état de départ peut se lire dans l'adresse : `#t=2026-10-08T02:30Z&col=error_value&open=PR17,PR18` (instant T, grandeur, détails dépliés ; une valeur inconnue est ignorée). Sert à la vérification par capture et à partager une vue. ### 4. Détail d'un capteur (version 0) @@ -51,7 +56,7 @@ De haut en bas. - `vues-deplacements/maquette/explore.py [dossier de station]` (défaut `vues-deplacements/cas/2026-10_NORDEND/NORDEND/`) : - lit l'export « advanced » avec `agents/diagnostic/outils/donnees.py` (`charger`, `trouver`, `heure_image`), sans le copier ; - - calcule médiane et MAD par capteur et par grandeur, la position médiane de chaque capteur, la liste des images avec leur heure ; + - calcule l'écart de chaque mesure (niveau des 24 premières heures, pas d'une mesure à l'autre), la position médiane de chaque capteur, la liste des images avec leur heure ; - injecte un JSON dans `explore_template.html` et écrit `out/vues_deplacements_.html` (`` : nom du dossier), puis l'ouvre (`src/common/page.py`, `open_html`). - `vues-deplacements/maquette/explore_template.html` : habillage, onglets, plotly.js 4.1.1 par CDN (comme les maquettes existantes), JS de la liaison. - Images et captures référencées par chemin relatif depuis `out/`, sans copie : la page ne marche que sur ce poste, assez pour une maquette. @@ -62,7 +67,7 @@ De haut en bas. Pas de tests automatisés (D-008). Lancer `python3 vues-deplacements/maquette/explore.py`, ouvrir la page et contrôler : -- la ligne de PR17 en `corr_y` allumée du 08/10 02:30 au 12/10 23:00, ses voisines et les références non ; +- la ligne de PR17 en `corr_y` allumée à partir du 08/10 02:30, saturée jusqu'au 12/10 23:00, encore nette ensuite (retour partiel), ses voisines et les références pâles ; - des colonnes allumées pour de nombreux capteurs le 09/10 et le 14/10 en `error_value` ; - clic sur le 08/10 02:30 : l'image de 02:30 avec le disque sous PR17, les marqueurs sur les réflecteurs ; - clic sur PR17 : son détail, avec le palier et le seuil 0,4 ;