"""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//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//final.py, D-021) et guide (partie 1), repliés. Données réelles : une page par station de data/. Écrit out/maquette_user_.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), ("/*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)