Files
Support-Agent/maquettes/user/summary.py
T

91 lines
5.0 KiB
Python
Raw Normal View History

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