Plan the Storage and Cellular domains and the nouveau-domaine skill

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 09:36:26 +02:00
1 parent 2e0f9cfa1c
commit c97bd71b95
2 files changed
+520 -2

No files matched your search

@@ -0,0 +1,518 @@
# Nouveaux domaines Storage et Cellular — plan d'implémentation
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal :** préparer les domaines `storage` (espace disque) et `cellular` (signal 4G) sur le jeu WEISSHORN, et écrire la procédure réutilisable `nouveau-domaine`.
**Architecture :** aucun code de calcul. On reçoit les données (dédoublonnage, `.gitignore`, versionnement), on crée les paquets vides et une note de départ par domaine, puis le skill `nouveau-domaine`, et enfin la décision D-030 avec la mise à jour de la carte du projet.
**Tech Stack :** Markdown, Python 3 (bibliothèque standard) pour les vérifications, git.
**Spec :** `docs/superpowers/specs/2026-10-13-nouveaux-domaines-design.md`
## Global Constraints
- Documents projet en français ; messages de commit en anglais, terminés par `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
- Aucun seuil sans source, aucune analyse, aucun code de calcul dans ce plan ; pas de données synthétiques (D-003).
- **Aucun identifiant de station** (valeurs de `SIM_CCID`, adresses IP) recopié dans `docs/`, dans le skill ou dans un message de commit. Les vérifications qui chargent WEISSHORN redirigent stderr vers `/dev/null` : le chargeur y imprime la valeur illisible, donc l'identifiant.
- Ne pas modifier `docs/aimsight/`, `architecture.drawio`, `data/metadata.md`, ni le code d'Energy.
- `CLAUDE.md` reste sous 200 lignes (D-012) ; une note de domaine reste sous 80 lignes.
- **Une autre session travaille peut-être sur le dépôt** : commiter seulement ses propres fichiers (`git commit -- <chemins>`), jamais `git commit -a` ni `git add -A`.
## Review Focus
1. **Copies « (n) » qui ne seraient pas identiques** : les supprimer perdrait des données. Tâche 1, étape 1 : `cmp` avant toute suppression ; arrêt si une copie diffère.
2. **Identifiant de station recopié** dans une note, le skill ou une sortie de vérification. Tâches 2 et 3 : `grep` des motifs CCID (≥ 15 chiffres) et IPv4 sur les fichiers écrits.
3. **Fait de la note qui ne correspond pas aux données** (plages WEISSHORN). Tâche 2, étape 4 : les plages sont recalculées par script et comparées au texte.
4. **Numéro D-030 déjà pris** par la session concurrente. Tâche 4, étape 1 : lire le dernier numéro avant d'écrire ; sinon prendre le suivant et corriger toutes les références.
5. **Nouvel export avec des copies « (n) »** : le chargeur s'arrête sur « doublon ». Tâche 3 : le skill (étape 2) dit de comparer puis supprimer ces copies.
---
### Tâche 1 : Recevoir WEISSHORN
**Files :**
- Delete : `data/WEISSHORN/* (1).csv`, `* (2).csv`, `* (3).csv` (10 copies), `data/WEISSHORN/*:Zone.Identifier` (38 fichiers)
- Modify : `.gitignore`
- Add : `data/WEISSHORN/` (28 CSV)
**Interfaces :**
- Consumes : `common.stations.load_stations(paths) -> {station: {metric: {datetime: float | None}}}` (existant).
- Produces : `data/WEISSHORN/` chargeable sans erreur ; 20 métriques numériques, dont `data_storage_free_gb`, `data_storage_used_gb`, `data_storage_total_gb`, `rsrp_dBm`, `rsrq_dB`, `rssi_dbm`, `ber_percent`.
- [ ] **Étape 1 : vérifier que chaque copie est identique à son original**
```bash
cd /home/maxime/Support-Agent/data/WEISSHORN && for f in *' ('[0-9]').csv'; do cmp -s "$f" "${f% (*}.csv" && echo "identique : $f" || echo "DIFFÉRENT : $f"; done
```
Attendu : 10 lignes « identique : … » (`ShuntVoltage` ×3, `rsrq_dB` ×3, `rssi_dbm` ×1, `sensor_thermal_deg_c` ×3). **Si une ligne dit « DIFFÉRENT », s'arrêter et demander à l'utilisateur.**
- [ ] **Étape 2 : vérifier que le chargeur échoue aujourd'hui**
```bash
cd /home/maxime/Support-Agent && python3 -c "import sys; sys.path.insert(0, 'src'); from common.stations import load_stations; load_stations(['data/WEISSHORN'])" 2>/dev/null; echo "code $?"
```
Attendu : `code 1` (ValueError « doublon »).
- [ ] **Étape 3 : supprimer les copies et les `Zone.Identifier`**
```bash
cd /home/maxime/Support-Agent && rm -- data/WEISSHORN/*' ('[0-9]').csv' data/WEISSHORN/*:Zone.Identifier && ls data/WEISSHORN | wc -l
```
Attendu : `28`.
- [ ] **Étape 4 : ignorer les `Zone.Identifier` à l'avenir**
Ajouter à la fin de `.gitignore` :
```
*:Zone.Identifier
```
- [ ] **Étape 5 : vérifier le chargement**
```bash
cd /home/maxime/Support-Agent && python3 -c "
import sys; sys.path.insert(0, 'src')
from common.stations import load_stations
s = load_stations(['data/WEISSHORN'])['WEISSHORN']
need = {'data_storage_free_gb', 'data_storage_used_gb', 'data_storage_total_gb', 'rsrp_dBm', 'rsrq_dB', 'rssi_dbm', 'ber_percent'}
assert need <= set(s), sorted(need - set(s))
assert len(s) == 20, len(s)
print(len(s), 'métriques numériques chargées')
" 2>/dev/null
```
Attendu : `20 métriques numériques chargées`. Les 8 métriques texte (`BatteryState`, `SIM_CCID`, `ip`, `last_sync`, `link`, `network_operator`, `network_technology`, `registration`) sont ignorées par le chargeur, comme prévu par la spec.
- [ ] **Étape 6 : commiter**
```bash
cd /home/maxime/Support-Agent && git add .gitignore data/WEISSHORN && git status --short | grep -c Zone.Identifier; git commit -m "Add the WEISSHORN export without duplicate copies
All camera fields, 2026-10-03 to 2026-10-13. Identical (n).csv copies
and Windows Zone.Identifier files are removed and ignored.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>" -- .gitignore data/WEISSHORN
```
Attendu : `0` (aucun `Zone.Identifier` en attente), puis le commit.
---
### Tâche 2 : Paquets vides et notes de départ
**Files :**
- Create : `src/storage/__init__.py` (vide), `src/cellular/__init__.py` (vide)
- Create : `docs/storage/domaine/point-de-depart.md`
- Create : `docs/cellular/domaine/point-de-depart.md`
**Interfaces :**
- Consumes : `data/WEISSHORN/` chargeable (tâche 1).
- Produces : les chemins `docs/storage/domaine/point-de-depart.md` et `docs/cellular/domaine/point-de-depart.md`, cités par le skill (tâche 3) et par `CLAUDE.md` (tâche 4) ; les paquets `storage` et `cellular` importables.
- [ ] **Étape 1 : créer les paquets vides**
```bash
cd /home/maxime/Support-Agent && mkdir -p src/storage src/cellular && : > src/storage/__init__.py && : > src/cellular/__init__.py && python3 -c "import sys; sys.path.insert(0, 'src'); import storage, cellular; from energy import day_color; print('imports OK')"
```
Attendu : `imports OK`.
- [ ] **Étape 2 : écrire `docs/storage/domaine/point-de-depart.md`**
```markdown
# Storage : point de départ
Note de départ du domaine `storage` (D-030). Elle se complète au fil du skill `nouveau-domaine` ; les pistes passent dans les fiches quand les analyses s'écrivent.
## Question du domaine
La station a-t-elle encore assez d'espace disque pour continuer à stocker ses mesures, et pour combien de temps ?
## Ce que mesure le collecteur
Source : `docs/aimsight/collecteur_system_info.py`, `get_proc_info` et `SYNC_SPEC` (rubrique `proc`).
| Métrique exportée | Unité | Sens |
|---|---|---|
| `data_storage_free_gb` | GiB (÷ 1024³) | espace libre de la partition `/data` (`psutil.disk_usage('/data')`) |
| `data_storage_used_gb` | GiB | espace utilisé |
| `data_storage_total_gb` | GiB | taille de la partition |
| `data_storage_percent` | % | utilisé / (utilisé + libre), calcul de `psutil` |
- Le collecteur publie les trois premières sous une seule métrique `data_storage_gb`, avec un label `state` (`free`, `used`, `total`). L'export CSV aplatit ce label dans le nom de la métrique.
## Ce que montrent les données
- **Instantanés** (`data/metadata.md`, 2026-10-09) :
- 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` (3 849 952), `used_disk_1k-blk` (2 829 916) et `avail_disk_1k-blk` (793 940), en blocs de 1 kio, ainsi que `DB_file_size`, `DB_total_entries`, `DB_uploaded`, `DB_not_uploaded`.
- **WEISSHORN** (`data/WEISSHORN/`, export du 2026-10-13, du 03/10 07:00 au 13/10 07:00 UTC, moyennes horaires) : libre de 3,21 à 3,48 GiB, utilisé de 2,17 à 2,45 GiB, total 5,98 GiB.
## Ce qu'en dit la doc AIMsight
- Manuel de la station (`AIMsight Test Manual.pdf`, § Disk) : « Monitor available capacity, especially for frequent schedules, long time series, or image-heavy acquisitions ». Après l'enregistrement d'un schedule, vérifier « available internal storage ».
- Contexte support (`AIMsight_agentic_support_project_context.md`, § 5.1) : « Is storage available? », avec « disk usage » comme preuve candidate ; « storage remaining » figure parmi les « Likely high-value future signals ».
## Pièges connus
- **Utilisé + libre ≠ total** : 5,65 contre 5,98 GiB chez WILDSTRUBEL ; 3,46 contre 3,67 GiB chez VERMONT. Un écart de 5 à 6 % est cohérent avec les blocs réservés d'ext4, mais ce n'est pas vérifié. Le pourcentage de `psutil` se calcule sans eux.
- **Deux familles de métriques** : `data_storage_*` (WEISSHORN, WILDSTRUBEL) et `*_disk_1k-blk` (VERMONT), selon la version du logiciel ou la partition mesurée. Laquelle vaut pour chaque station : question ouverte.
- **Les totaux diffèrent** d'une station à l'autre (3,67 et 5,98 GiB, peut-être pas la même partition) : raisonner en espace libre et en vitesse de remplissage, pas sur un pourcentage fixe.
- Un trou de mesure pendant une coupure d'énergie n'est pas un problème de disque : croiser avec Energy.
## CSV reçus et manquants
- Reçus (WEISSHORN) : `data_storage_free_gb`, `data_storage_used_gb`, `data_storage_total_gb`.
- Manquants : `data_storage_percent` (calculable à partir des deux premiers), et les métriques `DB_*` de VERMONT (base locale, envois en attente).
- L'export couvre 10 jours : assez pour l'état du jour, court pour une vitesse de remplissage. Un historique plus long le remplacera.
## Pistes d'analyses (non décidées)
- L'espace libre du jour.
- La vitesse de remplissage et les jours avant saturation (espace libre ÷ pente sur plusieurs jours).
- Les purges : sauts de l'espace libre vers le haut.
```
- [ ] **Étape 3 : écrire `docs/cellular/domaine/point-de-depart.md`**
```markdown
# Cellular : point de départ
Note de départ du domaine `cellular` (D-030). Elle se complète au fil du skill `nouveau-domaine` ; les pistes passent dans les fiches quand les analyses s'écrivent.
## Question du domaine
La liaison 4G de la station est-elle assez bonne pour que ses données arrivent, et se dégrade-t-elle ?
## Ce que mesure le collecteur
Source : `docs/aimsight/collecteur_system_info.py`, `get_modem_info`, `parse_*` et `map_csq_*` ; export par `SYNC_SPEC` (rubrique `modem`). Le modem n'est relu qu'un cycle sur dix ; entre deux lectures, la dernière réponse est reprise.
| Métrique | Commande AT | Valeurs | Sens |
|---|---|---|---|
| `rsrp_dBm` | AT+CESQ | dBm, de −140 à −43 ; 255 = inconnu | puissance reçue du signal de référence LTE |
| `rsrq_dB` | AT+CESQ | dB, de −19,5 à −2,5 par pas de 0,5 | qualité reçue : RSRP rapporté à la puissance totale (bruit et interférences compris) |
| `rssi_dbm` | AT+CSQ | dBm, de −113 à −51 par pas de 2 ; 99 = inconnu | puissance totale reçue |
| `ber_percent` | AT+CSQ | %, codes 0 à 7 → 0,1 / 0,3 / 0,6 / 1,2 / 2,4 / 5 / 9 / 13 | taux d'erreur binaire |
| `registration` | AT+CEREG? | home, roaming, searching, denied, not_registered, unknown | enregistrement au réseau |
| `link` | AT+CGACT? et AT+CGPADDR | up, down | `up` si le contexte de données a une adresse IP |
| `network_technology` | AT+COPS? | GSM, UMTS, LTE, E-UTRAN | technologie radio |
| `network_operator` | AT+COPS? | texte | opérateur |
- `SIM_CCID` et l'adresse IP du modem sont aussi exportés : ce sont des identifiants de station, à ne jamais recopier dans `docs/`.
## Ce que montrent les données
- **Instantanés** (`data/metadata.md`, 2026-10-09) :
- 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** (`data/WEISSHORN/`, export du 2026-10-13, du 03/10 07:00 au 13/10 07:00 UTC) :
- 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 métriques texte sont la liste des échantillons de l'heure, un toutes les 15 minutes (ex. `['up', 'up', 'up', 'up']`). Sur tout l'export : `link` toujours `up`, `registration` toujours `home`, toujours `E-UTRAN`, un seul opérateur. Chaque heure a 4 échantillons, sauf la première et la dernière de l'export (2), coupées par l'extraction.
## Ce qu'en dit la doc AIMsight
- Manuel de la station (§ 4G Connectivity Setup) : le « Link status » doit passer à « Up » ; antenne dégagée, loin du métal et des autres antennes.
- FAQ : « A 4G connection may take a few minutes to become available after the station starts » ; réception faible en intérieur, en sous-sol, derrière du béton ou du métal ; « Loss of remote connectivity does not necessarily mean that the measurement station itself has stopped operating ».
- Contexte support (§ 5.1) : « Is the modem alive? », avec « modem state » comme preuve candidate.
## Pièges connus
- **Une donnée absente peut être l'anomalie elle-même** : quand le lien tombe, les mesures du modem n'arrivent plus. Distinguer un trou pendant une coupure d'énergie (croiser avec Energy), un trou avec la station alimentée (piste : le lien), et 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.
- **Moyennes de codes** : `ber_percent` et `rssi_dbm` sont des codes AT moyennés sur l'heure. Une moyenne comme 0,53 % ne correspond à aucun code.
- **Moyennes horaires en dB** : la moyenne de valeurs en dB n'est pas la moyenne des puissances, et elle aplatit les décrochages brefs.
- **Métriques texte** : `common.stations.load_csv` ne lit que des nombres et les ignore.
- **Aucun seuil de qualité** (« bon », « 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é.
## CSV reçus et manquants
- Reçus (WEISSHORN) : toutes les métriques du modem de `SYNC_SPEC`, et `last_sync` (heures de synchronisation, toutes les 15 minutes ; piste pour un futur domaine « Communication »).
- Non reçu : l'adresse du VPN (`ip_address{interface="nebula"}`), hors de ce domaine.
- L'export couvre 10 jours : assez pour l'état du jour, court pour comparer la station à son propre passé. Un historique plus long le remplacera.
## Pistes d'analyses (non décidées)
- Le niveau du jour (médiane du RSRP), comparé au passé de la station.
- La part des heures avec `link = up`.
- Les heures sans mesure alors que la station est alimentée.
```
- [ ] **Étape 4 : vérifier les plages citées contre les données**
```bash
cd /home/maxime/Support-Agent && python3 -c "
import sys; sys.path.insert(0, 'src')
from common.stations import load_stations
s = load_stations(['data/WEISSHORN'])['WEISSHORN']
for m in ['data_storage_free_gb', 'data_storage_used_gb', 'data_storage_total_gb', 'rsrp_dBm', 'rsrq_dB', 'rssi_dbm', 'ber_percent']:
v = [x for x in s[m].values() if x is not None]
print(m, f'{min(v):.2f}', f'{max(v):.2f}', len(v))
" 2>/dev/null
```
Attendu (à comparer aux notes) :
```
data_storage_free_gb 3.21 3.48 241
data_storage_used_gb 2.17 2.45 241
data_storage_total_gb 5.98 5.98 241
rsrp_dBm -98.25 -60.50 241
rsrq_dB -18.75 -5.00 241
rssi_dbm -67.50 -51.00 241
ber_percent 0.53 13.00 241
```
Si une valeur diffère, corriger la note, pas le script.
- [ ] **Étape 5 : vérifier l'absence d'identifiants et la longueur**
```bash
cd /home/maxime/Support-Agent && grep -n -E '[0-9]{15,}|\b([0-9]{1,3}\.){3}[0-9]{1,3}\b' docs/storage/domaine/point-de-depart.md docs/cellular/domaine/point-de-depart.md; echo "grep $?"; wc -l docs/storage/domaine/point-de-depart.md docs/cellular/domaine/point-de-depart.md
```
Attendu : `grep 1` (rien trouvé) ; chaque note sous 80 lignes.
- [ ] **Étape 6 : commiter**
```bash
cd /home/maxime/Support-Agent && git add src/storage/__init__.py src/cellular/__init__.py docs/storage docs/cellular && git commit -m "Add the Storage and Cellular domains with their starting notes
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>" -- src/storage/__init__.py src/cellular/__init__.py docs/storage docs/cellular
```
---
### Tâche 3 : Skill `nouveau-domaine`
**Files :**
- Create : `.claude/skills/nouveau-domaine/SKILL.md`
- Modify : `.claude/skills/nouvelle-analyse/SKILL.md` (§1 « Domaine » ; §4, deux lignes)
**Interfaces :**
- Consumes : le chemin `docs/<domaine>/domaine/point-de-depart.md` (tâche 2) ; le skill existant `nouvelle-analyse`.
- Produces : le skill `nouveau-domaine`, cité par `CLAUDE.md` et D-030 (tâche 4).
- [ ] **Étape 1 : écrire `.claude/skills/nouveau-domaine/SKILL.md`**
```markdown
---
name: nouveau-domaine
description: Ajouter un domaine de diagnostic, donc une nouvelle notification, au projet AIMsight (ex. espace disque, signal 4G, températures) — données reçues, exploration, cas experts, analyses, verdict du jour, livraison. À utiliser dès que l'utilisateur apporte les données d'un nouveau point d'attention ou veut une nouvelle notification.
---
# Ajouter un domaine (une nouvelle notification)
Un domaine reprend le travail fait pour Energy : des analyses sans LLM, un verdict par jour, une notification au client et au support (D-020, D-022, D-025, D-030). Sept étapes ; **chacune s'arrête pour l'avis de l'utilisateur**, qui décide si la suivante est utile. Pour tout ce qui touche à une analyse, suivre le skill `nouvelle-analyse`, sans le répéter ici.
## 1. Situer le domaine
- Nom en anglais, en un mot, comme `energy`, `storage` ou `cellular`. Question du domaine en une phrase.
- Lire `docs/<domaine>/domaine/point-de-depart.md`. S'il n'existe pas, créer `src/<domaine>/__init__.py` (vide) et la note, avec les sections de `docs/storage/domaine/point-de-depart.md` : question du domaine ; ce que mesure le collecteur (métriques, unités, ligne source dans `docs/aimsight/collecteur_system_info.py`, nom exporté dans `SYNC_SPEC`) ; ce que montrent les données (instantanés de `data/metadata.md`, exports reçus) ; ce qu'en dit la doc AIMsight (lire par section) ; pièges connus ; CSV reçus et manquants ; pistes d'analyses (non décidées).
- Lire `docs/decisions.md` (index : `grep -n '^## D-'`) pour les options déjà écartées.
## 2. Recevoir les données
- Les CSV vont dans `data/<STATION>/` (D-029). Le jeu de travail du domaine est noté dans `CLAUDE.md` et dans sa décision (VERMONT pour Energy, WEISSHORN pour `storage` et `cellular`).
- Copies de téléchargement `… (1).csv` : les comparer à l'original (`cmp`) ; identiques, les supprimer ; différentes, demander à l'utilisateur. Supprimer les `*:Zone.Identifier` (ignorés par git).
- Vérifier le chargement par `common.stations.load_stations`, **stderr redirigé** : le chargeur imprime les valeurs illisibles, dont des identifiants (`SIM_CCID`, `ip`).
- Les métriques texte (listes d'échantillons par heure, ex. `link`) sont ignorées par le chargeur. L'adapter seulement si une analyse en a besoin.
- Relever la couverture, le pas de temps et les trous ; versionner `data/<STATION>/`.
## 3. Explorer
- Par script, jamais en affichant les CSV ; ne jamais recopier d'identifiant de station dans `docs/`.
- Compléter la note de départ avec les faits observés : plages, cycles jour/nuit, sauts, trous, nombre d'échantillons par heure.
- Croiser avec Energy : un trou pendant une coupure d'énergie n'appartient pas au domaine (`docs/domaine/pieges-des-donnees.md`).
- Repérer, en passant, les champs d'autres points d'attention : les proposer comme domaines, ne pas les traiter.
## 4. Recueillir les cas de référence
- Demander à l'expert des périodes annotées, normales ou à problème, et les ranger dans `docs/<domaine>/domaine/cas-annotes-par-l-expert.md` (modèle : `docs/energy/domaine/cas-annotes-par-l-expert.md`).
- Sans cas annotés, pas de verdict livré. Un export sans incident sert à décrire le régime normal.
## 5. Écrire les analyses
- Une analyse par question, avec le skill `nouvelle-analyse` : fiche dans `docs/<domaine>/analyses/`, calcul embarquable dans `src/<domaine>/`, constantes sourcées, contrat `run(series)`.
- Seuils : ceux du matériel ou de la documentation, avec leur source ; sinon comparer la station à son propre passé. Préférer des fenêtres de plusieurs jours, multiples de 24 h.
- La première analyse crée la page de comparaison du domaine, `src/<domaine>/all_analyses.py` (D-016), sur le modèle de `src/energy/all_analyses.py`.
## 6. Produire le verdict du jour (contrat de notification)
- `src/<domaine>/day_color.py`, sur le modèle de `src/energy/day_color.py` :
- `run(series) -> {analysis, rule, points}`, un point par jour UTC, causal, `anomaly = None`, la couleur dans `facts.color` : `GREEN`, `ORANGE`, `RED` ou `None` (inconnu, gris) ;
- `HEADLINE = {"RED": "...", "ORANGE": "..."}` : une phrase en anglais par couleur notifiée (D-023). Green ne notifie rien (D-025).
- Ce que veut dire Red pour ce domaine, et la combinaison des analyses (une matrice tenue par l'utilisateur si elle est utile), se décident avec l'utilisateur.
## 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).
- 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).
```
- [ ] **Étape 2 : relier `nouvelle-analyse` à `nouveau-domaine`**
Dans `.claude/skills/nouvelle-analyse/SKILL.md`, remplacer :
```markdown
- **Domaine** : Energy (`src/energy/`, `docs/energy/`) ou un nouveau domaine, qui reçoit alors son propre `src/<domaine>/` et `docs/<domaine>/` (D-026). Le demander à l'utilisateur en cas de doute.
```
par :
```markdown
- **Domaine** : Energy (`src/energy/`, `docs/energy/`), Storage, Cellular, ou un nouveau domaine, qui reçoit alors son propre `src/<domaine>/` et `docs/<domaine>/` (D-026). Un domaine qui n'existe pas encore se crée d'abord avec le skill `nouveau-domaine` (D-030). Le demander à l'utilisateur en cas de doute.
```
Puis, au §4, remplacer :
```markdown
- Lancer la page de comparaison du domaine sur VERMONT (pour Energy, `python3 src/energy/all_analyses.py`).
- Comparer les résultats au diagnostic expert (`docs/energy/domaine/cas-annotes-par-l-expert.md`).
```
par :
```markdown
- Lancer la page de comparaison du domaine sur son jeu de travail (pour Energy, VERMONT : `python3 src/energy/all_analyses.py` ; pour Storage et Cellular, WEISSHORN, D-030).
- Comparer les résultats au diagnostic expert (`docs/<domaine>/domaine/cas-annotes-par-l-expert.md`).
```
- [ ] **Étape 3 : vérifier**
```bash
cd /home/maxime/Support-Agent && head -4 .claude/skills/nouveau-domaine/SKILL.md && wc -l .claude/skills/nouveau-domaine/SKILL.md && for p in docs/storage/domaine/point-de-depart.md src/energy/day_color.py src/energy/all_analyses.py src/energy/final.py maquettes/support/home.py docs/energy/domaine/cas-annotes-par-l-expert.md docs/domaine/pieges-des-donnees.md docs/aimsight/collecteur_system_info.py; do test -e "$p" || echo "absent : $p"; done; grep -c 'nouveau-domaine' .claude/skills/nouvelle-analyse/SKILL.md; grep -n -E '[0-9]{15,}|\b([0-9]{1,3}\.){3}[0-9]{1,3}\b' .claude/skills/nouveau-domaine/SKILL.md; echo "grep $?"
```
Attendu : l'en-tête YAML (`---`, `name: nouveau-domaine`, `description: …`, `---`) ; moins de 90 lignes ; aucune ligne « absent » ; `1` ; `grep 1`.
- [ ] **Étape 4 : commiter**
```bash
cd /home/maxime/Support-Agent && git add .claude/skills/nouveau-domaine/SKILL.md && git commit -m "Add the nouveau-domaine skill to add a notification domain
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>" -- .claude/skills/nouveau-domaine/SKILL.md .claude/skills/nouvelle-analyse/SKILL.md
```
---
### Tâche 4 : Décision D-030 et carte du projet
**Files :**
- Modify : `docs/decisions.md` (ajout en fin)
- Modify : `CLAUDE.md` (état, analyses, carte)
- Modify : `README.md` (tableau « Où trouver quoi », « État »)
- Modify : `.claude/rules/analyses.md` (ligne « Vérifier à la main »)
**Interfaces :**
- Consumes : les chemins des tâches 1 à 3 (`data/WEISSHORN/`, `src/storage/`, `src/cellular/`, `docs/storage/domaine/point-de-depart.md`, `docs/cellular/domaine/point-de-depart.md`, `.claude/skills/nouveau-domaine/`).
- Produces : D-030.
- [ ] **Étape 1 : vérifier que D-030 est libre**
```bash
cd /home/maxime/Support-Agent && grep -n '^## D-' docs/decisions.md | tail -1
```
Attendu : `## D-029 — …`. Si D-030 existe déjà, prendre le numéro suivant et le reporter partout dans cette tâche, dans les deux notes de départ, dans les deux skills et dans la spec.
- [ ] **Étape 2 : ajouter D-030 à la fin de `docs/decisions.md`**
Ajouter une ligne vide, puis :
```markdown
## 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) ; 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 l'exploration des données ;
- leur jeu de travail est **WEISSHORN** : tout `data/WEISSHORN/`, sans restriction de dates (tous les champs de la caméra ; l'export du 2026-10-13 couvre 10 jours, un export plus long le remplacera) : 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.
- **Pourquoi** : demande de l'utilisateur, qui veut le même travail qu'Energy pour d'autres points d'attention, et pouvoir ajouter vite de nouvelles notifications. Le collecteur mesure déjà l'espace disque et le signal du modem.
- **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`), 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.
```
- [ ] **Étape 3 : mettre à jour `CLAUDE.md`**
Remplacements exacts :
1. `## État et prochaine étape (au 2026-10-12)` → `## État et prochaine étape (au 2026-10-13)`.
2. Après la ligne `- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.`, ajouter :
```markdown
- **Storage et Cellular (D-030)** : structure et notes de départ (`docs/<domaine>/domaine/point-de-depart.md`), jeu de travail WEISSHORN ; aucune analyse.
```
3. Dans la ligne qui commence par `- **Prochaine étape** :`, remplacer le début
```markdown
- **Prochaine étape** : étape 1 du rapport d'agents
```
par
```markdown
- **Prochaine étape** : explorer WEISSHORN pour `storage` et `cellular` (skill `nouveau-domaine`, étape 3) et repérer les autres champs à notifier ; étape 1 du rapport d'agents
```
4. Après `- **Créer une analyse** : skill `nouvelle-analyse`.`, ajouter :
```markdown
- **Créer un domaine (une nouvelle notification)** : skill `nouveau-domaine` (D-030). Domaines en attente d'analyses : `storage` (espace disque), `cellular` (signal 4G).
```
5. Dans la carte, la ligne `- `docs/decisions.md` (310 l, D-001 à D-029)` : remplacer `(310 l, D-001 à D-029)` par `(330 l, D-001 à D-030)`.
6. Après le bloc `- `docs/energy/` : le domaine Energy.` et ses sous-lignes (jusqu'à `matrice-etat-tendance.drawio`), ajouter :
```markdown
- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Pour l'instant, une note de départ chacun : `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes).
```
7. Remplacer `Les analyses tournent uniquement sur ce jeu (défaut des scripts).` par `Les analyses Energy tournent uniquement sur ce jeu (défaut des scripts).`, puis ajouter après cette ligne :
```markdown
- `WEISSHORN/` : tous les champs de la caméra (export du 2026-10-13, 10 jours) ; jeu de travail de `storage` et `cellular` (D-030). Contient des identifiants (`SIM_CCID`, `ip`) : ne pas les recopier.
```
8. Après la ligne ` - `energy/` : calcul embarquable, …`, ajouter :
```markdown
- `storage/`, `cellular/` : vides (`__init__.py`), en attente de la première analyse (D-030).
```
9. Dans la ligne `- `.claude/` : …`, remplacer `` `skills/nouvelle-analyse/` (procédure et modèle de fiche)`` par `` `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine)``.
- [ ] **Étape 4 : mettre à jour `README.md` et `.claude/rules/analyses.md`**
`README.md` :
- remplacer `| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs/energy/domaine/` |` par `| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs/<domaine>/domaine/` (`energy`, `storage`, `cellular`) |` ;
- remplacer `| Données de travail (VERMONT) et diagnostics experts | `data/VERMONT/`, `data/` |` par `| Données de travail (VERMONT pour Energy, WEISSHORN pour Storage et Cellular) et diagnostics experts | `data/VERMONT/`, `data/WEISSHORN/`, `data/` |` ;
- à la fin du paragraphe de « ## État », ajouter : ` Deux nouveaux domaines, Storage (espace disque) et Cellular (signal 4G), ont leur structure et attendent l'exploration des données de WEISSHORN ; le skill `nouveau-domaine` décrit comment ajouter un domaine (D-030).`
`.claude/rules/analyses.md`, remplacer :
```markdown
- **Vérifier à la main** sur VERMONT (`data/VERMONT/`) : pour Energy, `python3 src/energy/all_analyses.py`, et `python3 src/energy/final.py` si l'analyse est livrée. Pas de tests automatisés en phase prototype (D-008).
```
par :
```markdown
- **Vérifier à la main** sur le jeu de travail du domaine : VERMONT (`data/VERMONT/`) pour Energy, avec `python3 src/energy/all_analyses.py`, et `python3 src/energy/final.py` si l'analyse est livrée ; WEISSHORN (`data/WEISSHORN/`) pour Storage et Cellular (D-030). Pas de tests automatisés en phase prototype (D-008).
```
- [ ] **Étape 5 : vérifier**
```bash
cd /home/maxime/Support-Agent && grep -n '^## D-' docs/decisions.md | tail -2 && wc -l CLAUDE.md docs/decisions.md && grep -c -E 'nouveau-domaine|WEISSHORN|storage' CLAUDE.md README.md .claude/rules/analyses.md && for p in data/WEISSHORN src/storage src/cellular docs/storage/domaine/point-de-depart.md docs/cellular/domaine/point-de-depart.md .claude/skills/nouveau-domaine/SKILL.md; do test -e "$p" || echo "absent : $p"; done
```
Attendu : D-029 puis D-030 ; `CLAUDE.md` sous 200 lignes ; le nombre de lignes de `docs/decisions.md` reporté dans la ligne de la carte (corriger le `330 l` s'il diffère de plus de 10) ; un compte non nul pour chaque fichier ; aucune ligne « absent ».
- [ ] **Étape 6 : commiter**
```bash
cd /home/maxime/Support-Agent && git commit -m "Record D-030 and map the Storage and Cellular domains
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>" -- docs/decisions.md CLAUDE.md README.md .claude/rules/analyses.md
```