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 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-12 16:23:37 +02:00
1 parent fc74fec10f
commit 8452973912
9 files changed
+366 -19

No files matched your search

+2
View File
@@ -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/<STATION>_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`)
+1
View File
@@ -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
+1
View File
@@ -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.
+1
View File
@@ -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.
+21
View File
@@ -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/<STATION>_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/<STATION>_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.
+1
View File
@@ -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 ;
+64
View File
@@ -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)
+256
View File
@@ -0,0 +1,256 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>AIMsight Energy</title>
<script src="https://cdn.plot.ly/plotly-4.1.1.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/marked@12.0.2/marked.min.js"></script>
<style>
/* Maquette côté client : page System Summary + section Diagnostic (D-020 à D-023). Données injectées par energy.py. */
:root {
--sidebar: #2a3f54; --topbar: #ededed; --page: #f7f7f7; --panel-border: #e6e9ed;
--muted: #73879c; --text: #333; --line: #dee2e6;
--green: #008300; --orange: #eda100; --red: #d03b3b; --unknown: #8c8c8c;
}
* { 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; }
/* Ajout : section Diagnostic, une ligne repliable par diagnostic (ici : énergie). */
.diag { margin: 22px 22px 0; }
.diag > h3 { margin: 0 0 8px; font-size: 12px; font-weight: bold; letter-spacing: .4px; text-transform: uppercase; }
.diag-item { border: 1px solid var(--line); border-radius: 4px; }
.diag-item > summary { list-style: none; cursor: pointer; display: flex; align-items: center; gap: 14px;
padding: 10px 14px; color: var(--text); font-size: 15px; }
.diag-item > summary::-webkit-details-marker { display: none; }
.status { padding: 2px 12px; border-radius: 999px; font-size: 13px; font-weight: bold; color: #fff; }
.status.GREEN { background: var(--green); } .status.ORANGE { background: var(--orange); color: #1a1a1a; }
.status.RED { background: var(--red); } .status.UNKNOWN { background: var(--unknown); }
.meta { color: var(--muted); font-size: 13px; }
.diag-item > summary .chev { margin-left: auto; width: 13px; height: 13px; transition: transform .15s; }
.diag-item[open] > summary .chev { transform: rotate(180deg); }
.diag-body { border-top: 1px solid var(--line); padding: 14px; }
.headline { margin: 0 0 12px; color: var(--text); font-size: 15px; }
.days { border-collapse: collapse; color: var(--text); }
.days th, .days td { padding: 5px 28px 5px 0; text-align: left; font-weight: normal; vertical-align: top; }
.days th { color: var(--muted); }
/* Échelle de batterie : Off < 10 %, Low < 30 %, OK < 90 %, Full ; le trait marque le niveau de ce matin. */
.gauge { position: relative; display: flex; width: 320px; font-size: 10px; color: var(--muted); }
.gauge span { border-top: 10px solid; padding-top: 2px; text-align: center; }
.gauge span:nth-child(1) { border-color: #f1c0c0; } .gauge span:nth-child(2) { border-color: #f8dca8; }
.gauge span:nth-child(3) { border-color: #e4ebdc; } .gauge span:nth-child(4) { border-color: #bfe0bf; }
.gauge i { position: absolute; top: -3px; height: 16px; width: 3px; margin-left: -1.5px; background: var(--text); border-radius: 2px; }
.gauge-text { margin-top: 6px; }
/* Guide : partie 1 du manuel, rendue depuis le Markdown. */
.guide { max-width: 900px; margin-top: 6px; color: var(--text); }
.guide h3 { margin: 12px 0 6px; font-size: 16px; } .guide h4 { margin: 14px 0 6px; font-size: 14px; }
.guide h5 { margin: 10px 0 4px; font-size: 13px; }
.guide p, .guide ul { margin: 6px 0; }
.guide table { border-collapse: collapse; margin: 6px 0 10px; }
.guide th, .guide td { border: 1px solid var(--line); padding: 4px 8px; text-align: left; vertical-align: top; }
.guide th { background: #f5f7fa; }
.sub { margin-top: 12px; }
.action { display: flex; align-items: center; gap: 12px; margin-top: 12px; }
.action[hidden] { display: none; }
.action button { background: #2a78d6; color: #fff; border: 0; border-radius: 4px; padding: 7px 12px;
font: inherit; font-size: 14px; cursor: pointer; }
.sub > summary { cursor: pointer; color: var(--muted); }
#daily { margin-top: 10px; }
.collapse { margin: 22px 22px 0; border-top: 1px solid var(--line); border-bottom: 1px solid var(--line);
padding: 9px 0; display: flex; justify-content: space-between; color: var(--text); font-size: 15px; }
.collapse svg { width: 13px; height: 13px; }
#chart { margin: 10px 6px 0; height: 420px; }
.btn { margin: 18px 22px 0; display: inline-block; background: #6c757d; color: #fff; border-radius: 4px;
padding: 8px 13px; font-size: 15px; }
.metrics { margin: 0 22px; width: calc(100% - 44px); border-collapse: collapse; font-size: 15px; }
.metrics td { border: 1px solid var(--line); padding: 9px 8px; color: #212529; }
.metrics td:first-child { font-weight: bold; width: 39%; }
.metrics td:last-child { font-style: italic; }
</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>VERMONT<small>System Summary</small></h2>
<span class="tools"><svg class="i"><use href="#wrench"/></svg> ▾</span>
</div>
<section class="diag">
<h3>Diagnostic</h3>
<details class="diag-item" id="energy">
<summary>
<b>Energy</b>
<span class="status" id="status"></span>
<span class="meta" id="meta"></span>
<svg class="i chev"><use href="#chev"/></svg>
</summary>
<div class="diag-body">
<p class="headline" id="headline"></p>
<table class="days" id="today"></table>
<div class="action" id="action" hidden>
<button type="button" id="save-mode">Activate energy save mode</button>
<span class="meta" id="save-note">The station sleeps between measurements to use less energy.</span>
</div>
<details class="sub" id="history">
<summary>Full history</summary>
<div id="daily"></div>
</details>
<details class="sub" id="guide">
<summary>Guide</summary>
<div class="guide" id="guide-body"></div>
</details>
</div>
</details>
</section>
<div class="collapse">BusVoltage <svg><use href="#chev"/></svg></div>
<div id="chart"></div>
<div class="btn">Download CSV</div>
<table class="metrics" id="table"></table>
</section>
</main>
<script>
const DATA = /*DATA*/null;
const DAILY = /*DAILY*/null; // figure des analyses 03 et 04 (D-021), telle que le site la reçoit
const R = DATA.rule, E = DATA.energy, cur = E.cur || {};
const NAME = { GREEN: "Green", ORANGE: "Orange", RED: "Red" };
const ACTION = { GREEN: "Nothing to do", ORANGE: "Watch", RED: "Contact support" };
// Une phrase de très haut niveau, sans détail (manuel, partie 1, § 2).
const HEADLINE = {
GREEN: "The station is receiving enough energy.",
ORANGE: "The station's energy supply is uncertain.",
RED: "The station is not receiving enough energy.",
};
const TREND = { BETTER: "↗ Better than the day before", STABLE: "→ Same as the day before", WORSE: "↘ Worse than the day before" };
// Échelle de batterie : niveau de fin de nuit (le meilleur repère du niveau, docs/domaine/comment-se-comporte-la-batterie.md),
// placé en % par la table OCV LiFePO4 du collecteur (src/__main__ (3).py, LIFEPO4_OCV_SOC).
// ponytail: sans compensation IR (la nuit, ~0,14 V sous la tension à vide) : repère un peu bas ; compenser avec BusCurrent si besoin.
const OCV = [[10.0, 0], [12.0, 10], [12.5, 20], [12.8, 30], [12.9, 40], [13.0, 50], [13.1, 60], [13.2, 70], [13.3, 80],
[13.4, 90], [13.6, 100]];
const soc = x => {
for (let i = 1; i < OCV.length; i++) {
const [v0, p0] = OCV[i - 1], [v1, p1] = OCV[i];
if (x <= v1) return Math.max(0, p0 + (p1 - p0) * (x - v0) / (v1 - v0));
}
return 100;
};
// Zones, aux points de la table : 10 % = 12,0 V (la station s'éteint dessous), 30 % = coude 12,8 V, 90 % = 13,4 V.
// Pas de % affiché : sur le plateau (30-90 %), 0,1 V vaut ~10 % de charge, la tension n'en dit pas plus.
const ZONES = [[10, "Off", "nearly empty, the station may shut down"], [30, "Low", "low (under 30 %)"],
[90, "OK", "between 30 and 90 %"], [100, "Full", "full"]];
const recharge = d => d.max_v == null ? "" : d.max_v >= R.full_charge_v ? "fully recharged today"
: d.rise_v >= R.min_rise_v ? "partially recharged today" : "not recharged today";
function gauge(d) {
if (d.night_end_v == null) return "Unknown";
const pct = soc(d.night_end_v), zone = ZONES.find(z => pct < z[0]) || ZONES[ZONES.length - 1];
const text = `This morning: ${zone[2]} · ${recharge(d)}`;
return `<div class="gauge" role="img" aria-label="${text}" title="night end ${d.night_end_v.toFixed(3)} V">` +
ZONES.map(([hi, name], i) => `<span style="width:${hi - (i ? ZONES[i - 1][0] : 0)}%">${name}</span>`).join("") +
`<i style="left:${pct}%"></i></div><div class="gauge-text">${text}</div>`;
}
const chip = c => `<span class="status ${c || "UNKNOWN"}">${NAME[c] || "Unknown"}</span>`;
// Bloc Energy : la couleur du jour, l'échelle de batterie et la tendance face à la veille.
document.getElementById("status").outerHTML = chip(cur.color);
document.getElementById("meta").textContent = `${E.label} · ${ACTION[cur.color] || "Check data"}`;
document.getElementById("headline").textContent = HEADLINE[cur.color] || "Not enough data to assess the station's energy.";
document.getElementById("today").innerHTML = [["Battery", gauge(cur)], ["Trend", TREND[cur.trend] || "Unknown"]]
.map(([k, x]) => `<tr><th>${k}</th><td>${x}</td></tr>`).join("");
document.getElementById("guide-body").innerHTML = marked.parse(DATA.guide); // texte du projet, pas une saisie
// Remède proposé au client quand l'énergie manque : veille profonde entre les mesures
// (docs/domaine/comment-se-comporte-la-batterie.md). Action de la plateforme, pas du diagnostic (lecture seule).
// Maquette : le bouton n'envoie rien.
document.getElementById("action").hidden = !["ORANGE", "RED"].includes(cur.color);
document.getElementById("save-mode").onclick = () =>
document.getElementById("save-note").textContent = "Mockup: no command is sent to the station.";
// L'historique complet n'est tracé qu'à la première ouverture (un graphique caché n'a pas de largeur).
document.getElementById("history").addEventListener("toggle", e => {
if (!e.target.open || e.target.dataset.drawn) return;
e.target.dataset.drawn = "1";
Plotly.newPlot("daily", DAILY.data, DAILY.layout, { responsive: true, scrollZoom: true }).then(() => {
/*AUTOSCALE*/
});
});
document.getElementById("table").innerHTML =
DATA.table.map(([k, x]) => `<tr><td>${k}</td><td>${x}</td></tr>`).join("");
const lo = DATA.daily.map(p => p.lo), hi = DATA.daily.map(p => p.hi);
const extremes = (pts, name, fill, line, pos) => ({
x: pts.map(p => p[0]), y: pts.map(p => p[1]), name, mode: "markers+text", type: "scatter",
text: pts.map(p => p[1].toFixed(3)), textposition: pos, textfont: { size: 11, color: "#2a3f54" },
marker: { size: 8, color: fill, line: { color: line, width: 1.5 } }, hoverinfo: "x+y",
});
Plotly.newPlot("chart", [
{ x: DATA.hours.map(h => h[0]), y: DATA.hours.map(h => h[1]), name: "Battery Voltage", mode: "lines",
type: "scatter", line: { color: "#636efa", width: 2 }, connectgaps: false },
extremes(lo, "lowest daily value", "#a9b0fb", "#636efa", "bottom center"),
extremes(hi, "highest daily value", "#1bb38a", "#0b6e55", "top center"),
], {
margin: { l: 70, r: 10, t: 10, b: 40 }, paper_bgcolor: "#fff", plot_bgcolor: "#e5ecf6",
font: { family: "Helvetica Neue, Roboto, Arial, sans-serif", size: 12, color: "#2a3f54" },
xaxis: { type: "date", range: DATA.range, gridcolor: "#fff" },
yaxis: { gridcolor: "#fff", zeroline: false },
legend: { x: 1.02, y: 1, yanchor: "top" },
}, { displayModeBar: false, responsive: true });
</script>
</body>
</html>
+19 -19
View File
@@ -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<extra></extra>",
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<extra></extra>",
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}<br>" + "<br>".join(f"{k}={val}" for k, val in p["facts"].items())
hover = [f"{p['t']:%Y-%m-%d}: {label}<br>" + "<br>".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']})<br>"
hover = [f"{p['t']:%Y-%m-%d}: {label} (decided by {p['facts']['decided_by']})<br>"
f"{p['facts']['state_prev']} → {p['facts']['state']}<br>"
+ "<br>".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}<extra></extra>",
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