Deliver Storage and Cellular in the mockups, with site figures and guides

The mockups now walk a list of domains (D-039): the support Home loads
every station in data/ and notifies each station x domain that is Orange
or Red; the client view becomes maquettes/user/summary.py, one System
Summary page per station with one block per measured domain. Storage
shows a free-space scale and the estimated full date; Cellular shows the
day's sends in words and a four-class signal scale.

HEADLINE moves into each day_color.py, with a Green sentence for the
client view. src/storage/final.py and src/cellular/final.py write the
site figures in English; the comparison pages reuse their panels. Each
domain gets a short two-layer guide in docs/<domaine>/guide/.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 16:05:26 +02:00
1 parent 28d441889f
commit f0990c16e6
22 files changed
+682 -246

No files matched your search

+30 -18
View File
@@ -1,9 +1,10 @@
"""Maquette côté support « Home » : page d'accueil du site de monitoring (toutes les stations), avec en haut une section
Status. Elle porte une notification par station dont le dernier jour de la fenêtre est Orange ou Red (src/energy/day_color.py, D-020).
Status. Elle porte une notification par station et par domaine dont le dernier jour de la fenêtre est Orange ou Red
(src/<domaine>/day_color.py : Energy, Storage, Cellular ; D-025, D-030).
La notification, comme la vignette de la station, mène à la vue client de la station (son menu principal) :
out/maquette_user_energy.html, écrite par maquettes/user/energy.py (à lancer avec les mêmes dates).
Données réelles : VERMONT seule (data/VERMONT/). Les autres stations, noms repris du site, n'ont pas de données dans la maquette.
out/maquette_user_<STATION>.html, écrite par maquettes/user/summary.py (à lancer avec les mêmes dates).
Données réelles : les stations de data/ (VERMONT, WEISSHORN, NORDEND). Les autres, noms repris du site, n'ont pas de données.
Écrit out/maquette_support_home.html et l'ouvre dans le navigateur.
Usage : python3 maquettes/support/home.py [AAAA-MM-JJ début] [AAAA-MM-JJ fin] (défaut : 2026-09-18 à 2026-09-28)
"""
@@ -16,7 +17,9 @@ ROOT = HERE.parent.parent
sys.path.insert(0, str(ROOT / "src"))
from common.page import open_html # noqa: E402
from common.stations import load_stations # noqa: E402
from energy import day_color as dc # noqa: E402
from cellular import day_color as cellular # noqa: E402
from energy import day_color as energy # noqa: E402
from storage import day_color as storage # 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)
@@ -27,12 +30,11 @@ STATIONS = ["ALLALINHORN", "BREITHORN", "CASTOR", "CLARIDEN", "DOM", "FINSTERAAR
"PIZBERNINA", "PIZBUIN", "POLLUX", "RINGELSPITZ", "VERMONT", "WEISSHORN", "ADULA", "ALASKA", "DAMMASTOCK",
"FAULHORN", "GRANDCOMBIN", "MARYLAND", "MONTANA", "NADELHORN", "PONT_TREMBLEX-01", "SNCF01", "WILDSTRUBEL",
"WYOMING"]
USER_VIEW = {"VERMONT": "maquette_user_energy.html"} # vue client de la station (maquettes/user/)
DOMAINS = {"Energy": energy, "Storage": storage, "Cellular": cellular} # contrat de notification (D-030)
NAME = {"RED": "Red", "ORANGE": "Orange"} # couleurs notifiées, la plus grave d'abord ; Green ne notifie rien
HEADLINE = {"RED": "The station is not receiving enough energy.", # mêmes phrases que la vue client
"ORANGE": "The station's energy supply is uncertain."}
series = load_stations([str(ROOT / "data" / "VERMONT")])
series = load_stations([str(d) for d in sorted((ROOT / "data").iterdir()) if d.is_dir()])
user_view = lambda name: f"maquette_user_{name}.html" if name in series else "#" # noqa: E731 (maquettes/user/)
def spark(v):
@@ -55,18 +57,28 @@ for name in STATIONS:
f'</div><svg></svg></div>')
continue
svg, last = spark(series[name]["BusVoltage"])
tiles.append(f'<a class="tile" href="{USER_VIEW.get(name, "#")}"><div class="tile-head">{name}<span>{last:.2f}[V]</span>'
tiles.append(f'<a class="tile" href="{user_view(name)}"><div class="tile-head">{name}<span>{last:.2f}[V]</span>'
f'</div>{svg}</a>')
def color_of(dc, station):
"""Couleur du dernier jour de la fenêtre pour un domaine ; None si la station n'a pas ses mesures."""
try:
points = dc.run(series[station])["points"]
except KeyError: # série du domaine absente (VERMONT n'a ni disque ni modem)
return None
return {p["t"].date(): p["facts"]["color"] for p in points}.get(END)
notes = []
for name in series:
color = {p["t"].date(): p["facts"]["color"] for p in dc.run(series[name])["points"]}.get(END)
if color in NAME:
notes.append((list(NAME).index(color), name,
f'<li><span class="status {color}">{NAME[color]}</span><b>{name}</b><span>Energy</span>'
f'<span class="meta">{END.strftime("%a %d %b %Y")}</span><span>{HEADLINE[color]}</span>'
f'<a href="{USER_VIEW.get(name, "#")}">Open {name} →</a></li>'))
status = "".join(n[2] for n in sorted(notes)) or '<li class="empty">No problem or point of attention.</li>'
for domain, dc in DOMAINS.items():
color = color_of(dc, name)
if color in NAME:
notes.append((list(NAME).index(color), name, domain,
f'<li><span class="status {color}">{NAME[color]}</span><b>{name}</b><span>{domain}</span>'
f'<span class="meta">{END.strftime("%a %d %b %Y")}</span><span>{dc.HEADLINE[color]}</span>'
f'<a href="{user_view(name)}">Open {name} →</a></li>'))
status = "".join(n[-1] for n in sorted(notes)) or '<li class="empty">No problem or point of attention.</li>'
html = (HERE / "home_template.html").read_text()
for key, value in (("<!--COUNT-->", f"{len(notes)} notification{'s' * (len(notes) != 1)}"),
@@ -76,6 +88,6 @@ out = ROOT / "out" / "maquette_support_home.html"
out.parent.mkdir(exist_ok=True)
out.write_text(html)
print(out)
if not (out.parent / USER_VIEW["VERMONT"]).exists():
print("Vue client absente : lancer python3 maquettes/user/energy.py avec les mêmes dates.")
if not all((out.parent / user_view(name)).exists() for name in series):
print("Vue client absente : lancer python3 maquettes/user/summary.py avec les mêmes dates.")
open_html(out)
-62
View File
@@ -1,62 +0,0 @@
"""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/energy/day_color.py), puis historique complet (energy.final.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 common.page import AUTOSCALE_Y_JS, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
from common.stations import load_stations # noqa: E402
from energy import battery_state as bs, battery_trend as bt, day_color as dc # noqa: E402
from energy.final import daily_figure # 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 = load_stations([str(ROOT / "data" / "VERMONT")])["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" / "energy" / "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", daily_figure("VERMONT", series).to_json()),
("/*AUTOSCALE*/", 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)
+91
View File
@@ -0,0 +1,91 @@
"""Maquette côté client « System Summary » : page d'une station sur le site de monitoring, avec une section Diagnostic
(D-020 à D-023, D-039). Un bloc par domaine dont la station a les mesures : Energy, Storage, Cellular.
Chaque bloc : couleur du dernier jour de la fenêtre et sa phrase (src/<domaine>/day_color.py), deux lignes en mots simples
(Energy : échelle de batterie et tendance ; Storage : échelle de l'espace libre et date de saturation ; Cellular : envois
du jour et échelle du signal), puis historique complet (src/<domaine>/final.py, D-021) et guide (partie 1), repliés.
Données réelles : une page par station de data/. Écrit out/maquette_user_<STATION>.html et les ouvre dans le navigateur.
Usage : python3 maquettes/user/summary.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 common.page import AUTOSCALE_Y_JS, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
from common.stations import load_stations # noqa: E402
from cellular import day_color as cellular, link_state as ls, signal_state as sgs # noqa: E402
from cellular.final import daily_figure as cellular_figure # noqa: E402
from energy import battery_state as bs, day_color as energy # noqa: E402
from energy.final import daily_figure as energy_figure # noqa: E402
from storage import day_color as storage, storage_state as sts # noqa: E402
from storage.final import daily_figure as storage_figure # 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)
# Un bloc par domaine, dans cet ordre : couleur du jour, figure du site, guide (partie 1 relue à chaque génération).
DOMAINS = {"energy": (energy, energy_figure, "docs/energy/guide/diagnostic-energetique.md"),
"storage": (storage, storage_figure, "docs/storage/guide/diagnostic-stockage.md"),
"cellular": (cellular, cellular_figure, "docs/cellular/guide/diagnostic-cellulaire.md")}
IDENTIFIERS = ("SIM_CCID", "ip") # préfixes des identifiants de la station : jamais affichés (CLAUDE.md, data/)
RULE = {"full_charge_v": bs.FULL_CHARGE_V, "min_rise_v": bs.MIN_RISE_V, "storage_floors": sts.FREE_PERCENT_FLOORS,
"expected_sends": ls.SAMPLES_PER_HOUR * ls.HOURS_PER_DAY, "signal_classes": sgs.CLASSES}
def guide(path):
"""Partie 1 d'un guide (lecture rapide, pour le client), sans son titre ; titres décalés de deux niveaux."""
manual = (ROOT / path).read_text()
part1 = manual[manual.index("# Partie 1"):manual.index("# Partie 2")].split("\n", 1)[1]
return re.sub(r"^#", "###", part1.rstrip().removesuffix("---"), flags=re.M)
def page(station, series):
"""Page System Summary d'une station -> chemin écrit."""
v = series["BusVoltage"]
hours = [[t.isoformat(), v[t]] for t in sorted(v) if START <= t.date() <= END]
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]
if metric.startswith(IDENTIFIERS) or any(isinstance(x, list) for x in last): # identifiants, métriques texte
continue
table.append([metric, f"{last[-1]:.2f} [unknown]" if last else "—"])
domains = {}
for key, (dc, figure, doc) in DOMAINS.items():
try:
facts = {p["t"].date(): p["facts"] for p in dc.run(series)["points"]}
except KeyError: # la station n'a pas les mesures du domaine (VERMONT : ni disque ni modem) : pas de bloc
continue
domains[key] = {"cur": facts.get(END), "headline": dc.HEADLINE, "guide": guide(doc),
"figure": json.loads(figure(station, series).to_json())}
data = {"station": station, "hours": hours, "daily": list(daily.values()), "table": table, "domains": domains,
"label": END.strftime("%a %d %b %Y"), "range": [START.isoformat(), (END + timedelta(days=1)).isoformat()],
"rule": RULE}
html = (HERE / "summary_template.html").read_text()
for key, value in (("<!--STATION-->", station), ("/*DATA*/null", json.dumps(data)),
("/*AUTOSCALE*/", AUTOSCALE_Y_JS.replace("'{plot_id}'", "plotId"))):
html = html.replace(key, value)
out = ROOT / "out" / f"maquette_user_{station}.html"
out.parent.mkdir(exist_ok=True)
out.write_text(html)
return out
for station, series in sorted(load_stations([str(d) for d in sorted((ROOT / "data").iterdir()) if d.is_dir()]).items()):
out = page(station, series)
print(out)
open_html(out)
@@ -3,11 +3,11 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>AIMsight Energy</title>
<title>AIMsight System Summary</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. */
/* Maquette côté client : page System Summary + section Diagnostic (D-020 à D-023, D-039). Données injectées par summary.py. */
:root {
--sidebar: #2a3f54; --topbar: #ededed; --page: #f7f7f7; --panel-border: #e6e9ed;
--muted: #73879c; --text: #333; --line: #dee2e6;
@@ -43,10 +43,11 @@
.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). */
/* Ajout : section Diagnostic, une ligne repliable par domaine (Energy, Storage, Cellular). */
.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 + .diag-item { margin-top: 8px; }
.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; }
@@ -61,11 +62,9 @@
.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. */
/* Échelle (batterie, espace libre, signal) : zones teintées, le trait marque la valeur du jour. */
.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 span { border-top: 10px solid; padding-top: 2px; text-align: center; white-space: nowrap; }
.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. */
@@ -82,7 +81,7 @@
.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; }
.plot { 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; }
@@ -125,37 +124,40 @@
<main>
<section class="panel">
<div class="panel-title">
<h2>VERMONT<small>System Summary</small></h2>
<h2><!--STATION--><small>System Summary</small></h2>
<span class="tools"><svg class="i"><use href="#wrench"/></svg> ▾</span>
</div>
<section class="diag">
<section class="diag" id="diag">
<h3>Diagnostic</h3>
<details class="diag-item" id="energy">
</section>
<!-- Un bloc par domaine, rempli par le script ci-dessous ; le bouton d'action ne sert qu'à Energy. -->
<template id="diag-item">
<details class="diag-item">
<summary>
<b>Energy</b>
<span class="status" id="status"></span>
<span class="meta" id="meta"></span>
<b class="name"></b>
<span class="status"></span>
<span class="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>
<p class="headline"></p>
<table class="days"></table>
<div class="action" hidden>
<button type="button">Activate energy save mode</button>
<span class="note meta">The station sleeps between measurements to use less energy.</span>
</div>
<details class="sub" id="history">
<details class="sub history">
<summary>Full history</summary>
<div id="daily"></div>
<div class="plot"></div>
</details>
<details class="sub" id="guide">
<details class="sub">
<summary>Guide</summary>
<div class="guide" id="guide-body"></div>
<div class="guide"></div>
</details>
</div>
</details>
</section>
</template>
<div class="collapse">BusVoltage <svg><use href="#chev"/></svg></div>
<div id="chart"></div>
@@ -167,20 +169,24 @@
<script>
const DATA = /*DATA*/null;
const DAILY = /*DAILY*/null; // figure de DAILY_BATTERY_STATE et DAILY_BATTERY_TREND (D-021), telle que le site la reçoit
const R = DATA.rule, E = DATA.energy, cur = E.cur || {};
const R = DATA.rule;
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.",
};
// Nom du bloc, et ce qu'il évalue (phrase d'un jour inconnu). Les phrases des couleurs viennent de src/<domaine>/day_color.py.
const DOMAIN = { energy: ["Energy", "energy"], storage: ["Storage", "storage space"], cellular: ["Cellular", "4G connection"] };
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/energy/domaine/comment-se-comporte-la-batterie.md),
// placé en % par la table OCV LiFePO4 du collecteur (docs/aimsight/collecteur_system_info.py, LIFEPO4_OCV_SOC).
// Échelle : zones [borne haute en %, nom, teinte, ...], trait à pct %, texte dessous ; le survol donne la valeur mesurée.
const TINT = { bad: "#f1c0c0", low: "#f8dca8", ok: "#e4ebdc", good: "#bfe0bf" };
const scale = (zones, pct, text, title = "") =>
`<div class="gauge" role="img" aria-label="${text}" title="${title}">` +
zones.map(([hi, name, tint], i) =>
`<span style="width:${hi - (i ? zones[i - 1][0] : 0)}%;border-color:${TINT[tint]}">${name}</span>`).join("") +
`<i style="left:${pct}%"></i></div><div class="gauge-text">${text}</div>`;
// Energy. Échelle de batterie : niveau de fin de nuit (le meilleur repère du niveau,
// docs/energy/domaine/comment-se-comporte-la-batterie.md), placé en % par la table OCV LiFePO4 du collecteur
// (docs/aimsight/collecteur_system_info.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]];
@@ -193,42 +199,88 @@ const soc = x => {
};
// 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 ZONES = [[10, "Off", "bad", "nearly empty, the station may shut down"], [30, "Low", "low", "low (under 30 %)"],
[90, "OK", "ok", "between 30 and 90 %"], [100, "Full", "good", "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) {
function battery(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>`;
return scale(ZONES, pct, `This morning: ${zone[3]} · ${recharge(d)}`, `night end ${d.night_end_v.toFixed(3)} V`);
}
// Storage. Échelle de l'espace libre en fin de jour, sur les planchers de DAILY_STORAGE_STATE (arbitraires, D-034).
function freeSpace(d) {
if (d.free_percent == null) return "Unknown";
const [ok, low] = R.storage_floors;
return scale([[low, "Critical", "bad"], [ok, "Low", "low"], [100, "OK", "good"]], d.free_percent,
`${Math.round(d.free_percent)} % free`, `${d.free_gb} GiB free of ${d.usable_gb} GiB usable`);
}
// Date de saturation au rythme des 7 derniers jours (DAYS_UNTIL_STORAGE_FULL) ; en mois au-delà de 60 jours (affichage).
const day = s => new Date(s).toLocaleDateString("en-GB", { day: "2-digit", month: "short", year: "numeric", timeZone: "UTC" });
function full(d) {
if (d.filling == null) return "Unknown (not enough days measured yet)";
if (!d.filling) return "Not expected: the storage is not filling up";
const n = d.days_until_full;
return `Around ${day(d.full_date)} (about ${n < 60 ? `${Math.round(n)} days` : `${Math.round(n / 30)} months`})`;
}
// Cellular. Envois du jour (DAILY_LINK_STATE), en mots, sur les envois attendus (un toutes les 15 min).
function sends(d) {
if (d.state == null) return "Unknown (incomplete day)";
const missing = d.n_missing ? `${d.n_missing} of ${R.expected_sends} sends missing` : "";
if (d.state === "DOWN") return ["4G link reported down", missing].filter(Boolean).join(" · ");
if (d.state === "MISSING") return missing || "Some data missing";
return "All data received";
}
// Échelle du signal (DAILY_SIGNAL_STATE, grille publiée) : quatre classes de même largeur, trait au milieu de la classe du jour,
// sans dBm. La classe ne change pas la couleur du jour tant que le signal est mesuré (D-037).
const SIGNAL = [[25, "Cell edge", "low"], [50, "Mid cell", "ok"], [75, "Good", "ok"], [100, "Excellent", "good"]];
function signal(d) {
if (d.signal_state == null) return "Unknown (not measured for most of the day)";
const i = R.signal_classes.length - 1 - R.signal_classes.indexOf(d.signal_state); // CLASSES va du meilleur au pire
return scale(SIGNAL, 25 * i + 12.5, SIGNAL[i][1]);
}
// Deux lignes par bloc, en mots simples (côté client : pas de tension brute, pas de mécanisme d'analyse).
const ROWS = {
energy: d => [["Battery", battery(d)], ["Trend", TREND[d.trend] || "Unknown"]],
storage: d => [["Free space", freeSpace(d)], ["Full", full(d)]],
cellular: d => [["Data sent", sends(d)], ["Signal", signal(d)]],
};
const chip = c => `<span class="status ${c || "UNKNOWN"}">${NAME[c] || "Unknown"}</span>`;
function autoscale(plotId) {
/*AUTOSCALE*/
}
// 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/energy/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*/
for (const [key, dom] of Object.entries(DATA.domains)) {
const cur = dom.cur || {}, c = cur.color, [name, what] = DOMAIN[key];
const el = document.getElementById("diag-item").content.firstElementChild.cloneNode(true);
el.id = key;
el.querySelector(".name").textContent = name;
el.querySelector(".status").outerHTML = chip(c);
el.querySelector(".meta").textContent = `${DATA.label} · ${ACTION[c] || "Check data"}`;
el.querySelector(".headline").textContent = dom.headline[c] || `Not enough data to assess the station's ${what}.`;
el.querySelector(".days").innerHTML = ROWS[key](cur).map(([k, x]) => `<tr><th>${k}</th><td>${x}</td></tr>`).join("");
el.querySelector(".guide").innerHTML = marked.parse(dom.guide); // texte du projet, pas une saisie
// Energy, jours Orange et Red : remède proposé au client, veille profonde entre les mesures
// (docs/energy/domaine/comment-se-comporte-la-batterie.md). Action de la plateforme, pas du diagnostic (lecture seule).
// Maquette : le bouton n'envoie rien. Storage et Cellular n'ont pas de remède connu : pas de bouton.
const action = el.querySelector(".action");
action.hidden = key !== "energy" || !["ORANGE", "RED"].includes(c);
action.querySelector("button").onclick = () =>
action.querySelector(".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).
const plot = el.querySelector(".plot");
plot.id = `plot-${key}`;
el.querySelector(".history").addEventListener("toggle", e => {
if (!e.target.open || e.target.dataset.drawn) return;
e.target.dataset.drawn = "1";
Plotly.newPlot(plot, dom.figure.data, dom.figure.layout, { responsive: true, scrollZoom: true })
.then(() => autoscale(plot.id));
});
});
document.getElementById("diag").append(el);
}
document.getElementById("table").innerHTML =
DATA.table.map(([k, x]) => `<tr><td>${k}</td><td>${x}</td></tr>`).join("");