From ed0a5ae790c313e06a61fef775dc5f18535351f6 Mon Sep 17 00:00:00 2001 From: maxime Date: Tue, 13 Oct 2026 09:26:44 +0200 Subject: [PATCH] Add WEISSHORN as the working set of the Storage and Cellular domains Co-Authored-By: Claude Opus 5.5 --- .../2026-10-13-nouveaux-domaines-design.md | 47 +++++++++++++++---- 1 file changed, 39 insertions(+), 8 deletions(-) diff --git a/docs/superpowers/specs/2026-10-13-nouveaux-domaines-design.md b/docs/superpowers/specs/2026-10-13-nouveaux-domaines-design.md index 4f9fa5f..448bd82 100644 --- a/docs/superpowers/specs/2026-10-13-nouveaux-domaines-design.md +++ b/docs/superpowers/specs/2026-10-13-nouveaux-domaines-design.md @@ -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//` (D-029), à côté des CSV Energy de la même station. +- Les CSV des nouvelles métriques vont dans `data//` (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/`, 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/`, 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/`, 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/`, 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//` et une note de départ, `docs//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//` et une note de départ, `docs//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.