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/<domaine>/guide/. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
28d441889f
commit
f0990c16e6
22 files changed
+682
-246
No files matched your search
@@ -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/<domaine>/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, "<Domaine>": <domaine>.day_color}`, parcouru pour les notifications (D-030).
|
||||
- Figure du site : `src/<domaine>/final.py`, sur le modèle de `src/cellular/final.py` (D-021, D-039), en anglais : `daily_figure(station, series)` et `out/<STATION>_<domaine>_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/<domaine>/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/<domaine>/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).
|
||||
@@ -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/<règle en minuscu
|
||||
| `DAILY_SIGNAL_STATE` | Chaque jour : médianes du RSRP et du RSRQ sur la grille publiée (excellent, bon, moyen, limite de cellule) | prototype (D-031) | `signal_state.py` |
|
||||
|
||||
- **Couleur du jour** : `src/cellular/day_color.py` (`MATRIX[lien][signal]`, `HEADLINE`), transcription de `docs/cellular/matrice-lien-signal.drawio` (D-037).
|
||||
- **Livré (D-039)** : figure du site `src/cellular/final.py` (panneaux partagés avec la page de comparaison), guide `docs/cellular/guide/diagnostic-cellulaire.md`.
|
||||
|
||||
## Analyses (domaine Storage)
|
||||
|
||||
@@ -57,6 +58,7 @@ Code dans `src/storage/`, fiche dans `docs/storage/analyses/<règle en minuscule
|
||||
| `DAYS_UNTIL_STORAGE_FULL` | Chaque jour : dans combien de jours le disque sera-t-il plein, au rythme médian des 7 derniers jours ? | prototype (D-034) | `days_until_full.py` |
|
||||
|
||||
- **Couleur du jour** : `src/storage/day_color.py` (`MATRIX[état][horizon]`, `HEADLINE`), transcription de `docs/storage/matrice-etat-horizon.drawio` (D-035).
|
||||
- **Livré (D-039)** : figure du site `src/storage/final.py` (panneaux partagés avec la page de comparaison), guide `docs/storage/guide/diagnostic-stockage.md`.
|
||||
|
||||
## Commandes
|
||||
|
||||
@@ -64,17 +66,19 @@ Code dans `src/storage/`, fiche dans `docs/storage/analyses/<règle en minuscule
|
||||
python3 src/energy/final.py [données] # livré : out/<STATION>_daily.html + .json (figure du site, D-021)
|
||||
python3 src/energy/all_analyses.py [données] # les 4 analyses comparées (D-016) : out/<STATION>_energy.html
|
||||
python3 src/energy/focus_jour.py JJ.MM[.AAAA] [données] # un jour et sa veille (D-024) : faits + out/<STATION>_focus_<AAAA-MM-JJ>.html + .json
|
||||
python3 src/cellular/all_analyses.py [données] # analyses 4G comparées : out/<STATION>_cellular.html (défaut data/WEISSHORN/ et data/NORDEND/)
|
||||
python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/<STATION>_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/<STATION>_cellular_daily.html + .json (défaut data/WEISSHORN/ et data/NORDEND/)
|
||||
python3 src/cellular/all_analyses.py [données] # analyses 4G comparées : out/<STATION>_cellular.html (même défaut)
|
||||
python3 src/storage/final.py [données] # livré : out/<STATION>_storage_daily.html + .json (défaut data/WEISSHORN/)
|
||||
python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/<STATION>_storage.html (même défaut)
|
||||
python3 maquettes/user/summary.py [début] [fin] # maquette client : out/maquette_user_<STATION>.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/<fichier>.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.
|
||||
|
||||
@@ -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>/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/<STATION>/` |
|
||||
| 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
|
||||
|
||||
|
||||
@@ -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).
|
||||
@@ -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).
|
||||
@@ -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/<STATION>_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/<STATION>_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.
|
||||
+20
-2
@@ -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 <station> » 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_<STATION>.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 <date> (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/<domaine>/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/<STATION>_<domaine>_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.
|
||||
@@ -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).
|
||||
@@ -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).
|
||||
@@ -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/<STATION>_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/<STATION>_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.
|
||||
+30
-18
@@ -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/<domaine>/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_<STATION>.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'</div><svg></svg></div>')
|
||||
continue
|
||||
svg, last = spark(series[name]["BusVoltage"])
|
||||
tiles.append(f'<a class="tile" href="{USER_VIEW.get(name, "#")}"><div class="tile-head">{name}<span>{last:.2f}[V]</span>'
|
||||
tiles.append(f'<a class="tile" href="{user_view(name)}"><div class="tile-head">{name}<span>{last:.2f}[V]</span>'
|
||||
f'</div>{svg}</a>')
|
||||
|
||||
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'<li><span class="status {color}">{NAME[color]}</span><b>{name}</b><span>Energy</span>'
|
||||
f'<span class="meta">{END.strftime("%a %d %b %Y")}</span><span>{HEADLINE[color]}</span>'
|
||||
f'<a href="{USER_VIEW.get(name, "#")}">Open {name} →</a></li>'))
|
||||
status = "".join(n[2] for n in sorted(notes)) or '<li class="empty">No problem or point of attention.</li>'
|
||||
for domain, dc in DOMAINS.items():
|
||||
color = color_of(dc, name)
|
||||
if color in NAME:
|
||||
notes.append((list(NAME).index(color), name, domain,
|
||||
f'<li><span class="status {color}">{NAME[color]}</span><b>{name}</b><span>{domain}</span>'
|
||||
f'<span class="meta">{END.strftime("%a %d %b %Y")}</span><span>{dc.HEADLINE[color]}</span>'
|
||||
f'<a href="{user_view(name)}">Open {name} →</a></li>'))
|
||||
status = "".join(n[-1] for n in sorted(notes)) or '<li class="empty">No problem or point of attention.</li>'
|
||||
|
||||
html = (HERE / "home_template.html").read_text()
|
||||
for key, value in (("<!--COUNT-->", 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)
|
||||
@@ -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)
|
||||
@@ -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/<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
|
||||
du jour et échelle du signal), puis historique complet (src/<domaine>/final.py, D-021) et guide (partie 1), repliés.
|
||||
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
|
||||
|
||||
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-->", 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)
|
||||
@@ -3,11 +3,11 @@
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>AIMsight Energy</title>
|
||||
<title>AIMsight System Summary</title>
|
||||
<script src="https://cdn.plot.ly/plotly-4.1.1.min.js"></script>
|
||||
<script src="https://cdn.jsdelivr.net/npm/marked@12.0.2/marked.min.js"></script>
|
||||
<style>
|
||||
/* Maquette côté client : page System Summary + section Diagnostic (D-020 à D-023). Données injectées par energy.py. */
|
||||
/* Maquette côté client : page System Summary + section Diagnostic (D-020 à D-023, D-039). Données injectées par summary.py. */
|
||||
:root {
|
||||
--sidebar: #2a3f54; --topbar: #ededed; --page: #f7f7f7; --panel-border: #e6e9ed;
|
||||
--muted: #73879c; --text: #333; --line: #dee2e6;
|
||||
@@ -43,10 +43,11 @@
|
||||
.panel-title h2 small { font-size: 14px; margin-left: 10px; }
|
||||
.panel-title .tools { margin-left: auto; color: #c5c7cb; }
|
||||
|
||||
/* Ajout : section Diagnostic, une ligne repliable par diagnostic (ici : énergie). */
|
||||
/* Ajout : section Diagnostic, une ligne repliable par domaine (Energy, Storage, Cellular). */
|
||||
.diag { margin: 22px 22px 0; }
|
||||
.diag > h3 { margin: 0 0 8px; font-size: 12px; font-weight: bold; letter-spacing: .4px; text-transform: uppercase; }
|
||||
.diag-item { border: 1px solid var(--line); border-radius: 4px; }
|
||||
.diag-item + .diag-item { margin-top: 8px; }
|
||||
.diag-item > summary { list-style: none; cursor: pointer; display: flex; align-items: center; gap: 14px;
|
||||
padding: 10px 14px; color: var(--text); font-size: 15px; }
|
||||
.diag-item > summary::-webkit-details-marker { display: none; }
|
||||
@@ -61,11 +62,9 @@
|
||||
.days { border-collapse: collapse; color: var(--text); }
|
||||
.days th, .days td { padding: 5px 28px 5px 0; text-align: left; font-weight: normal; vertical-align: top; }
|
||||
.days th { color: var(--muted); }
|
||||
/* Échelle de batterie : Off < 10 %, Low < 30 %, OK < 90 %, Full ; le trait marque le niveau de ce matin. */
|
||||
/* Échelle (batterie, espace libre, signal) : zones teintées, le trait marque la valeur du jour. */
|
||||
.gauge { position: relative; display: flex; width: 320px; font-size: 10px; color: var(--muted); }
|
||||
.gauge span { border-top: 10px solid; padding-top: 2px; text-align: center; }
|
||||
.gauge span:nth-child(1) { border-color: #f1c0c0; } .gauge span:nth-child(2) { border-color: #f8dca8; }
|
||||
.gauge span:nth-child(3) { border-color: #e4ebdc; } .gauge span:nth-child(4) { border-color: #bfe0bf; }
|
||||
.gauge span { border-top: 10px solid; padding-top: 2px; text-align: center; white-space: nowrap; }
|
||||
.gauge i { position: absolute; top: -3px; height: 16px; width: 3px; margin-left: -1.5px; background: var(--text); border-radius: 2px; }
|
||||
.gauge-text { margin-top: 6px; }
|
||||
/* Guide : partie 1 du manuel, rendue depuis le Markdown. */
|
||||
@@ -82,7 +81,7 @@
|
||||
.action button { background: #2a78d6; color: #fff; border: 0; border-radius: 4px; padding: 7px 12px;
|
||||
font: inherit; font-size: 14px; cursor: pointer; }
|
||||
.sub > summary { cursor: pointer; color: var(--muted); }
|
||||
#daily { margin-top: 10px; }
|
||||
.plot { margin-top: 10px; }
|
||||
|
||||
.collapse { margin: 22px 22px 0; border-top: 1px solid var(--line); border-bottom: 1px solid var(--line);
|
||||
padding: 9px 0; display: flex; justify-content: space-between; color: var(--text); font-size: 15px; }
|
||||
@@ -125,37 +124,40 @@
|
||||
<main>
|
||||
<section class="panel">
|
||||
<div class="panel-title">
|
||||
<h2>VERMONT<small>System Summary</small></h2>
|
||||
<h2><!--STATION--><small>System Summary</small></h2>
|
||||
<span class="tools"><svg class="i"><use href="#wrench"/></svg> ▾</span>
|
||||
</div>
|
||||
|
||||
<section class="diag">
|
||||
<section class="diag" id="diag">
|
||||
<h3>Diagnostic</h3>
|
||||
<details class="diag-item" id="energy">
|
||||
</section>
|
||||
<!-- Un bloc par domaine, rempli par le script ci-dessous ; le bouton d'action ne sert qu'à Energy. -->
|
||||
<template id="diag-item">
|
||||
<details class="diag-item">
|
||||
<summary>
|
||||
<b>Energy</b>
|
||||
<span class="status" id="status"></span>
|
||||
<span class="meta" id="meta"></span>
|
||||
<b class="name"></b>
|
||||
<span class="status"></span>
|
||||
<span class="meta"></span>
|
||||
<svg class="i chev"><use href="#chev"/></svg>
|
||||
</summary>
|
||||
<div class="diag-body">
|
||||
<p class="headline" id="headline"></p>
|
||||
<table class="days" id="today"></table>
|
||||
<div class="action" id="action" hidden>
|
||||
<button type="button" id="save-mode">Activate energy save mode</button>
|
||||
<span class="meta" id="save-note">The station sleeps between measurements to use less energy.</span>
|
||||
<p class="headline"></p>
|
||||
<table class="days"></table>
|
||||
<div class="action" hidden>
|
||||
<button type="button">Activate energy save mode</button>
|
||||
<span class="note meta">The station sleeps between measurements to use less energy.</span>
|
||||
</div>
|
||||
<details class="sub" id="history">
|
||||
<details class="sub history">
|
||||
<summary>Full history</summary>
|
||||
<div id="daily"></div>
|
||||
<div class="plot"></div>
|
||||
</details>
|
||||
<details class="sub" id="guide">
|
||||
<details class="sub">
|
||||
<summary>Guide</summary>
|
||||
<div class="guide" id="guide-body"></div>
|
||||
<div class="guide"></div>
|
||||
</details>
|
||||
</div>
|
||||
</details>
|
||||
</section>
|
||||
</template>
|
||||
|
||||
<div class="collapse">BusVoltage <svg><use href="#chev"/></svg></div>
|
||||
<div id="chart"></div>
|
||||
@@ -167,20 +169,24 @@
|
||||
|
||||
<script>
|
||||
const DATA = /*DATA*/null;
|
||||
const DAILY = /*DAILY*/null; // figure de DAILY_BATTERY_STATE et DAILY_BATTERY_TREND (D-021), telle que le site la reçoit
|
||||
const R = DATA.rule, E = DATA.energy, cur = E.cur || {};
|
||||
const R = DATA.rule;
|
||||
const NAME = { GREEN: "Green", ORANGE: "Orange", RED: "Red" };
|
||||
const ACTION = { GREEN: "Nothing to do", ORANGE: "Watch", RED: "Contact support" };
|
||||
// Une phrase de très haut niveau, sans détail (manuel, partie 1, § 2).
|
||||
const HEADLINE = {
|
||||
GREEN: "The station is receiving enough energy.",
|
||||
ORANGE: "The station's energy supply is uncertain.",
|
||||
RED: "The station is not receiving enough energy.",
|
||||
};
|
||||
// Nom du bloc, et ce qu'il évalue (phrase d'un jour inconnu). Les phrases des couleurs viennent de src/<domaine>/day_color.py.
|
||||
const DOMAIN = { energy: ["Energy", "energy"], storage: ["Storage", "storage space"], cellular: ["Cellular", "4G connection"] };
|
||||
const TREND = { BETTER: "↗ Better than the day before", STABLE: "→ Same as the day before", WORSE: "↘ Worse than the day before" };
|
||||
|
||||
// Échelle de batterie : niveau de fin de nuit (le meilleur repère du niveau, docs/energy/domaine/comment-se-comporte-la-batterie.md),
|
||||
// placé en % par la table OCV LiFePO4 du collecteur (docs/aimsight/collecteur_system_info.py, LIFEPO4_OCV_SOC).
|
||||
// Échelle : zones [borne haute en %, nom, teinte, ...], trait à pct %, texte dessous ; le survol donne la valeur mesurée.
|
||||
const TINT = { bad: "#f1c0c0", low: "#f8dca8", ok: "#e4ebdc", good: "#bfe0bf" };
|
||||
const scale = (zones, pct, text, title = "") =>
|
||||
`<div class="gauge" role="img" aria-label="${text}" title="${title}">` +
|
||||
zones.map(([hi, name, tint], i) =>
|
||||
`<span style="width:${hi - (i ? zones[i - 1][0] : 0)}%;border-color:${TINT[tint]}">${name}</span>`).join("") +
|
||||
`<i style="left:${pct}%"></i></div><div class="gauge-text">${text}</div>`;
|
||||
|
||||
// Energy. Échelle de batterie : niveau de fin de nuit (le meilleur repère du niveau,
|
||||
// docs/energy/domaine/comment-se-comporte-la-batterie.md), placé en % par la table OCV LiFePO4 du collecteur
|
||||
// (docs/aimsight/collecteur_system_info.py, LIFEPO4_OCV_SOC).
|
||||
// ponytail: sans compensation IR (la nuit, ~0,14 V sous la tension à vide) : repère un peu bas ; compenser avec BusCurrent si besoin.
|
||||
const OCV = [[10.0, 0], [12.0, 10], [12.5, 20], [12.8, 30], [12.9, 40], [13.0, 50], [13.1, 60], [13.2, 70], [13.3, 80],
|
||||
[13.4, 90], [13.6, 100]];
|
||||
@@ -193,42 +199,88 @@ const soc = x => {
|
||||
};
|
||||
// Zones, aux points de la table : 10 % = 12,0 V (la station s'éteint dessous), 30 % = coude 12,8 V, 90 % = 13,4 V.
|
||||
// Pas de % affiché : sur le plateau (30-90 %), 0,1 V vaut ~10 % de charge, la tension n'en dit pas plus.
|
||||
const ZONES = [[10, "Off", "nearly empty, the station may shut down"], [30, "Low", "low (under 30 %)"],
|
||||
[90, "OK", "between 30 and 90 %"], [100, "Full", "full"]];
|
||||
const ZONES = [[10, "Off", "bad", "nearly empty, the station may shut down"], [30, "Low", "low", "low (under 30 %)"],
|
||||
[90, "OK", "ok", "between 30 and 90 %"], [100, "Full", "good", "full"]];
|
||||
const recharge = d => d.max_v == null ? "" : d.max_v >= R.full_charge_v ? "fully recharged today"
|
||||
: d.rise_v >= R.min_rise_v ? "partially recharged today" : "not recharged today";
|
||||
function gauge(d) {
|
||||
function battery(d) {
|
||||
if (d.night_end_v == null) return "Unknown";
|
||||
const pct = soc(d.night_end_v), zone = ZONES.find(z => pct < z[0]) || ZONES[ZONES.length - 1];
|
||||
const text = `This morning: ${zone[2]} · ${recharge(d)}`;
|
||||
return `<div class="gauge" role="img" aria-label="${text}" title="night end ${d.night_end_v.toFixed(3)} V">` +
|
||||
ZONES.map(([hi, name], i) => `<span style="width:${hi - (i ? ZONES[i - 1][0] : 0)}%">${name}</span>`).join("") +
|
||||
`<i style="left:${pct}%"></i></div><div class="gauge-text">${text}</div>`;
|
||||
return scale(ZONES, pct, `This morning: ${zone[3]} · ${recharge(d)}`, `night end ${d.night_end_v.toFixed(3)} V`);
|
||||
}
|
||||
|
||||
// Storage. Échelle de l'espace libre en fin de jour, sur les planchers de DAILY_STORAGE_STATE (arbitraires, D-034).
|
||||
function freeSpace(d) {
|
||||
if (d.free_percent == null) return "Unknown";
|
||||
const [ok, low] = R.storage_floors;
|
||||
return scale([[low, "Critical", "bad"], [ok, "Low", "low"], [100, "OK", "good"]], d.free_percent,
|
||||
`${Math.round(d.free_percent)} % free`, `${d.free_gb} GiB free of ${d.usable_gb} GiB usable`);
|
||||
}
|
||||
// Date de saturation au rythme des 7 derniers jours (DAYS_UNTIL_STORAGE_FULL) ; en mois au-delà de 60 jours (affichage).
|
||||
const day = s => new Date(s).toLocaleDateString("en-GB", { day: "2-digit", month: "short", year: "numeric", timeZone: "UTC" });
|
||||
function full(d) {
|
||||
if (d.filling == null) return "Unknown (not enough days measured yet)";
|
||||
if (!d.filling) return "Not expected: the storage is not filling up";
|
||||
const n = d.days_until_full;
|
||||
return `Around ${day(d.full_date)} (about ${n < 60 ? `${Math.round(n)} days` : `${Math.round(n / 30)} months`})`;
|
||||
}
|
||||
|
||||
// Cellular. Envois du jour (DAILY_LINK_STATE), en mots, sur les envois attendus (un toutes les 15 min).
|
||||
function sends(d) {
|
||||
if (d.state == null) return "Unknown (incomplete day)";
|
||||
const missing = d.n_missing ? `${d.n_missing} of ${R.expected_sends} sends missing` : "";
|
||||
if (d.state === "DOWN") return ["4G link reported down", missing].filter(Boolean).join(" · ");
|
||||
if (d.state === "MISSING") return missing || "Some data missing";
|
||||
return "All data received";
|
||||
}
|
||||
// Échelle du signal (DAILY_SIGNAL_STATE, grille publiée) : quatre classes de même largeur, trait au milieu de la classe du jour,
|
||||
// sans dBm. La classe ne change pas la couleur du jour tant que le signal est mesuré (D-037).
|
||||
const SIGNAL = [[25, "Cell edge", "low"], [50, "Mid cell", "ok"], [75, "Good", "ok"], [100, "Excellent", "good"]];
|
||||
function signal(d) {
|
||||
if (d.signal_state == null) return "Unknown (not measured for most of the day)";
|
||||
const i = R.signal_classes.length - 1 - R.signal_classes.indexOf(d.signal_state); // CLASSES va du meilleur au pire
|
||||
return scale(SIGNAL, 25 * i + 12.5, SIGNAL[i][1]);
|
||||
}
|
||||
|
||||
// Deux lignes par bloc, en mots simples (côté client : pas de tension brute, pas de mécanisme d'analyse).
|
||||
const ROWS = {
|
||||
energy: d => [["Battery", battery(d)], ["Trend", TREND[d.trend] || "Unknown"]],
|
||||
storage: d => [["Free space", freeSpace(d)], ["Full", full(d)]],
|
||||
cellular: d => [["Data sent", sends(d)], ["Signal", signal(d)]],
|
||||
};
|
||||
const chip = c => `<span class="status ${c || "UNKNOWN"}">${NAME[c] || "Unknown"}</span>`;
|
||||
function autoscale(plotId) {
|
||||
/*AUTOSCALE*/
|
||||
}
|
||||
|
||||
// Bloc Energy : la couleur du jour, l'échelle de batterie et la tendance face à la veille.
|
||||
document.getElementById("status").outerHTML = chip(cur.color);
|
||||
document.getElementById("meta").textContent = `${E.label} · ${ACTION[cur.color] || "Check data"}`;
|
||||
document.getElementById("headline").textContent = HEADLINE[cur.color] || "Not enough data to assess the station's energy.";
|
||||
document.getElementById("today").innerHTML = [["Battery", gauge(cur)], ["Trend", TREND[cur.trend] || "Unknown"]]
|
||||
.map(([k, x]) => `<tr><th>${k}</th><td>${x}</td></tr>`).join("");
|
||||
document.getElementById("guide-body").innerHTML = marked.parse(DATA.guide); // texte du projet, pas une saisie
|
||||
// Remède proposé au client quand l'énergie manque : veille profonde entre les mesures
|
||||
// (docs/energy/domaine/comment-se-comporte-la-batterie.md). Action de la plateforme, pas du diagnostic (lecture seule).
|
||||
// Maquette : le bouton n'envoie rien.
|
||||
document.getElementById("action").hidden = !["ORANGE", "RED"].includes(cur.color);
|
||||
document.getElementById("save-mode").onclick = () =>
|
||||
document.getElementById("save-note").textContent = "Mockup: no command is sent to the station.";
|
||||
|
||||
// L'historique complet n'est tracé qu'à la première ouverture (un graphique caché n'a pas de largeur).
|
||||
document.getElementById("history").addEventListener("toggle", e => {
|
||||
if (!e.target.open || e.target.dataset.drawn) return;
|
||||
e.target.dataset.drawn = "1";
|
||||
Plotly.newPlot("daily", DAILY.data, DAILY.layout, { responsive: true, scrollZoom: true }).then(() => {
|
||||
/*AUTOSCALE*/
|
||||
for (const [key, dom] of Object.entries(DATA.domains)) {
|
||||
const cur = dom.cur || {}, c = cur.color, [name, what] = DOMAIN[key];
|
||||
const el = document.getElementById("diag-item").content.firstElementChild.cloneNode(true);
|
||||
el.id = key;
|
||||
el.querySelector(".name").textContent = name;
|
||||
el.querySelector(".status").outerHTML = chip(c);
|
||||
el.querySelector(".meta").textContent = `${DATA.label} · ${ACTION[c] || "Check data"}`;
|
||||
el.querySelector(".headline").textContent = dom.headline[c] || `Not enough data to assess the station's ${what}.`;
|
||||
el.querySelector(".days").innerHTML = ROWS[key](cur).map(([k, x]) => `<tr><th>${k}</th><td>${x}</td></tr>`).join("");
|
||||
el.querySelector(".guide").innerHTML = marked.parse(dom.guide); // texte du projet, pas une saisie
|
||||
// Energy, jours Orange et Red : remède proposé au client, veille profonde entre les mesures
|
||||
// (docs/energy/domaine/comment-se-comporte-la-batterie.md). Action de la plateforme, pas du diagnostic (lecture seule).
|
||||
// Maquette : le bouton n'envoie rien. Storage et Cellular n'ont pas de remède connu : pas de bouton.
|
||||
const action = el.querySelector(".action");
|
||||
action.hidden = key !== "energy" || !["ORANGE", "RED"].includes(c);
|
||||
action.querySelector("button").onclick = () =>
|
||||
action.querySelector(".note").textContent = "Mockup: no command is sent to the station.";
|
||||
// L'historique complet n'est tracé qu'à la première ouverture (un graphique caché n'a pas de largeur).
|
||||
const plot = el.querySelector(".plot");
|
||||
plot.id = `plot-${key}`;
|
||||
el.querySelector(".history").addEventListener("toggle", e => {
|
||||
if (!e.target.open || e.target.dataset.drawn) return;
|
||||
e.target.dataset.drawn = "1";
|
||||
Plotly.newPlot(plot, dom.figure.data, dom.figure.layout, { responsive: true, scrollZoom: true })
|
||||
.then(() => autoscale(plot.id));
|
||||
});
|
||||
});
|
||||
document.getElementById("diag").append(el);
|
||||
}
|
||||
|
||||
document.getElementById("table").innerHTML =
|
||||
DATA.table.map(([k, x]) => `<tr><td>${k}</td><td>${x}</td></tr>`).join("");
|
||||
@@ -11,60 +11,18 @@ from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule
|
||||
from common.stations import gaps, load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from cellular import link_state as ls, signal_state as ss # noqa: E402
|
||||
from energy.final import noon # noqa: E402 (points journaliers à midi UTC, D-019)
|
||||
from cellular.final import TITLES, analysis_panels # noqa: E402 (panneaux partagés avec la figure du site)
|
||||
|
||||
# Couleurs validées par le skill dataviz (toutes paires, fond blanc ; vert/rouge refusé : deutéranopie).
|
||||
# Le jaune contraste peu avec le fond : chaque état a aussi son symbole, sa légende et son survol.
|
||||
GRAY = ("#8c8c8c", "circle-open")
|
||||
LINK_STYLE = {"UP": ("#008300", "circle"), "MISSING": ("#eda100", "diamond"), "DOWN": ("#4a3aa7", "x"), None: GRAY}
|
||||
CLASS_STYLE = {"EXCELLENT": ("#008300", "circle"), "GOOD": ("#2a78d6", "square"),
|
||||
"MID_CELL": ("#eda100", "diamond"), "CELL_EDGE": ("#4a3aa7", "x"), None: GRAY}
|
||||
METRICS = ["rsrp_dBm", "rsrq_dB", "rssi_dbm", "ber_percent"] # liste explicite : jamais SIM_CCID ni ip
|
||||
|
||||
|
||||
def hover(p):
|
||||
return f"{p['t']:%Y-%m-%d}<br>" + "<br>".join(f"{k}={v}" for k, v in p["facts"].items())
|
||||
|
||||
|
||||
def state_markers(fig, pts, y_key, state_key, styles, row, group):
|
||||
"""Un marqueur par jour à midi, une trace par état (légende et symbole propres)."""
|
||||
for state, (color, symbol) in styles.items():
|
||||
sel = [p for p in pts if p["facts"].get(state_key) == state and p["facts"].get(y_key) is not None]
|
||||
if sel:
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"][y_key] for p in sel],
|
||||
name=f"{state or 'inconnu'}", mode="markers", text=[hover(p) for p in sel],
|
||||
hovertemplate="%{text}<extra></extra>",
|
||||
marker=dict(color=color, symbol=symbol, size=9, line=dict(color="white", width=1)),
|
||||
row=row, col=1, **group)
|
||||
|
||||
|
||||
def floors_panel(fig, result, row, y_key, class_key, floors, unit):
|
||||
"""Panneau DAILY_SIGNAL_STATE pour une mesure : médiane du jour, planchers de la grille, classe en marqueurs."""
|
||||
group = dict(legendgroup=f"{result['analysis']} {unit}", legendgrouptitle_text=f"{result['analysis']} ({unit})")
|
||||
pts = result["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["facts"].get(y_key) for p in pts], name="médiane du jour", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group)
|
||||
# Planchers tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
|
||||
for f, c in zip(floors, ss.CLASSES):
|
||||
fig.add_scatter(x=x, y=[f] * len(x), name=f"plancher {c} {f} {unit}", mode="lines", hoverinfo="skip",
|
||||
line=dict(color=CLASS_STYLE[c][0], dash="dash", width=1), row=row, col=1, **group)
|
||||
state_markers(fig, pts, y_key, class_key, CLASS_STYLE, row, group)
|
||||
fig.update_yaxes(title_text=f"médiane du jour [{unit}]", row=row, col=1)
|
||||
|
||||
|
||||
def figure(station, series, link, signal):
|
||||
titles = [f"Analyse {ls.RULE['id']}", f"Analyse {ss.RULE['id']} : RSRP", f"Analyse {ss.RULE['id']} : RSRQ"]
|
||||
fig = make_subplots(rows=len(titles) + len(METRICS) + 1, cols=1, shared_xaxes=True, vertical_spacing=0.03,
|
||||
subplot_titles=titles + METRICS + ["envois reçus par heure (last_sync, sinon link)"])
|
||||
group = dict(legendgroup=ls.RULE["id"], legendgrouptitle_text=f"Analyse {ls.RULE['id']}")
|
||||
state_markers(fig, link["points"], "received_percent", "state", LINK_STYLE, 1, group)
|
||||
fig.update_yaxes(title_text="envois reçus [%]", row=1, col=1)
|
||||
floors_panel(fig, signal, 2, "rsrp_median_dbm", "rsrp_class", ss.RSRP_FLOORS_DBM, "dBm")
|
||||
floors_panel(fig, signal, 3, "rsrq_median_db", "rsrq_class", ss.RSRQ_FLOORS_DB, "dB")
|
||||
def figure(station, series):
|
||||
fig = make_subplots(rows=len(TITLES) + len(METRICS) + 1, cols=1, shared_xaxes=True, vertical_spacing=0.03,
|
||||
subplot_titles=TITLES + METRICS + ["envois reçus par heure (last_sync, sinon link)"])
|
||||
analysis_panels(fig, series)
|
||||
|
||||
mesures = dict(legendgroup="mesures", legendgrouptitle_text="Mesures")
|
||||
row = len(titles)
|
||||
row = len(TITLES)
|
||||
for row, m in enumerate(METRICS, start=row + 1):
|
||||
s = series.get(m, {})
|
||||
fig.add_scatter(x=sorted(s), y=[s[t] for t in sorted(s)], name=m, line=dict(width=1), row=row, col=1,
|
||||
@@ -90,7 +48,7 @@ def main(paths):
|
||||
print(f"{station} : ignorée, pas de mesures du modem (rsrp_dBm, et link ou last_sync)")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_cellular.html"
|
||||
figure(station, series, ls.run(series), ss.run(series)).write_html(
|
||||
figure(station, series).write_html(
|
||||
path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
print(path)
|
||||
written.append(path)
|
||||
|
||||
@@ -15,9 +15,10 @@ MATRIX = {
|
||||
"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."}
|
||||
# Une phrase par couleur, en anglais (D-023) ; Green ne notifie rien (D-025), sa phrase ne sert qu'à la vue client.
|
||||
HEADLINE = {"GREEN": "The station sent all its data over 4G.",
|
||||
"ORANGE": "The station's 4G connection showed interruptions.",
|
||||
"RED": "The station stopped sending data for a large part of the day."}
|
||||
|
||||
RULE = {
|
||||
"id": "DAY_COLOR",
|
||||
|
||||
@@ -0,0 +1,103 @@
|
||||
"""Analyses de la couleur du jour Cellular (D-037) : DAILY_LINK_STATE et DAILY_SIGNAL_STATE, en une figure pour le site (D-021).
|
||||
|
||||
Usage : python3 src/cellular/final.py [CSV ou dossiers...] (défaut : data/WEISSHORN/ et data/NORDEND/)
|
||||
Écrit out/<STATION>_cellular_daily.html (page de démo) et .json (figure Plotly pour le site, Plotly.newPlot), puis les ouvre.
|
||||
Documentation : docs/cellular/analyses/daily_link_state.md et daily_signal_state.md ; guide docs/cellular/guide/
|
||||
"""
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets common, energy et cellular
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from cellular import link_state as ls, signal_state as ss # noqa: E402
|
||||
from energy.final import noon # noqa: E402 (points journaliers à midi UTC, D-019)
|
||||
|
||||
# Couleurs validées par le skill dataviz (toutes paires, fond blanc ; vert/rouge refusé : deutéranopie).
|
||||
# Le jaune contraste peu avec le fond : chaque état a aussi son symbole, sa légende et son survol.
|
||||
GRAY = ("#8c8c8c", "circle-open")
|
||||
LINK_STYLE = {"UP": ("#008300", "circle"), "MISSING": ("#eda100", "diamond"), "DOWN": ("#4a3aa7", "x"), None: GRAY}
|
||||
CLASS_STYLE = {"EXCELLENT": ("#008300", "circle"), "GOOD": ("#2a78d6", "square"),
|
||||
"MID_CELL": ("#eda100", "diamond"), "CELL_EDGE": ("#4a3aa7", "x"), None: GRAY}
|
||||
|
||||
|
||||
def hover(p):
|
||||
return f"{p['t']:%Y-%m-%d}<br>" + "<br>".join(f"{k}={v}" for k, v in p["facts"].items())
|
||||
|
||||
|
||||
def state_markers(fig, pts, y_key, state_key, styles, row, group):
|
||||
"""Un marqueur par jour à midi, une trace par état (légende et symbole propres)."""
|
||||
for state, (color, symbol) in styles.items():
|
||||
sel = [p for p in pts if p["facts"].get(state_key) == state and p["facts"].get(y_key) is not None]
|
||||
if sel:
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in sel], y=[p["facts"][y_key] for p in sel],
|
||||
name=f"{state or 'unknown'}", mode="markers", text=[hover(p) for p in sel],
|
||||
hovertemplate="%{text}<extra></extra>",
|
||||
marker=dict(color=color, symbol=symbol, size=9, line=dict(color="white", width=1)),
|
||||
row=row, col=1, **group)
|
||||
|
||||
|
||||
def link_panel(fig, result, row):
|
||||
"""Panneau DAILY_LINK_STATE : part des envois reçus par jour, état en marqueurs (fiche daily_link_state)."""
|
||||
group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analysis {result['analysis']}")
|
||||
state_markers(fig, result["points"], "received_percent", "state", LINK_STYLE, row, group)
|
||||
fig.update_yaxes(title_text="sends received [%]", row=row, col=1)
|
||||
|
||||
|
||||
def floors_panel(fig, result, row, y_key, class_key, floors, unit):
|
||||
"""Panneau DAILY_SIGNAL_STATE pour une mesure : médiane du jour, planchers de la grille, classe en marqueurs."""
|
||||
group = dict(legendgroup=f"{result['analysis']} {unit}", legendgrouptitle_text=f"{result['analysis']} ({unit})")
|
||||
pts = result["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["facts"].get(y_key) for p in pts], name="daily median", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group)
|
||||
# Planchers tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
|
||||
for f, c in zip(floors, ss.CLASSES):
|
||||
fig.add_scatter(x=x, y=[f] * len(x), name=f"{c} floor {f} {unit}", mode="lines", hoverinfo="skip",
|
||||
line=dict(color=CLASS_STYLE[c][0], dash="dash", width=1), row=row, col=1, **group)
|
||||
state_markers(fig, pts, y_key, class_key, CLASS_STYLE, row, group)
|
||||
fig.update_yaxes(title_text=f"daily median [{unit}]", row=row, col=1)
|
||||
|
||||
|
||||
TITLES = [f"Analysis {ls.RULE['id']}", f"Analysis {ss.RULE['id']}: RSRP", f"Analysis {ss.RULE['id']}: RSRQ"]
|
||||
|
||||
|
||||
def analysis_panels(fig, series):
|
||||
"""Les trois panneaux des analyses, rangées 1 à 3 : partagés par la figure du site et la page de comparaison."""
|
||||
link_panel(fig, ls.run(series), 1)
|
||||
signal = ss.run(series)
|
||||
floors_panel(fig, signal, 2, "rsrp_median_dbm", "rsrp_class", ss.RSRP_FLOORS_DBM, "dBm")
|
||||
floors_panel(fig, signal, 3, "rsrq_median_db", "rsrq_class", ss.RSRQ_FLOORS_DB, "dB")
|
||||
|
||||
|
||||
def daily_figure(station, series):
|
||||
"""Graphique pour le site de monitoring : DAILY_LINK_STATE en haut, DAILY_SIGNAL_STATE (RSRP, RSRQ) dessous."""
|
||||
fig = make_subplots(rows=3, cols=1, shared_xaxes=True, vertical_spacing=0.08, subplot_titles=TITLES)
|
||||
analysis_panels(fig, series)
|
||||
fig.update_xaxes(showticklabels=True)
|
||||
fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS
|
||||
fig.update_layout(title=f"{station}: data sent and 4G signal", height=900, legend=dict(groupclick="toggleitem"))
|
||||
return fig
|
||||
|
||||
|
||||
def main(paths):
|
||||
"""Pour chaque station qui a les mesures du modem : out/<STATION>_cellular_daily.html et .json. -> chemins écrits."""
|
||||
(ROOT / "out").mkdir(exist_ok=True)
|
||||
written = []
|
||||
for station, series in sorted(load_stations(paths).items()):
|
||||
if "rsrp_dBm" not in series or not {"link", "last_sync"} & series.keys():
|
||||
print(f"{station} : ignorée, pas de mesures du modem (rsrp_dBm, et link ou last_sync)")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_cellular_daily.html"
|
||||
fig = daily_figure(station, series)
|
||||
fig.write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
fig.write_json(path.with_suffix(".json"))
|
||||
print(path)
|
||||
written.append(path)
|
||||
return written
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
for p in main(sys.argv[1:] or [str(ROOT / "data" / s) for s in ("WEISSHORN", "NORDEND")]):
|
||||
open_html(p)
|
||||
@@ -15,6 +15,12 @@ MATRIX = {
|
||||
"BELOW_PLATEAU": {"BETTER": "RED", "STABLE": "RED", "WORSE": "RED"},
|
||||
}
|
||||
|
||||
# Une phrase par couleur, en anglais (D-023), reprise par la vue client et par les notifications du support.
|
||||
# Green ne notifie rien (D-025) : sa phrase ne sert qu'à la vue client.
|
||||
HEADLINE = {"GREEN": "The station is receiving enough energy.",
|
||||
"ORANGE": "The station's energy supply is uncertain.",
|
||||
"RED": "The station is not receiving enough energy."}
|
||||
|
||||
RULE = {
|
||||
"id": "DAY_COLOR",
|
||||
"verdict": "aucun : anomaly = None ; la couleur est dans facts.color (None = inconnu, état ou tendance absent)",
|
||||
|
||||
@@ -15,7 +15,7 @@ import plotly.graph_objects as go # noqa: E402
|
||||
from energy import battery_state as bs, battery_trend as bt, day_color as dc # noqa: E402
|
||||
from energy.final import STATE_STYLE, TREND_STYLE, noon # noqa: E402
|
||||
|
||||
# Statuts : noms et couleurs de la maquette System Summary (maquettes/user/energy_template.html).
|
||||
# Statuts : noms et couleurs de la maquette System Summary (maquettes/user/summary_template.html).
|
||||
COLOR = {"GREEN": ("Green", "#008300"), "ORANGE": ("Orange", "#eda100"), "RED": ("Red", "#d03b3b"),
|
||||
None: ("Unknown", "#8c8c8c")}
|
||||
# Condition qui a donné l'état (fiche daily_battery_state, « Principe », dans l'ordre d'évaluation).
|
||||
|
||||
@@ -10,40 +10,19 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets c
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import gaps, load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from cellular.all_analyses import GRAY, hover, state_markers # noqa: E402 (mêmes marqueurs que Cellular)
|
||||
from energy.final import noon # noqa: E402 (points journaliers à midi UTC, D-019)
|
||||
from storage import days_until_full as du, storage_state as ss # noqa: E402
|
||||
from storage.final import TITLES, analysis_panels # noqa: E402 (panneaux partagés avec la figure du site)
|
||||
|
||||
# Couleurs de la page Cellular, validées par le skill dataviz.
|
||||
STATE_STYLE = {"OK": ("#008300", "circle"), "LOW": ("#eda100", "diamond"), "CRITICAL": ("#4a3aa7", "x"), None: GRAY}
|
||||
METRICS = ["data_storage_free_gb", "data_storage_used_gb", "data_storage_total_gb"]
|
||||
|
||||
|
||||
def figure(station, series, state, days):
|
||||
titles = [f"Analyse {ss.RULE['id']}", f"Analyse {du.RULE['id']}"]
|
||||
fig = make_subplots(rows=len(titles) + len(METRICS), cols=1, shared_xaxes=True, vertical_spacing=0.04,
|
||||
subplot_titles=titles + METRICS)
|
||||
group = dict(legendgroup=ss.RULE["id"], legendgrouptitle_text=f"Analyse {ss.RULE['id']}")
|
||||
pts = state["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["value"] for p in pts], name="espace libre du jour", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=1, col=1, **group)
|
||||
# Planchers tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
|
||||
for f, s in zip(ss.FREE_PERCENT_FLOORS, ss.STATES):
|
||||
fig.add_scatter(x=x, y=[f] * len(x), name=f"plancher {s} {f} %", mode="lines", hoverinfo="skip",
|
||||
line=dict(color=STATE_STYLE[s][0], dash="dash", width=1), row=1, col=1, **group)
|
||||
state_markers(fig, pts, "free_percent", "state", STATE_STYLE, 1, group)
|
||||
fig.update_yaxes(title_text="libre / utilisable [%]", row=1, col=1)
|
||||
|
||||
pts = [p for p in days["points"] if p["value"] is not None]
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in pts], y=[p["value"] for p in pts], name="jours avant saturation",
|
||||
mode="lines+markers", text=[hover(p) for p in pts], hovertemplate="%{text}<extra></extra>",
|
||||
line=dict(color="#2a78d6", width=1.5), legendgroup=du.RULE["id"],
|
||||
legendgrouptitle_text=f"Analyse {du.RULE['id']}", row=2, col=1)
|
||||
fig.update_yaxes(title_text="jours restants", row=2, col=1)
|
||||
def figure(station, series):
|
||||
fig = make_subplots(rows=len(TITLES) + len(METRICS), cols=1, shared_xaxes=True, vertical_spacing=0.04,
|
||||
subplot_titles=TITLES + METRICS)
|
||||
analysis_panels(fig, series)
|
||||
|
||||
mesures = dict(legendgroup="mesures", legendgrouptitle_text="Mesures")
|
||||
for row, m in enumerate(METRICS, start=len(titles) + 1):
|
||||
for row, m in enumerate(METRICS, start=len(TITLES) + 1):
|
||||
s = series[m]
|
||||
fig.add_scatter(x=sorted(s), y=[s[t] for t in sorted(s)], name=m, line=dict(width=1), row=row, col=1,
|
||||
**mesures)
|
||||
@@ -66,7 +45,7 @@ def main(paths):
|
||||
print(f"{station} : ignorée, pas de mesures du disque ({', '.join(METRICS)})")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_storage.html"
|
||||
figure(station, series, ss.run(series), du.run(series)).write_html(
|
||||
figure(station, series).write_html(
|
||||
path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
print(path)
|
||||
written.append(path)
|
||||
|
||||
@@ -17,9 +17,10 @@ MATRIX = {
|
||||
"CRITICAL": {"BEYOND_60_DAYS": "RED", "WITHIN_60_DAYS": "RED", "WITHIN_14_DAYS": "RED", None: "RED"},
|
||||
}
|
||||
|
||||
# Une phrase par couleur notifiée, en anglais (D-023) ; Green ne notifie rien (D-025).
|
||||
HEADLINE = {"RED": "The station is about to run out of storage space.",
|
||||
"ORANGE": "The station's storage space is running low."}
|
||||
# Une phrase par couleur, en anglais (D-023) ; Green ne notifie rien (D-025), sa phrase ne sert qu'à la vue client.
|
||||
HEADLINE = {"GREEN": "The station has enough storage space.",
|
||||
"ORANGE": "The station's storage space is running low.",
|
||||
"RED": "The station is about to run out of storage space."}
|
||||
|
||||
RULE = {
|
||||
"id": "DAY_COLOR",
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
"""Analyses de la couleur du jour Storage (D-035) : DAILY_STORAGE_STATE et DAYS_UNTIL_STORAGE_FULL, en une figure pour le site (D-021).
|
||||
|
||||
Usage : python3 src/storage/final.py [CSV ou dossiers...] (défaut : data/WEISSHORN/)
|
||||
Écrit out/<STATION>_storage_daily.html (page de démo) et .json (figure Plotly pour le site, Plotly.newPlot), puis les ouvre.
|
||||
Documentation : docs/storage/analyses/daily_storage_state.md et days_until_storage_full.md ; guide docs/storage/guide/
|
||||
"""
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets common, energy, cellular et storage
|
||||
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
from common.stations import load_stations # noqa: E402
|
||||
from plotly.subplots import make_subplots # noqa: E402
|
||||
from cellular.final import GRAY, hover, state_markers # noqa: E402 (mêmes marqueurs que Cellular)
|
||||
from energy.final import noon # noqa: E402 (points journaliers à midi UTC, D-019)
|
||||
from storage import days_until_full as du, storage_state as ss # noqa: E402
|
||||
|
||||
# Couleurs de la page Cellular, validées par le skill dataviz.
|
||||
STATE_STYLE = {"OK": ("#008300", "circle"), "LOW": ("#eda100", "diamond"), "CRITICAL": ("#4a3aa7", "x"), None: GRAY}
|
||||
TITLES = [f"Analysis {ss.RULE['id']}", f"Analysis {du.RULE['id']}"]
|
||||
|
||||
|
||||
def state_panel(fig, result, row):
|
||||
"""Panneau DAILY_STORAGE_STATE : espace libre en fin de jour, planchers, état en marqueurs (fiche daily_storage_state)."""
|
||||
group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analysis {result['analysis']}")
|
||||
pts = result["points"]
|
||||
x = [noon(p["t"].date()) for p in pts]
|
||||
fig.add_scatter(x=x, y=[p["value"] for p in pts], name="free space (end of day)", mode="lines",
|
||||
line=dict(color="#52514e", width=1.5), hoverinfo="skip", row=row, col=1, **group)
|
||||
# Planchers tracés comme des courbes (un point par jour) : AUTOSCALE_Y_JS les garde visibles au zoom (D-013).
|
||||
for f, s in zip(ss.FREE_PERCENT_FLOORS, ss.STATES):
|
||||
fig.add_scatter(x=x, y=[f] * len(x), name=f"{s} floor {f} %", mode="lines", hoverinfo="skip",
|
||||
line=dict(color=STATE_STYLE[s][0], dash="dash", width=1), row=row, col=1, **group)
|
||||
state_markers(fig, pts, "free_percent", "state", STATE_STYLE, row, group)
|
||||
fig.update_yaxes(title_text="free / usable [%]", row=row, col=1)
|
||||
|
||||
|
||||
def days_panel(fig, result, row):
|
||||
"""Panneau DAYS_UNTIL_STORAGE_FULL : jours avant saturation, au rythme médian sur 7 jours (fiche days_until_storage_full)."""
|
||||
pts = [p for p in result["points"] if p["value"] is not None]
|
||||
fig.add_scatter(x=[noon(p["t"].date()) for p in pts], y=[p["value"] for p in pts], name="days until full",
|
||||
mode="lines+markers", text=[hover(p) for p in pts], hovertemplate="%{text}<extra></extra>",
|
||||
line=dict(color="#2a78d6", width=1.5), legendgroup=result["analysis"],
|
||||
legendgrouptitle_text=f"Analysis {result['analysis']}", row=row, col=1)
|
||||
fig.update_yaxes(title_text="days left", row=row, col=1)
|
||||
|
||||
|
||||
def analysis_panels(fig, series):
|
||||
"""Les deux panneaux des analyses, rangées 1 et 2 : partagés par la figure du site et la page de comparaison."""
|
||||
state_panel(fig, ss.run(series), 1)
|
||||
days_panel(fig, du.run(series), 2)
|
||||
|
||||
|
||||
def daily_figure(station, series):
|
||||
"""Graphique pour le site de monitoring : DAILY_STORAGE_STATE en haut, DAYS_UNTIL_STORAGE_FULL dessous."""
|
||||
fig = make_subplots(rows=2, cols=1, shared_xaxes=True, vertical_spacing=0.08, subplot_titles=TITLES)
|
||||
analysis_panels(fig, series)
|
||||
fig.update_xaxes(showticklabels=True)
|
||||
fig.update_yaxes(fixedrange=True) # zoom horizontal seulement : l'ordonnée est recalée par AUTOSCALE_Y_JS
|
||||
fig.update_layout(title=f"{station}: storage space", height=700, legend=dict(groupclick="toggleitem"))
|
||||
return fig
|
||||
|
||||
|
||||
def main(paths):
|
||||
"""Pour chaque station qui a les mesures de /data : out/<STATION>_storage_daily.html et .json. -> chemins écrits."""
|
||||
(ROOT / "out").mkdir(exist_ok=True)
|
||||
written = []
|
||||
for station, series in sorted(load_stations(paths).items()):
|
||||
if "data_storage_free_gb" not in series:
|
||||
print(f"{station} : ignorée, pas de mesures de /data (data_storage_*)")
|
||||
continue
|
||||
path = ROOT / "out" / f"{station}_storage_daily.html"
|
||||
fig = daily_figure(station, series)
|
||||
fig.write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
||||
fig.write_json(path.with_suffix(".json"))
|
||||
print(path)
|
||||
written.append(path)
|
||||
return written
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
for p in main(sys.argv[1:] or [str(ROOT / "data" / "WEISSHORN")]):
|
||||
open_html(p)
|
||||
Reference in new issue
Block a user