2026-10-13 16:05:26 +02:00
"""Maquette côté client « System Summary » : page d'une station sur le site de monitoring, avec une section Diagnostic
2026-10-13 16:11:21 +02:00
(D-020 à D-023, D-039, D-041). Un bloc par domaine dont la station a les mesures : Energy, Storage, Cellular, Temperature.
2026-10-13 16:05:26 +02:00
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
2026-10-13 16:11:21 +02:00
du jour et échelle du signal ; Temperature : maximum des 24 h et limite), puis historique complet (src/<domaine>/final.py, D-021) et guide (partie 1), repliés.
2026-10-13 17:23:26 +02:00
Energy affiche aussi, dans son en-tête, si la station est sur secteur ou non (DAILY_POWER_SOURCE, D-043).
2026-10-13 16:05:26 +02:00
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
2026-10-13 16:11:21 +02:00
from temperature import day_color as temperature , gpu_temperature_limit as gl # noqa: E402
from temperature.final import daily_figure as temperature_figure # noqa: E402
2026-10-13 16:05:26 +02:00
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" ),
2026-10-13 16:11:21 +02:00
"cellular" : ( cellular , cellular_figure , "docs/cellular/guide/diagnostic-cellulaire.md" ),
"temperature" : ( temperature , temperature_figure , "docs/temperature/guide/diagnostic-temperature.md" )}
2026-10-13 16:05:26 +02:00
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 ,
2026-10-13 16:11:21 +02:00
"expected_sends" : ls . SAMPLES_PER_HOUR * ls . HOURS_PER_DAY , "signal_classes" : sgs . CLASSES ,
2026-10-13 17:22:16 +02:00
"gpu_limit_deg_c" : gl . GPU_LIMIT_DEG_C , "power_label" : energy . POWER_LABEL }
2026-10-13 16:05:26 +02:00
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 )