Add WEISSHORN as the working set of the Storage and Cellular domains

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 09:26:44 +02:00
1 parent ac2e95a90a
commit ed0a5ae790
1 file changed
+39 -8
@@ -8,7 +8,7 @@
- Faire pour d'autres points d'attention **le même travail qu'Energy** : des analyses sans LLM, un verdict du jour, une notification au client et au support (D-020, D-022, D-025).
- Deux premiers domaines : **l'espace disque restant** et **la qualité du signal 4G**. D'autres suivront peut-être.
- Les données viendront plus tard. Aujourd'hui, on prépare :
- Les données sont arrivées pendant la conception : `data/WEISSHORN/` contient tous les champs de la caméra, sur 10 jours (voir « Jeu de travail »). On les explorera ensuite, pour voir ce qui mérite une notification. Aujourd'hui, on prépare :
- une **procédure réutilisable**, pour ajouter vite un nouveau domaine, donc une nouvelle notification ;
- pour chacun des deux domaines, une **note de départ** : ce qu'on sait déjà, et ce qu'il faudra demander aux données.
- **Critère de réussite** : quand les CSV arrivent, on sait quoi faire, dans quel ordre, et où ranger chaque chose.
@@ -16,7 +16,7 @@
## Ce qui ne change pas
- Le code et les pages d'Energy, les maquettes et les données (`data/`).
- Aucune analyse ni aucun seuil n'est écrit avant les données : pas de données synthétiques (D-003), aucun seuil sans source.
- Aucune analyse ni aucun seuil n'est écrit avant l'exploration des données : pas de données synthétiques (D-003), aucun seuil sans source.
## Les domaines
@@ -35,7 +35,25 @@ Les noms sont en anglais, en un mot, comme `energy` :
| `.claude/skills/nouveau-domaine/SKILL.md` | la procédure (≈ 80 l), voir plus bas |
- Les autres dossiers du domaine (`analyses/`, `guide/`, matrice) ne sont pas créés : git ne suit pas les dossiers vides. Le skill les crée quand ils ont un contenu.
- Les CSV des nouvelles métriques iront dans `data/<STATION>/` (D-029), à côté des CSV Energy de la même station.
- Les CSV des nouvelles métriques vont dans `data/<STATION>/` (D-029), à côté des CSV Energy de la même station.
## Jeu de travail des nouveaux domaines : WEISSHORN
- VERMONT (D-009) n'a ni métrique de disque ni métrique de modem. Pour `storage` et `cellular`, le jeu de travail est **WEISSHORN** (`data/WEISSHORN/`), fourni par l'utilisateur le 2026-10-13 : tous les champs de la caméra, du 2026-10-03 07:00 au 2026-10-13 07:00 UTC, soit 241 heures, sans trou.
- Ce que montre un premier profil, fait par script :
- **les métriques numériques** sont des moyennes horaires, comme pour VERMONT ;
- **les métriques texte** (`link`, `registration`, `network_technology`, `network_operator`, `BatteryState`) sont la **liste des échantillons de l'heure**, par exemple `['up', 'up', 'up', 'up']`, soit un toutes les 15 minutes. Ce ne sont pas des moyennes ;
- **`last_sync`** est la liste des heures de synchronisation de l'heure (toutes les 15 minutes). C'est une piste pour un futur domaine « Communication », hors du périmètre ici ;
- **9 copies** `… (1).csv`, `(2).csv`, `(3).csv` (`ShuntVoltage`, `rsrq_dB`, `rssi_dbm`, `sensor_thermal_deg_c`) sont identiques à l'octet près à leur original. Avec elles, `load_stations` s'arrête sur une erreur « doublon » ;
- **38 fichiers `…:Zone.Identifier`** ont été laissés par le téléchargement sous Windows ;
- `SIM_CCID` et `ip` sont des identifiants de station. Ils restent dans `data/` (dépôt privé, D-014) et ne sont jamais recopiés dans les notes ;
- `Battery Voltage` couvre la même plage que `BusVoltage`, mais les deux séries ne sont pas identiques. Point à éclaircir pour Energy, hors du périmètre ici.
- **Réception (étape 2 du skill, appliquée à WEISSHORN)** :
- supprimer les 9 copies identiques et les 38 `Zone.Identifier` ;
- ajouter `*:Zone.Identifier` à `.gitignore` ;
- versionner `data/WEISSHORN/`, comme `data/VERMONT/`.
Les métriques texte restent ignorées par le chargeur tant que l'exploration n'a pas montré qu'on en a besoin.
## Note de départ d'un domaine
@@ -46,7 +64,7 @@ Elle est rangée dans `docs/<domaine>/domaine/`, avec le savoir du domaine qui y
3. **Ce que montrent les instantanés** de `data/metadata.md` (WILDSTRUBEL et VERMONT), sans les identifiants (SIM, IP).
4. **Ce qu'en disent les docs AIMsight** : le manuel de la station et la FAQ.
5. **Pièges déjà connus.**
6. **CSV à demander.**
6. **CSV reçus et manquants**, par rapport à ce que le collecteur exporte.
7. **Pistes d'analyses** : ce sont des pistes, pas des décisions. Elles passent dans les fiches au moment où les analyses s'écrivent.
### Storage : ce qu'on sait déjà
@@ -55,6 +73,10 @@ Elle est rangée dans `docs/<domaine>/domaine/`, avec le savoir du domaine qui y
- **Instantanés** :
- WILDSTRUBEL : total 5,98, libre 5,61, utilisé 0,04 GiB ;
- VERMONT expose d'autres noms, absents de notre copie du collecteur : `total_disk_1k-blk`, `used_disk_1k-blk`, `avail_disk_1k-blk` (blocs de 1 kio), `DB_file_size`, `DB_total_entries`, `DB_uploaded`, `DB_not_uploaded`.
- **WEISSHORN** (plages observées sur 10 jours) :
- `data_storage_free_gb` de 3,21 à 3,48 ; `data_storage_used_gb` de 2,17 à 2,45 ; `data_storage_total_gb` à 5,98 ;
- le label `state` du collecteur est aplati dans le nom de la métrique ;
- `data_storage_percent` n'est pas dans l'export, ni les métriques `*_disk_1k-blk` et `DB_*` de VERMONT.
- **Manuel de la station** (§ Disk) : « Monitor available capacity, especially for frequent schedules, long time series, or image-heavy acquisitions ».
- **Pièges** :
- **utilisé + libre ≠ total** (5,65 contre 5,98 GiB chez WILDSTRUBEL ; 3,46 contre 3,67 GiB chez VERMONT, soit 3 623 856 contre 3 849 952 blocs de 1 kio). Un écart de 5 à 6 % est cohérent avec les blocs réservés d'ext4, mais ce n'est pas vérifié. `psutil.percent` se calcule sur utilisé / (utilisé + libre), pas sur le total ;
@@ -77,6 +99,10 @@ Elle est rangée dans `docs/<domaine>/domaine/`, avec le savoir du domaine qui y
- **Instantanés** :
- WILDSTRUBEL : RSRP −81 dBm, RSRQ −13,5 dB, RSSI −51 dBm, BER 2,4 %, E-UTRAN, home, link up ;
- VERMONT : RSRP −105 dBm, RSRQ −10 dB.
- **WEISSHORN** (plages observées sur 10 jours, moyennes horaires) :
- RSRP de −98,25 à −60,50 dBm ; RSRQ de −18,75 à −5,00 dB ; RSSI de −67,5 à −51,0 dBm (le plafond est atteint) ; BER de 0,53 à 13,00 % ;
- les échantillons texte montrent `link` à `up`, `registration` à `home`, `E-UTRAN` et un seul opérateur. L'exploration dira s'ils changent jamais ;
- toutes les métriques du modem de `SYNC_SPEC` sont là.
- **Manuel de la station et FAQ** :
- le « Link status » doit passer à « Up » ;
- une connexion 4G peut mettre quelques minutes à s'établir après le démarrage ;
@@ -89,7 +115,8 @@ Elle est rangée dans `docs/<domaine>/domaine/`, avec le savoir du domaine qui y
- un trou rempli plus tard par une remontée différée ;
- **RSSI à −51 dBm veut dire « −51 dBm ou plus »** : la valeur sature ;
- si la lecture du modem échoue, le collecteur rapporte `link = down` avec toutes les valeurs vides : un lien `down` sans mesures n'est pas un signal faible ;
- **métriques texte** (`registration`, `link`, `network_technology`) : `common.stations.load_csv` ne lit que des nombres et ignore ces fichiers ;
- **métriques texte** (`registration`, `link`, `network_technology`) : ce sont des listes d'échantillons par heure. `common.stations.load_csv` ne lit que des nombres et ignore ces fichiers ;
- **moyennes de codes** : `ber_percent` et `rssi_dbm` sont des codes AT (tables du collecteur) moyennés sur l'heure. Une moyenne comme 0,53 % ne correspond à aucun code ;
- **moyennes horaires** de grandeurs en dB : la moyenne de valeurs en dB n'est pas la moyenne des puissances, et elle aplatit les décrochages brefs ;
- **aucun seuil de qualité** (« bon » ou « faible ») n'a encore de source : il en faudra une (doc du module radio, opérateur, expert), ou bien comparer la station à son propre passé.
- **Pistes** :
@@ -155,11 +182,13 @@ Energy le respecte déjà, à un détail près : sa `HEADLINE` est aujourd'hui d
- « État et prochaine étape » : Storage et Cellular ont leur structure et attendent les données ;
- « Carte du dépôt » : `docs/storage/`, `docs/cellular/`, `src/storage/`, `src/cellular/`, le skill `nouveau-domaine`.
- `.claude/skills/nouvelle-analyse/SKILL.md` §1 : une phrase qui renvoie vers `nouveau-domaine`.
- `CLAUDE.md`, prochaine étape : explorer WEISSHORN (étape 3 du skill) pour `storage` et `cellular`, et repérer les autres champs qui mériteraient une notification.
## Vérification
- Il n'y a pas de code de calcul. On relit les deux notes de départ en les confrontant au collecteur, au manuel, à la FAQ et à `metadata.md` : chaque fait cite sa source, et aucun identifiant de station (SIM, IP) n'est recopié.
- `python3 src/energy/final.py` et `python3 src/energy/all_analyses.py` tournent toujours : les nouveaux paquets ne cassent pas les imports.
- Après la réception, `load_stations(["data/WEISSHORN"])` charge le dossier sans erreur de doublon, et `git status` ne montre plus de `Zone.Identifier`.
## Options écartées
@@ -172,9 +201,10 @@ Energy le respecte déjà, à un détail près : sa `HEADLINE` est aujourd'hui d
## Texte de la décision D-030
## D-030 — 2026-10-13 — Nouveaux domaines Storage et Cellular ; procédure `nouveau-domaine` ; contrat de notification
- **Statut** : active. Complète D-026 (structure par domaine) et D-025 (notifications support).
- **Statut** : active. Complète D-026 (structure par domaine) et D-025 (notifications support) ; précise D-009 (jeu de travail par domaine).
- **Décision** :
- deux nouveaux domaines, rangés comme Energy : `storage` (espace disque) et `cellular` (signal 4G : niveau radio, enregistrement, lien). Chacun a `src/<domaine>/` et une note de départ, `docs/<domaine>/domaine/point-de-depart.md`. Les analyses attendent les données ;
- deux nouveaux domaines, rangés comme Energy : `storage` (espace disque) et `cellular` (signal 4G : niveau radio, enregistrement, lien). Chacun a `src/<domaine>/` et une note de départ, `docs/<domaine>/domaine/point-de-depart.md`. Les analyses attendent l'exploration des données ;
- leur jeu de travail est **WEISSHORN** (`data/WEISSHORN/`, 10 jours, tous les champs de la caméra) : VERMONT (D-009) n'a ni métrique de disque ni métrique de modem ;
- la procédure pour ajouter un domaine, donc une notification, est le skill `nouveau-domaine` (sept étapes, de la réception des données à la livraison). Il renvoie vers `nouvelle-analyse` pour chaque analyse ;
- **contrat de notification** : chaque domaine livré expose `day_color.run(series)`, un point par jour avec `facts.color` (`GREEN` / `ORANGE` / `RED` / `None`), et une `HEADLINE` en anglais par couleur notifiée ;
- le passage des maquettes à une liste de domaines se fait au premier nouveau domaine livré, pas avant.
@@ -182,4 +212,5 @@ Energy le respecte déjà, à un détail près : sa `HEADLINE` est aujourd'hui d
- **Options écartées** : la procédure dans un document de `docs/` (Claude ne le trouve pas seul) ou dans `nouvelle-analyse` (deux échelles mêlées) ; le nom `network` (VPN et envois relèvent de « Communication ») ; le passage multi-domaines dès maintenant (une liste à un seul élément, contrat non vérifié).
- **Conséquence** :
- `HEADLINE` d'Energy quittera `maquettes/support/home.py` pour `src/energy/day_color.py` lors du passage multi-domaines ;
- le chargeur commun ne lit que des métriques numériques : il faudra l'adapter si l'on retient les métriques texte du modem (`link`, `registration`).
- le chargeur commun ne lit que des métriques numériques : il faudra l'adapter si l'on retient les métriques texte du modem (`link`, `registration`), qui sont des listes d'échantillons par heure ;
- les copies identiques et les `Zone.Identifier` de WEISSHORN sont supprimés, et `*:Zone.Identifier` est ignoré par git.