From 8452973912c3ccc127097c58e84d98544613a5aa Mon Sep 17 00:00:00 2001 From: maxime Date: Mon, 12 Oct 2026 16:23:37 +0200 Subject: [PATCH] Add the client Energy mockup and switch site texts to English D-022: page mockups are HTML built from real data, in maquettes/user/ (client) and maquettes/support/; Figma only on request. maquettes/user/energy.py renders the System Summary page with a Diagnostic section: an Energy box with the day's color, a one-line headline, a battery scale (zones from the collector's LiFePO4 OCV table, no percentage shown), the trend against the day before, an "Activate energy save mode" button on orange and red days (mockup only, sends nothing), and two collapsibles: the full history (D-021 figure) and the guide (part 1 of the manual, rendered from Markdown). D-023: everything meant for the monitoring site is in English, including the titles, legends, axes and hovers of the 03/04 panels. Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 2 + README.md | 1 + docs/analyses/analyse_03.md | 1 + docs/analyses/analyse_04.md | 1 + docs/decisions.md | 21 +++ docs/guide/diagnostic-energetique.md | 1 + maquettes/user/energy.py | 64 +++++++ maquettes/user/energy_template.html | 256 +++++++++++++++++++++++++++ src/energy_plot.py | 38 ++-- 9 files changed, 366 insertions(+), 19 deletions(-) create mode 100644 maquettes/user/energy.py create mode 100644 maquettes/user/energy_template.html diff --git a/CLAUDE.md b/CLAUDE.md index 61577f8..13a9a1d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -37,6 +37,7 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana - `python3 src/analyse_02.py` : point d'entrée de l'analyse 02 ; il lance la même page. - `python3 src/analyse_03.py` : point d'entrée de l'analyse 03 ; il lance la même page. - `python3 src/analyse_04.py` : point d'entrée de l'analyse 04 ; il lance la même page. +- `python3 maquettes/user/energy.py [début] [fin]` : maquette client « Energy » (page System Summary, section Diagnostic, D-022), écrite dans `out/maquette_user_energy.html` et ouverte. - `python3 src/energy_check.py data/` : résumé texte + `out/_energy.json` (`out/` est ignoré par git). - `.venv/bin/python src/energy_plot.py data/` : graphique seul (plotly.js est chargé depuis le CDN). @@ -73,6 +74,7 @@ Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-ana - `src/analyse_NN.py` : point d'entrée de chaque analyse. Code partagé : `src/energy_check.py` (analyses 01 et 02, bibliothèque standard uniquement, embarquable), `src/battery_state.py` (analyse 03, idem), `src/battery_trend.py` (analyse 04, idem), `src/day_color.py` (matrice 03 × 04, couleur du jour, idem) et `src/energy_plot.py` (plotly, poste de dev). - `src/__main__ (3).py` : copie de référence du collecteur `system_info` embarqué (INA219, table OCV LiFePO4, compensation IR 0,34 Ω). Source des unités. Ne pas modifier. - `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande. +- `maquettes/` : maquettes de page en HTML, sur données réelles (D-022), en deux blocs : `user/` (client) et `support/`. Un script par design, ou directement le HTML. Figma seulement sur demande. ## Principes (raisons, statuts et options écartées : `docs/decisions.md`) diff --git a/README.md b/README.md index c68f2e8..7a35456 100644 --- a/README.md +++ b/README.md @@ -30,6 +30,7 @@ Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer c | Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` | | Documentation AIMsight d'origine | `doc/` | | Données de travail (VERMONT) et diagnostics experts | `data/` | +| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/energy.py` | `maquettes/` | ## État diff --git a/docs/analyses/analyse_03.md b/docs/analyses/analyse_03.md index 54f73bd..3de40be 100644 --- a/docs/analyses/analyse_03.md +++ b/docs/analyses/analyse_03.md @@ -115,3 +115,4 @@ Sortie (contrat commun) : un point par jour. - **2026-10-12** : implémentée (`src/battery_state.py`, panneau dans `energy_plot.py`, point d'entrée `analyse_03.py`). Résultats conformes à l'essai de conception. - **2026-10-12** : corrigée après la relecture finale. La fin de nuit et la montée étaient calées sur le premier maximum du jour, qui peut être la tension de 00:00 (queue de la soirée précédente). Conséquences : le 2026-05-05 était lu `NO_CHARGE` malgré une montée de +0,079 V, la fin de nuit affichée du 2026-09-30 était fausse (12,68 V au lieu de 12,19 V), et le 2026-09-26, évalué en cours de journée, restait UNKNOWN de 04:00 à 11:00 malgré des mesures sous 12,8 V. Désormais, la montée part d'un minimum antérieur, et le coude se teste sur le minimum du jour (`min_v`). - **2026-10-12** : sur le graphique, chaque point est placé à midi UTC de son jour, et non plus à 23:00, comme les barres de l'analyse 04 (D-019). Le calcul ne change pas. +- **2026-10-12** : titres, légendes et survols du graphique en anglais, pour le site de monitoring (D-023). Le calcul ne change pas. diff --git a/docs/analyses/analyse_04.md b/docs/analyses/analyse_04.md index f247d4f..aee9796 100644 --- a/docs/analyses/analyse_04.md +++ b/docs/analyses/analyse_04.md @@ -93,3 +93,4 @@ Sur 184 jours (du 2026-04-09 au 2026-10-09) : - **2026-10-12** : conçue en brainstorming. L'utilisateur a choisi trois réponses plus l'inconnu, l'état d'abord puis la fin de nuit, et un panneau en barres. Spec écrite dans cette fiche (D-010). - **2026-10-12** : implémentée (`src/battery_trend.py`, panneau dans `energy_plot.py`, point d'entrée `analyse_04.py`). Résultats conformes à l'essai de conception, à un UNKNOWN près (le premier jour, sans veille). Couleur de « mieux » : bleu au lieu de vert (skill dataviz). - **2026-10-12** : sur le graphique, chaque barre est centrée sur midi UTC de son jour, et non plus sur 23:00 : à 23:00, elle débordait sur le lendemain (le 12/04 a été lu « 13 avril »). Le calcul ne change pas : le décalage d'un jour de la fin de nuit a été essayé, puis écarté (D-019, limite 6). +- **2026-10-12** : titres, légendes et survols du graphique en anglais, pour le site de monitoring (D-023). Le calcul ne change pas. diff --git a/docs/decisions.md b/docs/decisions.md index 5766e47..6e38195 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -206,3 +206,24 @@ Règles du journal : - le calcul des analyses 03 et 04 (`battery_state.py`, `battery_trend.py`) n'importe plus rien des analyses 01 et 02 : il se livre seul ; - le format d'intégration côté site (JSON, fragment HTML ou backend Python) reste à choisir avec l'équipe du site. +## D-022 — 2026-10-12 — Maquettes de page en HTML ; Figma seulement sur demande +- **Statut** : active. +- **Décision** : les maquettes de page (ex. « System Summary » du site de monitoring) sont des pages HTML générées à partir des données réelles, dans `maquettes/`. Un fichier Figma n'est produit que sur demande (designer, passation à l'équipe du site), à partir d'une maquette stable. +- **Pourquoi** : choix de l'utilisateur, sur recommandation. Le HTML s'itère plus vite (rendu et vérification en local), garde les données réelles et vivantes (calcul par `src/`), permet l'interaction (survol traçable, zoom), utilise la technologie du livrable (HTML Plotly) et se versionne. +- **Options écartées** : Figma comme référence. Chaque modification y passe par l'API Plugin, et le graphique n'y est qu'une image vectorielle figée, sans survol ni zoom. Un premier fichier, produit puis non maintenu, reste dans les brouillons Figma de l'utilisateur : https://www.figma.com/design/S16eZ7PoAAutFJWcyqAHSm. +- **Conséquence** : + - les maquettes sont rangées en deux blocs : `maquettes/user/` (côté client) et `maquettes/support/` (côté support AIMsight). Chaque design a son script, ou directement son HTML s'il n'a pas besoin de données ; + - `python3 maquettes/user/energy.py [début] [fin]` écrit `out/maquette_user_energy.html` (ignoré par git, comme les autres pages générées) et l'ouvre. Il calcule lui-même la figure de D-021 (plotly, bascule seule sur `.venv`) ; + - la maquette « Energy » place en haut de la page System Summary une section « Diagnostic », un rectangle repliable par notification (ici Energy, avec Green, Orange ou Red pour le dernier jour de la fenêtre). Déplié : une phrase de très haut niveau, puis une échelle de batterie (niveau de ce matin, la fin de nuit, placé par la table OCV du collecteur dans des zones Off < 10 %, Low < 30 %, OK < 90 %, Full ; pas de % affiché, car sur le plateau la tension en dit peu ; la tension reste au survol), la tendance face à la veille en mots simples (better / same / worse), et deux dérouleurs : l'historique complet (figure de D-021) et « Guide », la partie 1 du manuel (lecture rapide, pour le client) rendue depuis le Markdown à chaque génération (marked.js). La partie 2, pour le support, ira côté support ; + - les jours Orange et Red, un bouton « Activate energy save mode » propose le remède attendu (veille profonde entre les mesures, `docs/domaine/comment-se-comporte-la-batterie.md`). C'est une action de la plateforme, déclenchée par le client : le diagnostic reste en lecture seule. Dans la maquette, le bouton n'envoie rien ; + - un tableau des faits de J−1 et de J, côte à côte, puis le jour J avec ses variations chiffrées, ont été essayés, puis remplacés par l'échelle et la tendance : une tension ne dit rien à un non-spécialiste, et il n'a pas besoin de savoir que la tendance vient de la fin de nuit ; + - une première version, avec une bande d'une case par jour au-dessus de `BusVoltage` (option écartée par D-021), a été remplacée. + +## D-023 — 2026-10-12 — Site de monitoring en anglais, figure des analyses 03 et 04 comprise +- **Statut** : active. Complète D-021 et D-022. +- **Décision** : tout ce qui est destiné au site de monitoring est en anglais : la maquette System Summary et la figure des analyses 03 et 04 (`out/_daily.json`), avec ses titres, légendes, axes et survols. +- **Pourquoi** : demande de l'utilisateur. Le site AIMsight est en anglais. +- **Conséquence** : + - les panneaux 03 et 04 étant partagés (D-021), ils sont aussi en anglais sur la page des analyses (`out/_energy.html`), dont le reste (analyses 01 et 02, séries) reste en français ; + - le code, ses commentaires, les fiches et le manuel restent en français (convention du projet). Les identifiants (`FULL_CHARGE`, `DAILY_BATTERY_STATE`…) ne changent pas. + diff --git a/docs/guide/diagnostic-energetique.md b/docs/guide/diagnostic-energetique.md index 230ee35..2fc5083 100644 --- a/docs/guide/diagnostic-energetique.md +++ b/docs/guide/diagnostic-energetique.md @@ -154,6 +154,7 @@ Commande : `python3 src/analyse_03.py`. Elle écrit deux pages dans `out/` et le **Attention aux couleurs** : celles des panneaux ne sont pas celles de la matrice. Elles distinguent les états et les tendances ; elles ne disent pas le niveau de préoccupation. Par exemple, `BELOW_PLATEAU` y est en bleu. +- **Langue** : les titres, légendes et survols des panneaux 03 et 04 sont en anglais, comme le site (D-023). Par exemple, le maximum du jour est `daily maximum`, la fin de nuit `night end`, et les tendances `better`, `stable` et `worse`. - **Les panneaux 01 et 02** (moyennes sur 7 jours), en haut de la page, ne font pas partie de ce diagnostic : les ignorer. - **Panneau `DAILY_BATTERY_STATE`** (analyse 03), un point par jour, placé à midi UTC : - courbe foncée : le maximum du jour ; courbe claire : la fin de nuit ; diff --git a/maquettes/user/energy.py b/maquettes/user/energy.py new file mode 100644 index 0000000..8fd929f --- /dev/null +++ b/maquettes/user/energy.py @@ -0,0 +1,64 @@ +"""Maquette côté client « Energy » : page System Summary du site de monitoring, avec une section Diagnostic (D-020 à D-023). + +Données réelles VERMONT. Bloc Energy : couleur du dernier jour de la fenêtre, échelle de batterie et tendance face à la veille +(src/day_color.py), puis historique complet (energy_plot.daily_figure, D-021) et guide (partie 1 du manuel), repliés. +Écrit out/maquette_user_energy.html et l'ouvre dans le navigateur. +Usage : python3 maquettes/user/energy.py [AAAA-MM-JJ début] [AAAA-MM-JJ fin] (défaut : 2026-09-18 à 2026-09-28) +""" +import json +import re +import sys +from datetime import date, datetime, time, timedelta, timezone +from pathlib import Path + +HERE = Path(__file__).resolve().parent +ROOT = HERE.parent.parent +sys.path.insert(0, str(ROOT / "src")) +from analyse_01 import open_html # noqa: E402 (bascule seule sur .venv si plotly manque) +import battery_state as bs # noqa: E402 +import battery_trend as bt # noqa: E402 +import day_color as dc # noqa: E402 +import energy_check as ec # noqa: E402 +import energy_plot as ep # noqa: E402 + +START = date.fromisoformat(sys.argv[1]) if len(sys.argv) > 1 else date(2026, 9, 18) +END = date.fromisoformat(sys.argv[2]) if len(sys.argv) > 2 else date(2026, 9, 28) + +series = ec.load_stations([str(ROOT / "data")])["VERMONT"] +v = series["BusVoltage"] +in_window = lambda t: START <= t.date() <= END # noqa: E731 + +hours = [[t.isoformat(), v[t]] for t in sorted(v) if in_window(t)] +daily = {} +for t, x in hours: + if x is not None: + d = daily.setdefault(t[:10], {"lo": [t, x], "hi": [t, x]}) + d["lo"] = min(d["lo"], [t, x], key=lambda p: p[1]) + d["hi"] = max(d["hi"], [t, x], key=lambda p: p[1]) + +end = datetime.combine(END, time(23), timezone.utc) +table = [] +for metric in sorted(series): + last = [x for t, x in series[metric].items() if t <= end and x is not None] + table.append([metric, f"{last[-1]:.2f} [unknown]" if last else "—"]) + +facts = {p["t"].date(): p["facts"] for p in dc.run(series)["points"]} +# Guide : partie 1 du manuel (lecture rapide, pour le client), relue à chaque génération ; titres décalés de deux niveaux. +manual = (ROOT / "docs" / "guide" / "diagnostic-energetique.md").read_text() +part1 = manual[manual.index("# Partie 1"):manual.index("# Partie 2")].split("\n", 1)[1] # sans son titre +guide = re.sub(r"^#", "###", part1.rstrip().removesuffix("---"), flags=re.M) +data = {"hours": hours, "daily": list(daily.values()), "table": table, "guide": guide, + "range": [START.isoformat(), (END + timedelta(days=1)).isoformat()], + "energy": {"cur": facts.get(END), "label": END.strftime("%a %d %b %Y")}, + "rule": {"full_charge_v": bs.FULL_CHARGE_V, "plateau_floor_v": bs.PLATEAU_FLOOR_V, "min_rise_v": bs.MIN_RISE_V, + "deadband_v": bt.NIGHT_END_DEADBAND_V}} +html = (HERE / "energy_template.html").read_text() +for key, value in (("/*DATA*/null", json.dumps(data)), + ("/*DAILY*/null", ep.daily_figure("VERMONT", series).to_json()), + ("/*AUTOSCALE*/", ep.AUTOSCALE_Y_JS.replace("{plot_id}", "daily"))): + html = html.replace(key, value) +out = ROOT / "out" / "maquette_user_energy.html" +out.parent.mkdir(exist_ok=True) +out.write_text(html) +print(out) +open_html(out) diff --git a/maquettes/user/energy_template.html b/maquettes/user/energy_template.html new file mode 100644 index 0000000..266faf9 --- /dev/null +++ b/maquettes/user/energy_template.html @@ -0,0 +1,256 @@ + + + + + +AIMsight Energy + + + + + + + + + + + + + + + + +
+ +
MP
Maxime Pasquier ▾
+
+ +
+
+
+

VERMONTSystem Summary

+ ▾ +
+ +
+

Diagnostic

+
+ + Energy + + + + +
+

+
+ +
+ Full history +
+
+
+ Guide +
+
+
+
+
+ +
BusVoltage
+
+ +
Download CSV
+
+
+
+ + + + diff --git a/src/energy_plot.py b/src/energy_plot.py index d4600d3..f6b2d16 100644 --- a/src/energy_plot.py +++ b/src/energy_plot.py @@ -61,11 +61,11 @@ ZONES = [ # États de DAILY_BATTERY_STATE : couleurs validées par le skill dataviz (toutes paires, fond blanc). # Le jaune contraste peu avec le fond : chaque état a aussi son symbole, sa légende et son survol. STATE_STYLE = { - "FULL_CHARGE": ("pleine charge", "#008300", "circle"), - "PARTIAL_CHARGE": ("charge partielle (incertain)", "#eda100", "diamond"), - "BELOW_PLATEAU": ("sous le plateau", "#2a78d6", "triangle-down"), - "NO_CHARGE": ("aucune charge", "#4a3aa7", "x"), - None: ("état inconnu", "#8c8c8c", "circle-open"), + "FULL_CHARGE": ("full charge", "#008300", "circle"), + "PARTIAL_CHARGE": ("partial charge (uncertain)", "#eda100", "diamond"), + "BELOW_PLATEAU": ("below plateau", "#2a78d6", "triangle-down"), + "NO_CHARGE": ("no charge", "#4a3aa7", "x"), + None: ("unknown state", "#8c8c8c", "circle-open"), } @@ -76,24 +76,24 @@ def noon(day): def daily_state_panel(fig, result, row): """Panneau DAILY_BATTERY_STATE : maximum et fin de nuit par jour, seuils, état en marqueurs (fiche analyse_03).""" - group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}") + group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analysis {result['analysis']}") rule, pts = result["rule"], result["points"] x = [noon(p["t"].date()) for p in pts] - fig.add_scatter(x=x, y=[p["facts"].get("max_v") for p in pts], name="maximum du jour", mode="lines", + fig.add_scatter(x=x, y=[p["facts"].get("max_v") for p in pts], name="daily maximum", mode="lines", line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group) - fig.add_scatter(x=x, y=[p["facts"].get("night_end_v") for p in pts], name="fin de nuit", mode="lines", - line=dict(color="#9a9893", width=1.5), hovertemplate="fin de nuit %{y:.2f} V", + fig.add_scatter(x=x, y=[p["facts"].get("night_end_v") for p in pts], name="night end", mode="lines", + line=dict(color="#9a9893", width=1.5), hovertemplate="night end %{y:.2f} V", row=row, col=1, **group) # Seuils tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013). - for v, name, state in ((rule["full_charge_v"], "pleine charge", "FULL_CHARGE"), - (rule["plateau_floor_v"], "bas du plateau", "BELOW_PLATEAU")): + for v, name, state in ((rule["full_charge_v"], "full charge", "FULL_CHARGE"), + (rule["plateau_floor_v"], "plateau floor", "BELOW_PLATEAU")): fig.add_scatter(x=x, y=[v] * len(x), name=f"{name} {v} V", mode="lines", hoverinfo="skip", line=dict(color=STATE_STYLE[state][1], dash="dash", width=1), row=row, col=1, **group) for state, (label, color, symbol) in STATE_STYLE.items(): sel = [p for p in pts if p["facts"]["state"] == state and p["facts"].get("max_v") is not None] if not sel: continue - hover = [f"{p['t']:%Y-%m-%d} : {label}
" + "
".join(f"{k}={val}" for k, val in p["facts"].items()) + hover = [f"{p['t']:%Y-%m-%d}: {label}
" + "
".join(f"{k}={val}" for k, val in p["facts"].items()) for p in sel] fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"]["max_v"] for p in sel], name=label, mode="markers", @@ -104,40 +104,40 @@ def daily_state_panel(fig, result, row): # Tendances de DAILY_BATTERY_TREND : paire divergente bleu/rouge et gris neutre du skill dataviz # (vert/rouge refusé par son validateur : deutéranopie, ΔE 5,9). Chaque tendance a aussi sa légende et son survol. -TREND_STYLE = {"BETTER": ("mieux", "#2a78d6"), "STABLE": ("stable", "#8c8c8c"), "WORSE": ("pire", "#d03b3b")} +TREND_STYLE = {"BETTER": ("better", "#2a78d6"), "STABLE": ("stable", "#8c8c8c"), "WORSE": ("worse", "#d03b3b")} def daily_trend_panel(fig, result, row): """Panneau DAILY_BATTERY_TREND : écart de fin de nuit J − J−1 en barres, couleur = tendance (fiche analyse_04).""" - group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}") + group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analysis {result['analysis']}") pts, db = result["points"], result["rule"]["night_end_deadband_v"] x = [noon(p["t"].date()) for p in pts] # Zone morte tracée comme une courbe (un point par jour, None entre +db et −db) : visible au zoom (D-013). - fig.add_scatter(x=x + [None] + x, y=[db] * len(x) + [None] + [-db] * len(x), name=f"zone morte ±{db} V", + fig.add_scatter(x=x + [None] + x, y=[db] * len(x) + [None] + [-db] * len(x), name=f"dead band ±{db} V", mode="lines", hoverinfo="skip", line=dict(color="#52514e", dash="dash", width=1), row=row, col=1, **group) for trend, (label, color) in TREND_STYLE.items(): sel = [p for p in pts if p["facts"]["trend"] == trend and p["value"] is not None] if not sel: continue - hover = [f"{p['t']:%Y-%m-%d}: {label} (décidé par {p['facts']['decided_by']})
" + hover = [f"{p['t']:%Y-%m-%d}: {label} (decided by {p['facts']['decided_by']})
" f"{p['facts']['state_prev']} → {p['facts']['state']}
" + "
".join(f"{k}={v}" for k, v in p["facts"].items() if k.startswith("delta")) for p in sel] fig.add_bar(x=[noon(p["t"].date()) for p in sel], y=[p["value"] for p in sel], name=label, marker_color=color, width=0.8 * 86_400_000, hovertext=hover, hovertemplate="%{hovertext}", row=row, col=1, **group) - fig.update_yaxes(title_text="Δ fin de nuit [V]", row=row, col=1) + fig.update_yaxes(title_text="Δ night end [V]", row=row, col=1) def daily_figure(station, series): """Graphique pour le site de monitoring (D-021) : analyse 03 en haut, analyse 04 dessous, même axe du temps.""" fig = make_subplots(rows=2, cols=1, shared_xaxes=True, vertical_spacing=0.08, - subplot_titles=[f"Analyse {bs.RULE['id']}", f"Analyse {bt.RULE['id']}"]) + subplot_titles=[f"Analysis {bs.RULE['id']}", f"Analysis {bt.RULE['id']}"]) daily_state_panel(fig, bs.run(series), 1) daily_trend_panel(fig, bt.run(series), 2) fig.update_xaxes(showticklabels=True) fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS - fig.update_layout(title=f"{station} : état et tendance de la batterie", height=700, barmode="overlay", + fig.update_layout(title=f"{station}: battery state and trend", height=700, barmode="overlay", legend=dict(groupclick="toggleitem")) return fig