From f0990c16e699e1043a88b1be625d747d88d66807 Mon Sep 17 00:00:00 2001 From: maxime Date: Tue, 13 Oct 2026 16:05:26 +0200 Subject: [PATCH] Deliver Storage and Cellular in the mockups, with site figures and guides The mockups now walk a list of domains (D-039): the support Home loads every station in data/ and notifies each station x domain that is Orange or Red; the client view becomes maquettes/user/summary.py, one System Summary page per station with one block per measured domain. Storage shows a free-space scale and the estimated full date; Cellular shows the day's sends in words and a four-class signal scale. HEADLINE moves into each day_color.py, with a Green sentence for the client view. src/storage/final.py and src/cellular/final.py write the site figures in English; the comparison pages reuse their panels. Each domain gets a short two-layer guide in docs//guide/. Co-Authored-By: Claude Opus 5.5 --- .claude/skills/nouveau-domaine/SKILL.md | 8 +- CLAUDE.md | 32 ++-- README.md | 2 +- docs/cellular/analyses/daily_link_state.md | 2 + docs/cellular/analyses/daily_signal_state.md | 2 + docs/cellular/guide/diagnostic-cellulaire.md | 96 ++++++++++ docs/decisions.md | 22 ++- docs/storage/analyses/daily_storage_state.md | 2 + .../analyses/days_until_storage_full.md | 2 + docs/storage/guide/diagnostic-stockage.md | 84 +++++++++ maquettes/support/home.py | 48 +++-- maquettes/user/energy.py | 62 ------ maquettes/user/summary.py | 91 +++++++++ ...gy_template.html => summary_template.html} | 176 ++++++++++++------ src/cellular/all_analyses.py | 56 +----- src/cellular/day_color.py | 7 +- src/cellular/final.py | 103 ++++++++++ src/energy/day_color.py | 6 + src/energy/focus_jour.py | 2 +- src/storage/all_analyses.py | 35 +--- src/storage/day_color.py | 7 +- src/storage/final.py | 83 +++++++++ 22 files changed, 682 insertions(+), 246 deletions(-) create mode 100644 docs/cellular/guide/diagnostic-cellulaire.md create mode 100644 docs/storage/guide/diagnostic-stockage.md delete mode 100644 maquettes/user/energy.py create mode 100644 maquettes/user/summary.py rename maquettes/user/{energy_template.html => summary_template.html} (61%) create mode 100644 src/cellular/final.py create mode 100644 src/storage/final.py diff --git a/.claude/skills/nouveau-domaine/SKILL.md b/.claude/skills/nouveau-domaine/SKILL.md index fdb4f09..2526186 100644 --- a/.claude/skills/nouveau-domaine/SKILL.md +++ b/.claude/skills/nouveau-domaine/SKILL.md @@ -49,8 +49,10 @@ Un domaine reprend le travail fait pour Energy : des analyses sans LLM, un verdi ## 7. Livrer et documenter -- Figure du site : `src//final.py`, sur le modèle de `src/energy/final.py` (D-021), en anglais. -- Maquettes : proposer, puis attendre les consignes de l'utilisateur. Côté support, une notification sur `maquettes/support/home.py` ; côté client, un bloc dans la section Diagnostic. -- **Si les maquettes ne parcourent pas encore une liste de domaines, faire ce passage d'abord, une seule fois** : déplacer `HEADLINE` d'Energy de `maquettes/support/home.py` vers `src/energy/day_color.py`, puis remplacer l'appel direct à `energy.day_color` par `DOMAINS = {"Energy": energy.day_color, "": .day_color}`, parcouru pour les notifications (D-030). +- Figure du site : `src//final.py`, sur le modèle de `src/cellular/final.py` (D-021, D-039), en anglais : `daily_figure(station, series)` et `out/__daily.html` + `.json` ; la page de comparaison importe ses panneaux (`analysis_panels`). +- Maquettes : proposer le contenu du bloc client (deux lignes en mots simples, sur le modèle des blocs existants), puis attendre les consignes de l'utilisateur. Les maquettes parcourent une liste de domaines (D-039) : + - `HEADLINE` dans `src//day_color.py`, avec une phrase Green pour la vue client ; + - côté support, ajouter le domaine à `DOMAINS` dans `maquettes/support/home.py` ; + - côté client, l'ajouter à `DOMAINS` dans `maquettes/user/summary.py` (couleur, figure, guide), puis à `DOMAIN` et `ROWS` dans `maquettes/user/summary_template.html`. - Guide : `docs//guide/`, en deux couches, client puis support (D-020). - `CLAUDE.md` : tableau des analyses du domaine, « État et prochaine étape », commandes, carte. `docs/decisions.md` : une entrée pour le nouveau domaine (jeu de travail, sens des couleurs). diff --git a/CLAUDE.md b/CLAUDE.md index 3e7f9d0..53d04e8 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,13 +12,13 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m - **Energy, livré (prototype, D-020)** : `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND`, combinées par la matrice état × tendance en une couleur par jour (vert / orange / rouge, gris si inconnu). Une figure Plotly pour le site (D-021 ; la matrice est codée mais pas tracée), un focus sur un jour et sa veille (D-024), un manuel en brouillon. - **Energy, comparaison seulement** : les deux moyennes glissantes sur 7 jours. Point ouvert : l'accoutumance après ~30 jours de déficit (fiche `moving_average_7_days_drop`). -- **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). +- **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, 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, 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`. +- **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` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`. +- **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) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. 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`. - **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST. -- **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). +- **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, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le 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 côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039). ## Analyses (domaine Energy) @@ -46,6 +46,7 @@ Code dans `src/cellular/`, fiche dans `docs/cellular/analyses/_daily.html + .json (figure du site, D-021) python3 src/energy/all_analyses.py [données] # les 4 analyses comparées (D-016) : out/_energy.html python3 src/energy/focus_jour.py JJ.MM[.AAAA] [données] # un jour et sa veille (D-024) : faits + out/_focus_.html + .json -python3 src/cellular/all_analyses.py [données] # analyses 4G comparées : out/_cellular.html (défaut data/WEISSHORN/ et data/NORDEND/) -python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/_storage.html (défaut data/WEISSHORN/) -python3 maquettes/user/energy.py [début] [fin] # maquette client : out/maquette_user_energy.html +python3 src/cellular/final.py [données] # livré : out/_cellular_daily.html + .json (défaut data/WEISSHORN/ et data/NORDEND/) +python3 src/cellular/all_analyses.py [données] # analyses 4G comparées : out/_cellular.html (même défaut) +python3 src/storage/final.py [données] # livré : out/_storage_daily.html + .json (défaut data/WEISSHORN/) +python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/_storage.html (même défaut) +python3 maquettes/user/summary.py [début] [fin] # maquette client : out/maquette_user_.html, une page par station de data/ python3 maquettes/support/home.py [début] [fin] # maquette support : out/maquette_support_home.html pdftotext -layout "docs/aimsight/.pdf" - # lire un PDF AIMsight python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv ``` -- `[données]` : CSV ou dossiers, défaut `data/VERMONT/`. Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; la maquette support mène à la maquette client : les lancer avec les mêmes dates. +- `[données]` : CSV ou dossiers, défaut `data/VERMONT/`. Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; la maquette support mène aux maquettes client : les lancer avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular). - Chaque script bascule seul sur `.venv` si plotly manque, puis ouvre sa page (navigateur Windows via `explorer.exe` sous WSL). -- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur VERMONT. +- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur le jeu de travail du domaine. ## Carte du dépôt @@ -88,7 +92,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` (406 l, D-001 à D-038) : 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` (424 l, D-001 à D-039) : 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. @@ -99,7 +103,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`, 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/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/`, ses questions ouvertes dans `domaine/questions-pour-l-expert.md` et son guide (~90 l, client puis support) dans `guide/`, dont la partie 1 est affichée dans la vue client. - `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). @@ -116,9 +120,9 @@ 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`, `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). + - `cellular/` : calcul embarquable `link_state.py`, `signal_state.py`, `day_color.py` (D-037) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-031). + - `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `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/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039). - `.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). - `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. - `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande. diff --git a/README.md b/README.md index b9ac4cf..40f18ea 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer c | Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs//domaine/` (`energy`, `storage`, `cellular`) | | Documentation AIMsight d'origine | `docs/aimsight/` | | Données de travail (VERMONT pour Energy, WEISSHORN pour Storage, WEISSHORN et NORDEND pour Cellular) | `data//` | -| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/energy.py`, `python3 maquettes/support/home.py` | `maquettes/` | +| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/summary.py`, `python3 maquettes/support/home.py` | `maquettes/` | ## État diff --git a/docs/cellular/analyses/daily_link_state.md b/docs/cellular/analyses/daily_link_state.md index fbf960f..da7c9aa 100644 --- a/docs/cellular/analyses/daily_link_state.md +++ b/docs/cellular/analyses/daily_link_state.md @@ -49,6 +49,7 @@ Sortie (contrat commun) : un point par jour. ## Graphique - **En haut** : `received_percent` par jour, placé à midi UTC (D-019), un marqueur par état (couleur, symbole et légende propres ; couleurs validées par le skill dataviz). +- **Site** : le même panneau, en anglais (D-023), dans la figure du site `src/cellular/final.py` (historique complet du bloc Cellular de la vue client, D-039) ; la page de comparaison l'importe de là. - **Dessous** : les séries du modem, et le nombre d'envois reçus par heure (`last_sync`, sinon `link`), en barres. ## Résultats (jeu de travail : WEISSHORN et NORDEND, D-032) @@ -110,3 +111,4 @@ NORDEND (109 jours, sans `link`, du 26/06 au 13/10) : - **2026-10-13** : `link` facultatif (exports sans `link`, NORDEND) ; `value` devient `received_percent` ; ajout de `n_sends` ; début d'historique en UNKNOWN ; pourcentages `None` sur un jour coupé (D-032). - **2026-10-13** : limites 9 (comptage par heure) et 10 (cadence supposée) ; deux corrections retenues sur le principe, non codées, en attente du spécialiste (« Pistes »). - **2026-10-13** : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours. +- **2026-10-13** : panneau en anglais, partagé avec la figure du site `src/cellular/final.py` ; livraison du domaine (vue client, notifications, guide `docs/cellular/guide/`, D-039). diff --git a/docs/cellular/analyses/daily_signal_state.md b/docs/cellular/analyses/daily_signal_state.md index 4bf6cd9..c37135f 100644 --- a/docs/cellular/analyses/daily_signal_state.md +++ b/docs/cellular/analyses/daily_signal_state.md @@ -42,6 +42,7 @@ Sortie (contrat commun) : un point par jour. ## Graphique - **En haut, deux panneaux** (un par unité : pas de double axe, skill dataviz) : la médiane du jour du RSRP en dBm, puis celle du RSRQ en dB. Les planchers de la grille sont en pointillés, la classe de la mesure en marqueurs ; l'état du jour (la pire classe) est dans le survol. +- **Site** : les mêmes deux panneaux, en anglais (D-023), dans la figure du site `src/cellular/final.py` (historique complet du bloc Cellular de la vue client, D-039) ; la page de comparaison les importe de là. - **Dessous** : les séries du modem. ## Résultats (jeu de travail : WEISSHORN et NORDEND, D-032) @@ -87,3 +88,4 @@ NORDEND (109 jours) : - **2026-10-13** : création (D-031). - **2026-10-13** : résultats sur NORDEND (D-032). - **2026-10-13** : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours. +- **2026-10-13** : deux panneaux en anglais, partagés avec la figure du site `src/cellular/final.py` ; livraison du domaine (vue client, notifications, guide `docs/cellular/guide/`, D-039). diff --git a/docs/cellular/guide/diagnostic-cellulaire.md b/docs/cellular/guide/diagnostic-cellulaire.md new file mode 100644 index 0000000..c9c759d --- /dev/null +++ b/docs/cellular/guide/diagnostic-cellulaire.md @@ -0,0 +1,96 @@ +# Guide : lire le diagnostic 4G d'une station AIMsight + +- **Statut** : brouillon, 2026-10-13. La couleur du jour est calculée par `src/cellular/day_color.py`, selon la matrice de `docs/cellular/matrice-lien-signal.drawio` (D-037). Prototype : aucun cas de l'expert, deux corrections de `DAILY_LINK_STATE` en attente du spécialiste. +- **Lecteurs** : la partie 1 s'adresse au client final (elle est affichée dans le bloc Cellular de la page System Summary) ; la partie 2 à l'ingénieur support AIMsight. + +--- + +# Partie 1 : lecture rapide + +## 1. Ce que surveille le diagnostic + +La station envoie ses mesures par la 4G, toutes les 15 minutes, soit 96 envois par jour. Chaque jour, le diagnostic répond à une question : **tous les envois de la station sont-ils arrivés ?** + +La réponse est une **couleur par jour**. Le bloc montre aussi la qualité du signal 4G reçu par la station. + +## 2. Les couleurs, et ce qu'il faut faire + +| Couleur | Ce que ça veut dire | Que faire | +|---|---|---| +| 🟢 **Vert** | Tous les envois sont arrivés. | Rien. | +| 🟠 **Orange** | Quelques envois manquent, ou la 4G a été signalée coupée, mais la station a continué à mesurer. | Rien si l'orange est isolé : un envoi perdu suffit à le produire. **Prévenir le support si les oranges se suivent plusieurs jours.** | +| 🔴 **Rouge** | La station s'est tue une grande partie de la journée (5 heures ou plus). | **Contacter le support.** Regarder aussi le bloc Energy : une station sans énergie se tait aussi. | +| ⚪ **Gris** | Inconnu : journée incomplète (premier jour suivi, jour en cours), ou envois arrivés mais signal mesuré trop peu de temps. | Regarder les jours voisins. | + +- **La couleur du jour peut encore changer** tant que la journée n'est pas terminée (minuit UTC). + +## 3. Ce qu'affiche le bloc + +- **Data sent** : « All data received », le nombre d'envois manquants sur 96, ou « 4G link reported down ». +- **Signal** : la qualité du signal sur la journée, sur une échelle à quatre classes : Cell edge (limite de la zone couverte), Mid cell, Good, Excellent. **Le signal ne change pas la couleur** : une station en limite de zone peut tout transmettre. C'est un repère, pas une alerte. + +## 4. Deux exemples réels (2026) + +### WEISSHORN : une station bien couverte + +| Jour | Couleur | Ce qui se passe | +|---|---|---| +| 20/08 | 🔴 | Fin de la mise en service : 18 heures de silence, 43 envois manquants. | +| 22/08, 29/08, 30/08, 01/09, 05/09, 06/09 | 🟠 | Oranges isolés : un à trois envois perdus, la station revient au vert le lendemain. Rien à faire. | +| 03/09 | 🟠 | La 4G est signalée coupée une fois, mais les 96 envois sont arrivés. | +| 07/09 – 12/10 | 🟢 | Tous les envois arrivent. Signal « Good » tous les jours. | + +### NORDEND : une station en limite de zone + +| Période | Couleur | Ce qui se passe | +|---|---|---| +| 30/06 – 01/07, 11 – 13/07, 22 – 23/07, 19/08, 22/08 | 🔴 | Coupures de la liaison, de 1 à 23 heures sans envoi. | +| 26/08 – 06/09 | 🟠 presque tous les jours | 1 à 5 envois perdus par jour : une série d'oranges, la situation où il faut prévenir le support (cas pas encore confirmé par l'expert). | +| le reste | surtout 🟢 | Signal « Cell edge » presque tous les jours, et pourtant 76 jours sur 109 tous les envois arrivent. | + +--- + +# Partie 2 : annexe technique (support) + +La couleur du jour combine deux analyses des messages du modem : `link` et `last_sync` (deux messages par envoi), et les mesures radio `rsrp_dBm` et `rsrq_dB` (moyennes horaires). Le détail (calcul exact, sources, résultats, options écartées) est dans leurs fiches : `docs/cellular/analyses/daily_link_state.md` et `docs/cellular/analyses/daily_signal_state.md`. Une couleur conclut au plus `consistent with` : elle signale une journée à regarder. + +## 5. Les deux analyses + +- **`DAILY_LINK_STATE`** : envois attendus = 4 par heure × 24 (cadence **observée**, non documentée). Par heure, un envoi est arrivé si l'un de ses deux messages est arrivé. L'état se lit dans cet ordre : + 1. jour incomplet dans l'export, ou début d'historique : inconnu ; + 2. au moins un échantillon `link = down` : `DOWN` ; + 3. un envoi entier ou un message manquant : `MISSING` (la cause n'est pas établie : lien, énergie, serveur) ; + 4. sinon : `UP`. +- **`DAILY_SIGNAL_STATE`** : médianes du jour du RSRP et du RSRQ, classées sur une grille publiée (attribuée au modem Quectel BG96 par KORE Wireless, identique au wiki Teltonika) : `EXCELLENT` ≥ −80 dBm / −10 dB, `GOOD` ≥ −90 / −15, `MID_CELL` ≥ −100 / −20, sinon `CELL_EDGE`. Le jour prend la pire des deux classes. Moins de 20 heures mesurées sur 24 : inconnu. + +## 6. La matrice : du lien et du signal à la couleur + +| Lien \ Signal | mesuré (toute classe) | inconnu (< 20 h) | +|---|---|---| +| `UP` | 🟢 | ⚪ | +| `MISSING` | 🟠 | 🔴 | +| `DOWN` | 🟠 | 🔴 | +| inconnu | ⚪ | ⚪ | + +- **Rouge** : des envois manquent et le signal n'est pas mesuré 20 heures sur 24, donc la station s'est tue 5 heures ou plus. Ce critère reprend `MIN_COVERAGE`, sans nouveau seuil : sur NORDEND, il retient 9 des 11 coupures lourdes, et aucun des petits manques (D-037). +- **Pourquoi le signal ne change pas la couleur** : avec `UP` × `CELL_EDGE` en orange, NORDEND serait notifiée 76 jours sur 109 alors que tous ses envois sont arrivés. +- **Totaux** : WEISSHORN (09/08 au 13/10/2026), 46 jours 🟢, 7 🟠, 1 🔴, 12 ⚪ ; NORDEND (26/06 au 13/10/2026), 76 🟢, 20 🟠, 9 🔴, 5 ⚪. + +## 7. Lire la figure + +`python3 src/cellular/final.py` écrit `out/_cellular_daily.html` et sa figure en JSON (`.json`, pour `Plotly.newPlot`). C'est l'historique complet du bloc Cellular. La page de comparaison (`python3 src/cellular/all_analyses.py`, `out/_cellular.html`) reprend les mêmes panneaux, avec les séries du modem et les envois reçus par heure dessous. + +- **Panneau `DAILY_LINK_STATE`** : `sends received` en % des envois attendus, l'état en marqueurs (● vert `UP`, ◆ jaune `MISSING`, ✕ violet `DOWN`). +- **Panneaux `DAILY_SIGNAL_STATE`** (RSRP en dBm, puis RSRQ en dB) : la `daily median`, les planchers de la grille en tirets, la classe en marqueurs. +- **Survol** : tous les faits calculés du jour (envois reçus et manquants, échantillons `up` et `down`, médianes, couverture). +- **Attention aux couleurs** : celles des panneaux distinguent les états et les classes, ce ne sont pas celles de la matrice. + +## 8. Limites à connaître + +1. **Aucun cas de l'expert** : les questions sont dans `docs/cellular/domaine/questions-pour-l-expert.md`. +2. **Cadence supposée de 15 minutes** sur toutes les stations : une station réglée autrement serait orange tous les jours. +3. **Pas de croisement avec Energy** : une coupure d'énergie fait aussi manquer les envois, et donne un rouge Cellular. +4. **Comptage par heure** : un envoi décalé d'une seconde change d'heure (NORDEND, 15/07 : orange à tort). Deux corrections sont retenues sur le principe mais non codées, en attente du spécialiste. +5. **Un seul `down` suffit** : un état fugitif du modem colore la journée en orange (WEISSHORN, 03/09). +6. **Grille du signal d'un autre modem**, présentée comme indicative : NORDEND est `CELL_EDGE` presque tous les jours et transmet presque tout. +7. **Versions plus anciennes du collecteur** (NORDEND) : sans `link`, ni `DOWN` ni messages perdus ; seuls les envois entiers manquants se voient. diff --git a/docs/decisions.md b/docs/decisions.md index a4a0654..db57fb2 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -207,7 +207,7 @@ Règles du journal : - le format d'intégration côté site (JSON, fragment HTML ou backend Python) reste à choisir avec l'équipe du site. ## D-022 — 2026-10-12 — Maquettes de page en HTML ; Figma seulement sur demande -- **Statut** : active. +- **Statut** : active, remplacée en partie par D-039 (maquettes multi-domaines, une vue client par station). - **Décision** : les maquettes de page (ex. « System Summary » du site de monitoring) sont des pages HTML générées à partir des données réelles, dans `maquettes/`. Un fichier Figma n'est produit que sur demande (designer, passation à l'équipe du site), à partir d'une maquette stable. - **Pourquoi** : choix de l'utilisateur, sur recommandation. Le HTML s'itère plus vite (rendu et vérification en local), garde les données réelles et vivantes (calcul par `src/`), permet l'interaction (survol traçable, zoom), utilise la technologie du livrable (HTML Plotly) et se versionne. - **Options écartées** : Figma comme référence. Chaque modification y passe par l'API Plugin, et le graphique n'y est qu'une image vectorielle figée, sans survol ni zoom. Un premier fichier, produit puis non maintenu, reste dans les brouillons Figma de l'utilisateur : https://www.figma.com/design/S16eZ7PoAAutFJWcyqAHSm. @@ -244,7 +244,7 @@ Règles du journal : - un jour en cours, ou le dernier jour d'un export, est signalé « provisional » : la couleur peut encore changer jusqu'à minuit UTC. ## D-025 — 2026-10-12 — Maquette support « Home » : section Status et lien vers la vue client -- **Statut** : active. Complète D-022. +- **Statut** : active, remplacée en partie par D-039 (maquettes multi-domaines, une vue client par station). Complète D-022. - **Décision** : - côté support, la maquette reprend la page d'accueil du site (une vignette par station : nom, dernière tension, courbe) et place en haut une section « Status » : une notification par station dont le dernier jour de la fenêtre est Orange ou Red (`src/day_color.py`), la plus grave d'abord. Green ne notifie rien ; - une notification donne la couleur, la station, le domaine (Energy), le jour, la phrase de la vue client, et un lien « Open » vers la vue client de la station (son menu principal, `out/maquette_user_energy.html`). La vignette de la station mène au même endroit ; @@ -404,3 +404,21 @@ Règles du journal : - **Pourquoi** : choix de l'utilisateur, sur proposition. Le réseau de l'hôte évite de publier un port pour ce que la caméra envoie au poste (FTP, MQTT) ; Docker Engine est le chemin le plus direct vers ce réseau, sans licence. - **Options écartées** : Docker Desktop for Windows (conteneurs dans sa propre distribution WSL, réseau de l'hôte à activer à part, licence payante au-delà d'une certaine taille d'entreprise) ; Docker Desktop for Linux (fait pour un Linux natif, pas pour WSL) ; le réseau `bridge` (suffit pour joindre la caméra, pas pour en recevoir). - **Conséquence** : vérifié le 2026-10-13 (Docker 29.9.0, Python 3.14.8) : `all_analyses.py` et `final.py` tournent sur VERMONT dans le conteneur ; dans le conteneur, les pages ne s'ouvrent pas seules (pas de navigateur), elles restent dans `out/`. À reprendre quand on connaîtra la version de Python et l'architecture de la station (imiter la station), et la doc de l'API REST (dans l'interface web de la caméra). Le jeton d'API reste hors du dépôt ; les échanges avec la caméra restent en lecture seule. + +## D-039 — 2026-10-13 — Livraison de Storage et Cellular : maquettes multi-domaines, figures du site, guides +- **Statut** : active. Étape 7 de `nouveau-domaine` pour Storage (D-035) et Cellular (D-037) ; remplace en partie D-022 (script et page de la vue client) et D-025 (VERMONT seule, domaine Energy seul) ; applique le passage multi-domaines prévu par D-030. +- **Décision** : + - **vue client** : `maquettes/user/energy.py` devient `maquettes/user/summary.py` (gabarit `summary_template.html`), qui écrit une page System Summary par station de `data/` : `out/maquette_user_.html`. La section Diagnostic a un bloc par domaine dont la station a les mesures (VERMONT : Energy ; WEISSHORN : Energy, Storage, Cellular ; NORDEND : Energy, Cellular), les autres sont masqués ; + - chaque bloc garde la forme d'Energy (D-022) : couleur du dernier jour, phrase, deux lignes en mots simples, dérouleurs « Full history » (figure du site du domaine) et « Guide » (partie 1 du guide du domaine). Storage : échelle de l'espace libre (Critical < 10 %, Low < 20 %, OK, planchers de D-034) et date de saturation (« Full around (about N months) ») ; Cellular : envois du jour en mots (« All data received », « N of 96 sends missing », « 4G link reported down ») et échelle du signal en quatre classes, sans dBm, le trait au milieu de la classe du jour ; + - pas de bouton d'action pour Storage ni Cellular : aucun remède connu (purge, antenne), à revoir avec l'expert ; + - **vue support** : `maquettes/support/home.py` charge toutes les stations de `data/` et parcourt `DOMAINS = {"Energy", "Storage", "Cellular"}` : une notification par station et par domaine Orange ou Red, la plus grave d'abord, avec le lien vers la vue client de la station ; + - `HEADLINE` de chaque domaine vit dans `src//day_color.py`, avec une phrase Green pour la vue client (Green ne notifie toujours rien). Storage Green : « The station has enough storage space. » ; Cellular Green : « The station sent all its data over 4G. » ; + - **figures du site** : `src/storage/final.py` et `src/cellular/final.py`, sur le modèle de `src/energy/final.py` (D-021), écrivent `out/__daily.html` + `.json`. Leurs panneaux, en anglais (D-023), sont partagés avec les pages de comparaison ; + - **guides** : `docs/storage/guide/diagnostic-stockage.md` et `docs/cellular/guide/diagnostic-cellulaire.md`, en deux couches comme celui d'Energy (D-020), plus courts. +- **Pourquoi** : demande de l'utilisateur, qui veut Storage et Cellular dans les maquettes avec le même protocole qu'Energy, et un petit guide par domaine. Choix des blocs validés par l'utilisateur, sur proposition ; la page support réunit déjà toutes les stations, la vue client reste celle d'une station, comme sur le site. +- **Options écartées** : une seule vue client, WEISSHORN (VERMONT perdrait son histoire Energy de septembre) ; le bloc Cellular sans le signal (choix de l'utilisateur : les deux analyses, comme Energy) ; le bloc Storage sans échelle. +- **Conséquence** : + - sur la fenêtre par défaut (18/09-28/09), Storage et Cellular sont Green : la seule notification reste VERMONT Energy Red. La fenêtre `2026-08-12 2026-08-22` montre NORDEND Cellular Red et WEISSHORN Cellular Orange ; + - la livraison de Cellular précède les réponses du spécialiste : les deux corrections de `DAILY_LINK_STATE` et les seuils du signal restent en attente (D-037) ; + - le tableau des métriques de la vue client écarte les identifiants (`SIM_CCID`, `ip*`) et les métriques texte ; + - points ouverts : les guides sont en français dans une page en anglais (comme Energy, D-022) ; le panneau `DAYS_UNTIL_STORAGE_FULL` montre en vue complète le pic de 7 798 jours du 23/08 sur WEISSHORN, qui écrase l'échelle (zoom nécessaire) ; le jour affiché n'est pas encore signalé comme provisoire côté client. diff --git a/docs/storage/analyses/daily_storage_state.md b/docs/storage/analyses/daily_storage_state.md index f1db84c..77a07dc 100644 --- a/docs/storage/analyses/daily_storage_state.md +++ b/docs/storage/analyses/daily_storage_state.md @@ -38,6 +38,7 @@ Sortie (contrat commun) : un point par jour. ## Graphique - **En haut** : `free_percent` jour par jour (ligne), les deux planchers en pointillés, l'état en marqueurs (couleur et symbole). Le survol donne tous les faits. +- **Site** : le même panneau, en anglais (D-023), dans la figure du site `src/storage/final.py` (historique complet du bloc Storage de la vue client, D-039) ; la page de comparaison l'importe de là. - **Dessous** : `data_storage_free_gb`, `data_storage_used_gb`, `data_storage_total_gb`, en GiB. ## Résultats (jeu de travail : WEISSHORN, export de 65 jours) @@ -77,3 +78,4 @@ Sortie (contrat commun) : un point par jour. - **2026-10-13** : création (D-034). - **2026-10-13** : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours. - **2026-10-13** : combinée à l'autre analyse Storage dans la couleur du jour, matrice état × horizon (`docs/storage/matrice-etat-horizon.drawio`, colonnes ; D-035). +- **2026-10-13** : panneau en anglais, partagé avec la figure du site `src/storage/final.py` ; livraison du domaine (vue client, notifications, guide `docs/storage/guide/`, D-039). diff --git a/docs/storage/analyses/days_until_storage_full.md b/docs/storage/analyses/days_until_storage_full.md index 2d663d4..0d98871 100644 --- a/docs/storage/analyses/days_until_storage_full.md +++ b/docs/storage/analyses/days_until_storage_full.md @@ -38,6 +38,7 @@ Sortie (contrat commun) : un point par jour. ## Graphique - **En haut** : `days_until_full` jour par jour ; le survol donne le rythme, la date estimée et le nombre de rythmes. +- **Site** : le même panneau, en anglais (D-023), dans la figure du site `src/storage/final.py` (historique complet du bloc Storage de la vue client, D-039) ; la page de comparaison l'importe de là. - **Dessous** : les séries du disque (panneau commun avec `DAILY_STORAGE_STATE`). ## Résultats (jeu de travail : WEISSHORN, export de 65 jours) @@ -79,3 +80,4 @@ Sortie (contrat commun) : un point par jour. - **2026-10-13** : création (D-034). - **2026-10-13** : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours. - **2026-10-13** : combinée à l'autre analyse Storage dans la couleur du jour, matrice état × horizon (`docs/storage/matrice-etat-horizon.drawio`, lignes ; D-035). +- **2026-10-13** : panneau en anglais, partagé avec la figure du site `src/storage/final.py` ; livraison du domaine (vue client, notifications, guide `docs/storage/guide/`, D-039). diff --git a/docs/storage/guide/diagnostic-stockage.md b/docs/storage/guide/diagnostic-stockage.md new file mode 100644 index 0000000..9069621 --- /dev/null +++ b/docs/storage/guide/diagnostic-stockage.md @@ -0,0 +1,84 @@ +# Guide : lire le diagnostic de stockage d'une station AIMsight + +- **Statut** : brouillon, 2026-10-13. La couleur du jour est calculée par `src/storage/day_color.py`, selon la matrice de `docs/storage/matrice-etat-horizon.drawio` (D-035). Prototype : seuils arbitraires, une seule station, aucun cas de l'expert. +- **Lecteurs** : la partie 1 s'adresse au client final (elle est affichée dans le bloc Storage de la page System Summary) ; la partie 2 à l'ingénieur support AIMsight. + +--- + +# Partie 1 : lecture rapide + +## 1. Ce que surveille le diagnostic + +La station enregistre ses mesures sur un disque (la partition `/data`). Chaque jour, le diagnostic répond à une question : **reste-t-il assez de place sur le disque, et pour combien de temps ?** + +La réponse est une **couleur par jour**. + +## 2. Les couleurs, et ce qu'il faut faire + +| Couleur | Ce que ça veut dire | Que faire | +|---|---|---| +| 🟢 **Vert** | Le disque a assez de place, et il ne sera pas plein avant 2 mois au rythme actuel. | Rien. | +| 🟠 **Orange** | La place baisse : moins de 20 % libres, ou disque plein dans moins de 2 mois au rythme actuel. | Surveiller, et prévenir le support : il reste du temps pour intervenir. | +| 🔴 **Rouge** | Moins de 10 % libres, ou disque plein dans moins de 14 jours. | **Contacter le support.** | +| ⚪ **Gris** | Inconnu : pas de mesure du disque ce jour-là, ou pas encore assez de jours mesurés pour connaître le rythme (il en faut au moins 5). | Regarder les jours voisins. | + +- **Seuils provisoires** : 20 % et 10 % libres, 2 mois et 14 jours sont un premier choix, en attente de l'avis de l'expert. + +## 3. Ce qu'affiche le bloc + +- **Free space** : l'espace libre en fin de journée, en % de l'espace utilisable, placé sur une échelle à trois zones (Critical sous 10 %, Low sous 20 %, OK au-dessus). +- **Full** : la date à laquelle le disque sera plein si le rythme des 7 derniers jours continue. C'est une estimation, pas une prévision : un changement de réglage de la station change le rythme. « Not expected » : le disque ne se remplit pas. + +## 4. Un exemple réel (station WEISSHORN, 2026) + +| Période | Couleur | Ce qui se passe | +|---|---|---| +| 09/08 – 22/08 | ⚪ | Début de l'historique, puis moins d'une semaine de mesures du disque : le rythme n'est pas encore connu. | +| 23/08 – 02/09 | 🟢 | Mise en service : disque presque vide, qui ne se remplit pas. | +| 31/08 | 🟢 | 1,3 GiB écrits en deux heures : l'espace libre passe de 99,7 % à 76,7 %. L'estimation ne s'affole pas pour un seul bloc. | +| 03/09 – 13/10 | 🟢 | Remplissage régulier, 28 MiB par jour. Le 13/10 : 57 % libres, disque plein vers le 06/02/2027. | + +Aucun jour orange ou rouge n'a encore été observé. Au rythme actuel, la station passerait orange vers le 09/12/2026 (plein dans moins de 2 mois), puis rouge vers le 17/01/2027 (moins de 10 % libres). + +--- + +# Partie 2 : annexe technique (support) + +La couleur du jour combine deux analyses de l'espace libre de `/data` (`data_storage_free_gb`, `data_storage_used_gb`, moyennes horaires). Le détail (calcul exact, sources, résultats, options écartées) est dans leurs fiches : `docs/storage/analyses/daily_storage_state.md` et `docs/storage/analyses/days_until_storage_full.md`. Une couleur conclut au plus `consistent with` : elle signale une journée à regarder. + +## 5. Les deux analyses + +- **`DAILY_STORAGE_STATE`** : la dernière mesure du jour. `free_percent` = libre / (libre + utilisé), la réserve de `root` exclue, comme le `percent` de `psutil`. État : `OK` si ≥ 20 %, `LOW` si ≥ 10 %, sinon `CRITICAL` (planchers **arbitraires**, D-034). Une mesure suffit ; sans mesure, l'état est inconnu. +- **`DAYS_UNTIL_STORAGE_FULL`** : le rythme du jour est la baisse de l'espace libre depuis la fin de jour mesurée précédente, ramenée à un jour. Le rythme retenu est la médiane des rythmes des 7 derniers jours, s'il y en a au moins 4 ; sinon l'horizon est inconnu. Jours restants = libre / rythme. Un rythme ≤ 0 : le disque ne se remplit pas (`filling = False`). La médiane écarte un bloc isolé (le 31/08 sur WEISSHORN) ou une purge. + +## 6. La matrice : du niveau et de l'horizon à la couleur + +L'horizon est la classe de `DAYS_UNTIL_STORAGE_FULL` : moins de 14 jours, moins de 60 jours, 60 jours ou plus (ou disque qui ne se remplit pas), ou inconnu. Seuils de jours **arbitraires** (D-035). + +| État \ Horizon | ≥ 60 j ou ne se remplit pas | < 60 j | < 14 j | inconnu | +|---|---|---|---|---| +| `OK` | 🟢 | 🟠 | 🔴 | ⚪ | +| `LOW` | 🟠 | 🟠 | 🔴 | 🟠 | +| `CRITICAL` | 🔴 | 🔴 | 🔴 | 🔴 | + +- **Lecture** : la pire des deux analyses. Orange ou rouge peut venir d'une seule ; vert demande les deux. Un état inconnu donne un jour gris. +- **Pourquoi deux analyses** : le niveau voit un bloc ponctuel que l'estimation ne prévoit pas ; l'estimation voit un disque qui fond alors que le niveau est encore confortable. +- **WEISSHORN** (09/08 au 13/10/2026) : 52 jours 🟢, 14 ⚪ (jusqu'au 22/08), aucun 🟠 ni 🔴. + +## 7. Lire la figure + +`python3 src/storage/final.py` écrit `out/_storage_daily.html` et sa figure en JSON (`.json`, pour `Plotly.newPlot`). C'est l'historique complet du bloc Storage. La page de comparaison (`python3 src/storage/all_analyses.py`, `out/_storage.html`) reprend les mêmes panneaux, avec les séries du disque dessous. + +- **Panneau `DAILY_STORAGE_STATE`** : `free space (end of day)` en %, les planchers de 20 % et 10 % en tirets, l'état en marqueurs (● vert `OK`, ◆ jaune `LOW`, ✕ violet `CRITICAL`). +- **Panneau `DAYS_UNTIL_STORAGE_FULL`** : `days until full`, un point par jour estimé. +- **Survol** : tous les faits calculés du jour (rythme en MiB/jour, date estimée, nombre de rythmes dans la fenêtre). +- **Attention aux couleurs** : celles des panneaux distinguent les états, ce ne sont pas celles de la matrice. + +## 8. Limites à connaître + +1. **Seuils arbitraires** : 20 % et 10 % libres, 60 et 14 jours (D-034, D-035). Questions en suspens : `docs/storage/domaine/questions-pour-l-expert.md`. +2. **Une seule station**, jamais sous 56 % libres : `LOW`, `CRITICAL`, orange et rouge n'ont jamais été observés ; aucun cas de l'expert. +3. **Un bloc ponctuel n'est pas prévu** : sur un disque à moins de 1,3 GiB libres, le bloc du 31/08 l'aurait rempli sans que l'estimation ne bouge. Seul le niveau le voit, le jour même. +4. **Disque plein : conséquence inconnue**. Une purge automatique ferait que « plein » n'arrive jamais ; si l'acquisition tourne en `root`, elle peut écrire dans la réserve (5,4 % du total sur WEISSHORN). +5. **Projection linéaire** : un changement de schedule met 4 jours à dominer la médiane. +6. **Versions plus anciennes du collecteur** (VERMONT, NORDEND) : pas de mesure de `/data`, donc pas de bloc Storage. diff --git a/maquettes/support/home.py b/maquettes/support/home.py index 767b5df..85aee15 100644 --- a/maquettes/support/home.py +++ b/maquettes/support/home.py @@ -1,9 +1,10 @@ """Maquette côté support « Home » : page d'accueil du site de monitoring (toutes les stations), avec en haut une section -Status. Elle porte une notification par station dont le dernier jour de la fenêtre est Orange ou Red (src/energy/day_color.py, D-020). +Status. Elle porte une notification par station et par domaine dont le dernier jour de la fenêtre est Orange ou Red +(src//day_color.py : Energy, Storage, Cellular ; D-025, D-030). La notification, comme la vignette de la station, mène à la vue client de la station (son menu principal) : -out/maquette_user_energy.html, écrite par maquettes/user/energy.py (à lancer avec les mêmes dates). -Données réelles : VERMONT seule (data/VERMONT/). Les autres stations, noms repris du site, n'ont pas de données dans la maquette. +out/maquette_user_.html, écrite par maquettes/user/summary.py (à lancer avec les mêmes dates). +Données réelles : les stations de data/ (VERMONT, WEISSHORN, NORDEND). Les autres, noms repris du site, n'ont pas de données. Écrit out/maquette_support_home.html et l'ouvre dans le navigateur. Usage : python3 maquettes/support/home.py [AAAA-MM-JJ début] [AAAA-MM-JJ fin] (défaut : 2026-09-18 à 2026-09-28) """ @@ -16,7 +17,9 @@ ROOT = HERE.parent.parent sys.path.insert(0, str(ROOT / "src")) from common.page import open_html # noqa: E402 from common.stations import load_stations # noqa: E402 -from energy import day_color as dc # noqa: E402 +from cellular import day_color as cellular # noqa: E402 +from energy import day_color as energy # noqa: E402 +from storage import day_color as storage # 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) @@ -27,12 +30,11 @@ STATIONS = ["ALLALINHORN", "BREITHORN", "CASTOR", "CLARIDEN", "DOM", "FINSTERAAR "PIZBERNINA", "PIZBUIN", "POLLUX", "RINGELSPITZ", "VERMONT", "WEISSHORN", "ADULA", "ALASKA", "DAMMASTOCK", "FAULHORN", "GRANDCOMBIN", "MARYLAND", "MONTANA", "NADELHORN", "PONT_TREMBLEX-01", "SNCF01", "WILDSTRUBEL", "WYOMING"] -USER_VIEW = {"VERMONT": "maquette_user_energy.html"} # vue client de la station (maquettes/user/) +DOMAINS = {"Energy": energy, "Storage": storage, "Cellular": cellular} # contrat de notification (D-030) NAME = {"RED": "Red", "ORANGE": "Orange"} # couleurs notifiées, la plus grave d'abord ; Green ne notifie rien -HEADLINE = {"RED": "The station is not receiving enough energy.", # mêmes phrases que la vue client - "ORANGE": "The station's energy supply is uncertain."} -series = load_stations([str(ROOT / "data" / "VERMONT")]) +series = load_stations([str(d) for d in sorted((ROOT / "data").iterdir()) if d.is_dir()]) +user_view = lambda name: f"maquette_user_{name}.html" if name in series else "#" # noqa: E731 (maquettes/user/) def spark(v): @@ -55,18 +57,28 @@ for name in STATIONS: f'') continue svg, last = spark(series[name]["BusVoltage"]) - tiles.append(f'
{name}{last:.2f}[V]' + tiles.append(f'
{name}{last:.2f}[V]' f'
{svg}
') +def color_of(dc, station): + """Couleur du dernier jour de la fenêtre pour un domaine ; None si la station n'a pas ses mesures.""" + try: + points = dc.run(series[station])["points"] + except KeyError: # série du domaine absente (VERMONT n'a ni disque ni modem) + return None + return {p["t"].date(): p["facts"]["color"] for p in points}.get(END) + + notes = [] for name in series: - color = {p["t"].date(): p["facts"]["color"] for p in dc.run(series[name])["points"]}.get(END) - if color in NAME: - notes.append((list(NAME).index(color), name, - f'
  • {NAME[color]}{name}Energy' - f'{END.strftime("%a %d %b %Y")}{HEADLINE[color]}' - f'Open {name} →
  • ')) -status = "".join(n[2] for n in sorted(notes)) or '
  • No problem or point of attention.
  • ' + for domain, dc in DOMAINS.items(): + color = color_of(dc, name) + if color in NAME: + notes.append((list(NAME).index(color), name, domain, + f'
  • {NAME[color]}{name}{domain}' + f'{END.strftime("%a %d %b %Y")}{dc.HEADLINE[color]}' + f'Open {name} →
  • ')) +status = "".join(n[-1] for n in sorted(notes)) or '
  • No problem or point of attention.
  • ' html = (HERE / "home_template.html").read_text() for key, value in (("", f"{len(notes)} notification{'s' * (len(notes) != 1)}"), @@ -76,6 +88,6 @@ out = ROOT / "out" / "maquette_support_home.html" out.parent.mkdir(exist_ok=True) out.write_text(html) print(out) -if not (out.parent / USER_VIEW["VERMONT"]).exists(): - print("Vue client absente : lancer python3 maquettes/user/energy.py avec les mêmes dates.") +if not all((out.parent / user_view(name)).exists() for name in series): + print("Vue client absente : lancer python3 maquettes/user/summary.py avec les mêmes dates.") open_html(out) diff --git a/maquettes/user/energy.py b/maquettes/user/energy.py deleted file mode 100644 index 22fabcb..0000000 --- a/maquettes/user/energy.py +++ /dev/null @@ -1,62 +0,0 @@ -"""Maquette côté client « Energy » : page System Summary du site de monitoring, avec une section Diagnostic (D-020 à D-023). - -Données réelles VERMONT. Bloc Energy : couleur du dernier jour de la fenêtre, échelle de batterie et tendance face à la veille -(src/energy/day_color.py), puis historique complet (energy.final.daily_figure, D-021) et guide (partie 1 du manuel), repliés. -Écrit out/maquette_user_energy.html et l'ouvre dans le navigateur. -Usage : python3 maquettes/user/energy.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 energy import battery_state as bs, battery_trend as bt, day_color as dc # noqa: E402 -from energy.final import daily_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) - -series = load_stations([str(ROOT / "data" / "VERMONT")])["VERMONT"] -v = series["BusVoltage"] -in_window = lambda t: START <= t.date() <= END # noqa: E731 - -hours = [[t.isoformat(), v[t]] for t in sorted(v) if in_window(t)] -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] - table.append([metric, f"{last[-1]:.2f} [unknown]" if last else "—"]) - -facts = {p["t"].date(): p["facts"] for p in dc.run(series)["points"]} -# Guide : partie 1 du manuel (lecture rapide, pour le client), relue à chaque génération ; titres décalés de deux niveaux. -manual = (ROOT / "docs" / "energy" / "guide" / "diagnostic-energetique.md").read_text() -part1 = manual[manual.index("# Partie 1"):manual.index("# Partie 2")].split("\n", 1)[1] # sans son titre -guide = re.sub(r"^#", "###", part1.rstrip().removesuffix("---"), flags=re.M) -data = {"hours": hours, "daily": list(daily.values()), "table": table, "guide": guide, - "range": [START.isoformat(), (END + timedelta(days=1)).isoformat()], - "energy": {"cur": facts.get(END), "label": END.strftime("%a %d %b %Y")}, - "rule": {"full_charge_v": bs.FULL_CHARGE_V, "plateau_floor_v": bs.PLATEAU_FLOOR_V, "min_rise_v": bs.MIN_RISE_V, - "deadband_v": bt.NIGHT_END_DEADBAND_V}} -html = (HERE / "energy_template.html").read_text() -for key, value in (("/*DATA*/null", json.dumps(data)), - ("/*DAILY*/null", daily_figure("VERMONT", series).to_json()), - ("/*AUTOSCALE*/", AUTOSCALE_Y_JS.replace("{plot_id}", "daily"))): - html = html.replace(key, value) -out = ROOT / "out" / "maquette_user_energy.html" -out.parent.mkdir(exist_ok=True) -out.write_text(html) -print(out) -open_html(out) diff --git a/maquettes/user/summary.py b/maquettes/user/summary.py new file mode 100644 index 0000000..4212f8b --- /dev/null +++ b/maquettes/user/summary.py @@ -0,0 +1,91 @@ +"""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) diff --git a/maquettes/user/energy_template.html b/maquettes/user/summary_template.html similarity index 61% rename from maquettes/user/energy_template.html rename to maquettes/user/summary_template.html index 0e6e528..1fee591 100644 --- a/maquettes/user/energy_template.html +++ b/maquettes/user/summary_template.html @@ -3,11 +3,11 @@ -AIMsight Energy +AIMsight System Summary