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,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.
|
||||
Reference in new issue
Block a user