Files
Support-Agent/src/cellular/link_state.py
T
maximeandClaude Opus 5.5 f803a7d596 Count sends without link and add NORDEND to the cellular working set
DAILY_LINK_STATE falls back on last_sync for exports without link,
treats the start of history as unknown, and records D-032. Document
the hourly counting flaws, the observed 15-minute cadence, and the
open questions for the specialist.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 11:50:07 +02:00

75 lines
3.6 KiB
Python

"""DAILY_LINK_STATE : état du lien 4G jour par jour (état seul, sans verdict).
Documentation : docs/cellular/analyses/daily_link_state.md
Bibliothèque standard uniquement (cible : système embarqué de la station).
"""
from collections import defaultdict
# Constantes (fiche daily_link_state, « Constantes et sources »).
SAMPLES_PER_HOUR = 4 # un instantané par envoi, toutes les 15 min : last_sync et 4 échantillons par heure, WEISSHORN 03-13/10
HOURS_PER_DAY = 24 # jour UTC complet : un jour coupé par l'export n'a pas de nombre d'envois attendu fiable
RULE = {
"id": "DAILY_LINK_STATE",
"phase": "état seul, sans verdict (anomaly = None)",
"samples_per_hour": SAMPLES_PER_HOUR,
"doc": "docs/cellular/analyses/daily_link_state.md",
}
def day_facts(link, sync):
"""Échantillons d'un jour, {heure UTC: liste ou None}, de `link` et de `last_sync`. L'une des deux séries peut manquer
(None) : les exports d'avant `link` n'ont que `last_sync`. -> faits et état (fiche, « Principe »)."""
hours = (link or {}).keys() | (sync or {}).keys()
# Par heure, (messages link, messages last_sync) : les deux partent à chaque envoi, quel que soit l'état du modem.
counts = [(len((link or {}).get(h) or []), len((sync or {}).get(h) or [])) for h in hours]
# Un envoi est arrivé si l'un de ses deux messages est arrivé ; par heure : un doublon ne bouche pas un trou.
missing = sum(max(0, SAMPLES_PER_HOUR - max(c)) for c in counts)
lost = None if link is None or sync is None else sum(abs(a - b) for a, b in counts) # perdus dans un envoi arrivé
samples = [x for v in (link or {}).values() if v for x in v]
n_up, n_down = (None, None) if link is None else (samples.count("up"), samples.count("down"))
expected = SAMPLES_PER_HOUR * HOURS_PER_DAY
full = len(hours) == HOURS_PER_DAY
if not full:
state = None # UNKNOWN : jour coupé par l'export
elif n_down:
state = "DOWN"
elif missing or lost:
state = "MISSING"
else:
state = "UP"
return {"state": state, "received_percent": round(100 * (expected - missing) / expected, 1) if full else None,
"up_percent": round(100 * n_up / expected, 1) if full and n_up is not None else None,
"n_sends": sum(max(c) for c in counts), "n_up": n_up, "n_down": n_down,
"n_missing": missing, "n_messages_lost": lost, "hours": len(hours)}
def by_day(series):
"""{t: échantillons} -> {jour: {heure: échantillons}} ; None si la série manque."""
if series is None:
return None
days = defaultdict(dict)
for t, v in series.items():
days[t.date()][t.hour] = v
return days
def run(series):
"""Analyse DAILY_LINK_STATE, causale : le jour d n'utilise que les heures de d. Un point par jour UTC."""
link, sync = by_day(series.get("link")), by_day(series.get("last_sync"))
if link is None and sync is None:
raise KeyError("DAILY_LINK_STATE : il faut la série link ou last_sync")
ref = series["link"] if link is not None else series["last_sync"]
last = {}
for t in sorted(ref):
last[t.date()] = t
points, started = [], False
for d in sorted(last):
facts = day_facts(None if link is None else link[d], None if sync is None else sync[d])
if not started: # début d'historique : jusqu'au jour du premier envoi reçu, compris, le jour est coupé
started = facts["n_sends"] > 0
facts["state"] = None
value = facts["received_percent"] if facts["state"] else None
points.append({"t": last[d], "value": value, "anomaly": None, "facts": facts})
return {"analysis": RULE["id"], "rule": RULE, "points": points}