diff --git a/CLAUDE.md b/CLAUDE.md index 4a7ba59..9065065 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -15,9 +15,9 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m - **Maquettes du site (D-022)** : client « Energy » (section Diagnostic de la page System Summary) ; support « Home » (section Status, une notification par station Orange ou Red, lien vers la vue client, D-025). - **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit. - **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; ni figure du site, ni maquette, ni guide (étape 7 de `nouveau-domaine`). -- **Cellular (D-030 à D-032), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; ni couleur du jour, ni figure du site, ni maquette, ni guide (étapes 6 et 7 de `nouveau-domaine`). Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`. +- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; ni figure du site, ni maquette, ni guide (étape 7 de `nouveau-domaine`). Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`. - **Températures (D-036)** : explorées sur les trois stations, pas de domaine pour l'instant (ni épisode de chaleur, ni seuil sourcé, ni cas de l'expert) ; constats, pistes et questions dans `docs/domaine/temperatures-de-la-station.md`. -- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, puis la couleur du jour (étape 6) ; `storage` : la livraison (étape 7 de `nouveau-domaine`, dans une autre conversation : figure du site `src/storage/final.py`, passage des maquettes à une liste de domaines, maquettes à proposer puis attendre les consignes, guide `docs/storage/guide/`) ; températures : rien à faire avant les réponses du spécialiste (questions de `docs/domaine/temperatures-de-la-station.md`) ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre « Energy » côté client pas à pas, puis le côté support pas à pas (points ouverts dans D-022). +- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, puis la livraison (étape 7) ; `storage` : la livraison (étape 7 de `nouveau-domaine`, dans une autre conversation : figure du site `src/storage/final.py`, passage des maquettes à une liste de domaines, maquettes à proposer puis attendre les consignes, guide `docs/storage/guide/`) ; températures : rien à faire avant les réponses du spécialiste (questions de `docs/domaine/temperatures-de-la-station.md`) ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre « Energy » côté client pas à pas, puis le côté support pas à pas (points ouverts dans D-022). ## Analyses (domaine Energy) @@ -44,6 +44,8 @@ Code dans `src/cellular/`, fiche dans `docs/cellular/analyses/.md`, page de comparaison `src/storage/all_analyses.py` (WEISSHORN, D-034). @@ -85,7 +87,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv ### Fichiers - `README.md` (40 l) : point d'entrée pour un humain. -- `docs/decisions.md` (386 l, D-001 à D-036) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée. +- `docs/decisions.md` (396 l, D-001 à D-037) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée. - `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question. - `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport. - `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit. @@ -96,7 +98,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv - `domaine/` (< 80 l) : `comment-se-comporte-la-batterie.md` (LiFePO4, plateau et coude, table OCV, redémarrage à 12,6 V, capacité) ; `tensions-selon-l-etat-de-la-batterie.md` (tensions et pentes en charge, pleine charge et décharge) ; `cas-annotes-par-l-expert.md` (diagnostics experts des 5 stations, vérité de référence). - `guide/diagnostic-energetique.md` (180 l, brouillon) : manuel, partie 1 pour le client (§1-4), partie 2 pour le support (§5-9). À tenir à jour avec la matrice et les fiches des deux analyses livrées. - `matrice-etat-tendance.drawio` : matrice état × tendance, tenue par l'utilisateur. -- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Storage a sa matrice état × horizon, `matrice-etat-horizon.drawio`, tenue par l'utilisateur. Chacun a une note de départ, `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes), ses fiches dans `analyses/` et ses questions ouvertes dans `domaine/questions-pour-l-expert.md`. +- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Storage a sa matrice état × horizon, `matrice-etat-horizon.drawio`, Cellular sa matrice lien × signal, `matrice-lien-signal.drawio`, tenues par l'utilisateur. Chacun a une note de départ, `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes), ses fiches dans `analyses/` et ses questions ouvertes dans `domaine/questions-pour-l-expert.md`. - `docs/agents/rapport-exploratoire.md` (290 l) : cadre d'agents LLM (D-027) : choix retenus, architecture, démarrage par étapes (§6) ; annexe A : pistes à revoir étape par étape. Le code d'agent vivra à part (`agents/`, proposé, pas créé). - `docs/aimsight/` : documentation AIMsight d'origine, en anglais, non modifiée. À lire avant de concevoir, **par section** ; ne pas re-demander à l'utilisateur ce qui y figure. - `AIMsight_reference_quality_event_explainer_roadmap.md` (1 180 l) : **référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10). @@ -113,7 +115,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv - `src/` : un sous-dossier par domaine, plus le code commun (D-026). - `common/` : `stations.py` (chargement des CSV, métriques texte en listes, trous de mesure ; bibliothèque standard) et `page.py` (poste de dev : bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`). - `energy/` : calcul embarquable, en bibliothèque standard et sans import de `common/` : `battery_state.py`, `battery_trend.py`, `moving_average.py`, `day_color.py`. Scripts plotly du poste de dev, à laisser hors de la station : `final.py`, `all_analyses.py`, `focus_jour.py`. - - `cellular/` : calcul embarquable `link_state.py`, `signal_state.py` ; page plotly `all_analyses.py` (D-031). + - `cellular/` : calcul embarquable `link_state.py`, `signal_state.py`, `day_color.py` (D-037) ; page plotly `all_analyses.py` (D-031). - `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; page plotly `all_analyses.py` (D-034). - `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/energy.py` + `energy_template.html` (client), `support/home.py` + `home_template.html` (support). - `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `settings.json` (lecture de `.env` interdite). diff --git a/docs/cellular/matrice-lien-signal.drawio b/docs/cellular/matrice-lien-signal.drawio new file mode 100644 index 0000000..32418c1 --- /dev/null +++ b/docs/cellular/matrice-lien-signal.drawio @@ -0,0 +1,232 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/decisions.md b/docs/decisions.md index 46e8204..b802273 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -384,3 +384,13 @@ Règles du journal : - **Pourquoi** : choix de l'utilisateur, sur proposition. Aucun épisode de chaleur dans les données (maximum 62,7 °C, NORDEND, le 13/08), aucun seuil du matériel ni de la documentation AIMsight, aucun cas de l'expert : un verdict serait vert tous les jours, ou rouge sur un seuil inventé. - **Options écartées** : un domaine surchauffe comparant la station à son propre passé (il signalerait les jours d'été chauds, pas un défaut) ; l'amplitude du jour comme indice d'ensoleillement pour Energy (corrélation avec la tension maximale du jour de −0,03 à 0,32) ; la température au retour d'un trou comme preuve seule d'une coupure (le trou commun du 19/08 revient aussi ~7 °C sous l'habitude). - **Conséquence** : à reprendre avec les seuils thermiques du matériel, un premier incident annoté, ou les données d'hiver (froid et charge de la batterie LiFePO4). + +## D-037 — 2026-10-13 — Cellular : couleur du jour, matrice lien × signal +- **Statut** : active. Applique le contrat de notification de D-030 au domaine Cellular ; complète D-031 et D-032. +- **Décision** : + - `src/cellular/day_color.py` : la couleur du jour se lit dans une matrice lien × signal, tenue par l'utilisateur dans `docs/cellular/matrice-lien-signal.drawio` et recopiée dans `MATRIX`, comme pour Energy (D-020) et Storage (D-035). Le lien vient de `DAILY_LINK_STATE` (`UP`, `MISSING`, `DOWN`) ; le signal de `DAILY_SIGNAL_STATE` (`EXCELLENT`, `GOOD`, `MID_CELL`, `CELL_EDGE`), ou inconnu (moins de 20 h mesurées sur 24) ; + - Green : tous les envois sont arrivés, signal connu, quelle que soit sa classe (`CELL_EDGE` compris). Orange : `MISSING` ou `DOWN` avec un signal connu. Red : `MISSING` ou `DOWN` avec un signal inconnu, c'est-à-dire une station qui s'est tue 5 h ou plus. Gris : lien inconnu, ou `UP` avec un signal inconnu (Green demande les deux analyses) ; + - `HEADLINE` : Red « The station stopped sending data for a large part of the day. », Orange « The station's 4G connection showed interruptions. ». +- **Pourquoi** : choix de l'utilisateur, sur proposition. Le Red reprend `MIN_COVERAGE`, déjà sourcé, sans nouveau seuil : sur NORDEND, il retient 9 des 11 jours de coupure lourde (23 à 95 envois manquants), et aucun des petits manques (1 à 5 envois). +- **Options écartées** : `UP` × `CELL_EDGE` en Orange (NORDEND déclencherait une notification 76 jours sur 109 alors que tous ses envois sont arrivés ; la grille ne sépare pas ses bons jours des mauvais, fiche `daily_signal_state`) ; `DOWN` en Red dès un échantillon (le `down` fugitif du 03/09 sur WEISSHORN, les 96 envois arrivés) ; un nombre d'envois manquants comme seuil du Red (pas de source, pas de cas de l'expert). +- **Conséquence** : WEISSHORN, 46 jours Green, 7 Orange, 1 Red (20/08, fin de la mise en service), 12 gris ; NORDEND, 76 Green, 20 Orange, 9 Red, 5 gris. Tant que le signal est connu, sa classe ne change pas la couleur. Restent hors de la matrice : le croisement avec Energy, les deux corrections de `DAILY_LINK_STATE` (le 15/07 de NORDEND repasserait Green) et les seuils du signal, en attente du spécialiste. diff --git a/push.sh b/push.sh new file mode 100755 index 0000000..ff63ec6 --- /dev/null +++ b/push.sh @@ -0,0 +1,6 @@ +#!/usr/bin/env bash +set -e +git pull --rebase --autostash +git add -A +git commit -m "$1" +git push diff --git a/src/cellular/day_color.py b/src/cellular/day_color.py new file mode 100644 index 0000000..66236f8 --- /dev/null +++ b/src/cellular/day_color.py @@ -0,0 +1,47 @@ +"""Couleur du jour Cellular : matrice lien (DAILY_LINK_STATE) × signal (DAILY_SIGNAL_STATE) -> vert / orange / rouge (D-037). + +Documentation : docs/cellular/matrice-lien-signal.drawio, docs/decisions.md (D-037) +Bibliothèque standard uniquement (cible : système embarqué de la station). +""" +from cellular import link_state as ls, signal_state as ss + +# Matrice tenue par l'utilisateur dans docs/cellular/matrice-lien-signal.drawio : MATRIX[lien][signal]. +# Signal None : moins de 20 h mesurées sur 24 ; avec des envois manquants, la station s'est tue 5 h ou plus. +# Lien None (jour coupé par l'export, début d'historique) : gris, quel que soit le signal. +KNOWN = ss.CLASSES # EXCELLENT, GOOD, MID_CELL, CELL_EDGE +MATRIX = { + "UP": {**dict.fromkeys(KNOWN, "GREEN"), None: None}, + "MISSING": {**dict.fromkeys(KNOWN, "ORANGE"), None: "RED"}, + "DOWN": {**dict.fromkeys(KNOWN, "ORANGE"), None: "RED"}, +} + +# Une phrase par couleur notifiée, en anglais (D-023) ; Green ne notifie rien (D-025). +HEADLINE = {"RED": "The station stopped sending data for a large part of the day.", + "ORANGE": "The station's 4G connection showed interruptions."} + +RULE = { + "id": "DAY_COLOR", + "verdict": "aucun : anomaly = None ; la couleur est dans facts.color (None = inconnu)", + "matrix": MATRIX, + "doc": "docs/cellular/matrice-lien-signal.drawio", +} + + +def run(series): + """Couleur du jour, causale comme les deux analyses. Un point par jour UTC, aux jours de DAILY_LINK_STATE.""" + signal = {p["t"].date(): p["facts"] for p in ss.run(series)["points"]} + points = [] + for p in ls.run(series)["points"]: + s = signal.get(p["t"].date(), {}) + facts = {**p["facts"], "signal_state": s.get("state"), "coverage": s.get("coverage")} + facts["color"] = MATRIX.get(facts["state"], {}).get(facts["signal_state"]) + points.append({"t": p["t"], "value": facts["color"], "anomaly": None, "facts": facts}) + return {"analysis": RULE["id"], "rule": RULE, "points": points} + + +if __name__ == "__main__": # contrôle de la transcription : les cases du schéma + assert MATRIX["UP"]["CELL_EDGE"] == "GREEN" and MATRIX["UP"][None] is None + assert MATRIX["MISSING"]["GOOD"] == MATRIX["DOWN"]["CELL_EDGE"] == "ORANGE" + assert MATRIX["MISSING"][None] == MATRIX["DOWN"][None] == "RED" + assert MATRIX.get(None, {}).get("GOOD") is None + print("ok")