Compare commits

...
21 Commits
Author SHA1 Message Date
maxime 5a886b4e7e cellular + storage analysis 2026-10-13 12:50:15 +02:00
maximeandClaude Opus 5.5 1a18ddd059 Document the temperature exploration and defer the domain
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:42:54 +02:00
maximeandClaude Opus 5.5 d43db2a66a Add the storage analyses and their day color
DAILY_STORAGE_STATE classifies the end-of-day free space of /data and
DAYS_UNTIL_STORAGE_FULL divides it by the median daily fill over 7
days. The day color reads a state x horizon matrix drawn in
docs/storage/matrice-etat-horizon.drawio. Thresholds are arbitrary for
now (D-034, D-035); expert questions stay open. On WEISSHORN the disk
fills at 28.2 MiB/day and would be full around 06/02/2027.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:33:11 +02:00
maximeandClaude Opus 5.5 75b681d2db Rerun the cellular analyses on the 65-day WEISSHORN export
WEISSHORN now shows its commissioning (link down on 19-20/08), a send
cadence that settles on 01/09, six days with one to three missing
sends and one DOWN day from a single down sample. Update the starting
note, both fiches and the expert questions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:33:10 +02:00
maximeandClaude Opus 5.5 6d21f8652f Replace the WEISSHORN export with the 65-day export
The new export runs from 09/08 to 13/10 and contains the 10-day one.
Identical download copies are dropped; for BusCurrent the later copy
is kept (only its last, partial hour differed). Battery Voltage is no
longer exported.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:33:10 +02:00
maximeandClaude Opus 5.5 67fbc39e11 Document the paused cellular domain and the collector versions
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 11:52:04 +02:00
maximeandClaude Opus 5.5 75619e8f1c Remove the raw expert notes and the archived stations
Point the docs to the summaries that remain and record D-033.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 11:51:03 +02:00
maximeandClaude Opus 5.5 f803a7d596 Count sends without link and add NORDEND to the cellular working set
DAILY_LINK_STATE falls back on last_sync for exports without link,
treats the start of history as unknown, and records D-032. Document
the hourly counting flaws, the observed 15-minute cadence, and the
open questions for the specialist.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 11:50:07 +02:00
maximeandClaude Opus 5.5 f6d94148aa Add the NORDEND export without the duplicate copy
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 11:50:07 +02:00
maximeandClaude Opus 5.5 91ba1bd8ef Add the DAILY_LINK_STATE and DAILY_SIGNAL_STATE cellular analyses
Explore WEISSHORN for the cellular domain, count lost sends and
messages, grade the daily RSRP and RSRQ medians on the published
Quectel grid, and record D-031.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 10:48:34 +02:00
maximeandClaude Opus 5.5 28cbec408e Note that WEISSHORN exports the collector battery fields
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 10:48:34 +02:00
maximeandClaude Opus 5.5 f8a81c0990 Load text metrics as lists of the hour's samples
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 10:48:34 +02:00
maximeandClaude Opus 5.5 b0e77d2745 Record D-030 and map the Storage and Cellular domains
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:39:52 +02:00
maximeandClaude Opus 5.5 22afd57b55 Add the nouveau-domaine skill to add a notification domain
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:39:13 +02:00
maximeandClaude Opus 5.5 504c8634e3 Add the Storage and Cellular domains with their starting notes
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:38:33 +02:00
maximeandClaude Opus 5.5 dd4841a6d8 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>
2026-10-13 09:37:50 +02:00
maximeandClaude Opus 5.5 c97bd71b95 Plan the Storage and Cellular domains and the nouveau-domaine skill
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:36:26 +02:00
maximeandClaude Opus 5.5 2e0f9cfa1c Do not restrict the WEISSHORN working set to its first export dates
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:31:54 +02:00
maximeandClaude Opus 5.5 ed0a5ae790 Add WEISSHORN as the working set of the Storage and Cellular domains
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:26:44 +02:00
maximeandClaude Opus 5.5 ac2e95a90a Spec the Storage and Cellular domains and the new-domain procedure
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:22:32 +02:00
maximeandClaude Opus 5.5 c3e9eef4e4 Move the VERMONT CSVs into data/VERMONT
New data will be added per station without mixing with the working set.
All scripts now default to data/VERMONT/; docs and D-029 follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 09:10:35 +02:00
114 changed files with 115367 additions and 14852 deletions

No files matched your search

+2 -2
View File
@@ -14,7 +14,7 @@ paths:
- **Contrat commun** :
- `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}` ;
- calcul **causal** : le point t n'utilise que les données ≤ t ;
- `anomaly = None` signifie UNKNOWN (exception : `DAILY_BATTERY_STATE` en phase C et `DAILY_BATTERY_TREND`, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state` ou `facts.trend`) ;
- `anomaly = None` signifie UNKNOWN (exception : `DAILY_BATTERY_STATE` en phase C, `DAILY_BATTERY_TREND`, `DAILY_LINK_STATE`, `DAILY_SIGNAL_STATE`, `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL`, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`, `facts.trend` ou `facts.filling`) ;
- une analyse seule conclut au plus `consistent with`.
- **Code de calcul** (`src/<domaine>/`) : bibliothèque standard uniquement et aucun import de `src/common/`, car il doit tourner sur la station. Plotly ne sert qu'aux graphiques, sur le poste de dev (`.venv`). Le chargement des CSV est dans `common.stations`.
- **Constantes** : chacune a sa source, en commentaire dans le code et dans le tableau de la fiche. Aucun seuil sans source.
@@ -25,5 +25,5 @@ paths:
- mettre à jour la fiche dans le même changement (résultats, limites, historique) ;
- si c'est une décision projet, ajouter une entrée dans `docs/decisions.md` ;
- si c'est un savoir métier nouveau, l'ajouter dans `docs/domaine/` (commun) ou `docs/<domaine>/domaine/`.
- **Vérifier à la main** sur VERMONT (`data/`) : 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).
- **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).
- **Nouvelle analyse** : utiliser le skill `nouvelle-analyse`.
+56
View File
@@ -0,0 +1,56 @@
---
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`, WEISSHORN et NORDEND pour `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, qui peuvent être des identifiants. `SIM_CCID` se charge comme un nombre ou comme du texte selon la version du collecteur : ne jamais afficher ses valeurs.
- Les métriques texte (ex. `link`, `ip`) se chargent comme la liste des échantillons de l'heure (D-031). Une page ne trace que des séries choisies, jamais `SIM_CCID` ni `ip`.
- Comparer la liste des métriques à celle des autres stations du domaine : une autre version du collecteur peut renommer ou omettre des champs (NORDEND : ni `link` ni `registration`, disque en `*_disk_1k-blk`). Une analyse doit alors s'en passer et le dire (`None`), pas planter.
- Relever la couverture, le pas de temps et les trous (le début d'historique n'est pas une coupure) ; 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, se décident avec l'utilisateur. La combinaison se dessine en matrice dans `docs/<domaine>/matrice-<analyse 1>-<analyse 2>.drawio`, tenue par l'utilisateur, et le code la recopie dans `MATRIX` (Energy, D-020 ; Storage, D-035).
## 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).
+3 -3
View File
@@ -7,7 +7,7 @@ description: Créer une nouvelle analyse dans le projet de diagnostic AIMsight
## 1. Situer l'analyse
- **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.
- **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.
- **Nom de la règle** : en anglais, en majuscules, **en mots complets sans abréviation** (ex. `MOVING_AVERAGE_7_DAYS_DROP`, D-017). Les analyses ne sont pas numérotées : le nom de la règle les désigne (D-026).
- Lire, sans tout charger :
- les « Pistes » et les « Limites connues » des fiches du domaine (`docs/<domaine>/analyses/`). La nouvelle analyse en couvre souvent une ;
@@ -38,8 +38,8 @@ description: Créer une nouvelle analyse dans le projet de diagnostic AIMsight
## 4. Vérifier
- 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`).
- 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`).
- Reporter les dates et valeurs observées dans la section « Résultats » de la fiche.
## 5. Documenter
@@ -1,7 +1,7 @@
# `NOM_DE_LA_REGLE` : titre court
- **Statut** : idée | en conception | prototype en place | livrée | comparaison seulement | abandonnée (date).
- **Script** : la page qui montre l'analyse. Pour Energy : son panneau dans `python3 src/energy/all_analyses.py [CSV ou dossiers]` (défaut : `data/`), et dans `python3 src/energy/final.py` si elle est livrée. La page est écrite dans `out/` et ouverte dans le navigateur.
- **Script** : la page qui montre l'analyse. Pour Energy : son panneau dans `python3 src/energy/all_analyses.py [CSV ou dossiers]` (défaut : `data/VERMONT/`), et dans `python3 src/energy/final.py` si elle est livrée. La page est écrite dans `out/` et ouverte dans le navigateur.
- **Code** : les modules utilisés, dans `src/<domaine>/` ; le calcul est en bibliothèque standard uniquement.
## Question posée
+1
View File
@@ -3,3 +3,4 @@
.env.*
out/
__pycache__/
*:Zone.Identifier
+43 -9
View File
@@ -6,7 +6,7 @@ Ce fichier est une **carte** du projet, chargée à chaque session : il dit ce q
Agent de diagnostic proactif pour **AIMsight**, un système de surveillance optique de déplacements : une caméra suit des cibles (prismes, réflecteurs) sur un ouvrage, et le mouvement de la caméra est compensé grâce à des cibles de référence. L'agent analyse les séries temporelles avec des **méthodes analytiques (pas de LLM)**, complétées à l'étude par une couche d'agents LLM côté serveur (D-027), détecte les anomalies et explique chacune d'elles (preuves calculées + ce qui reste non établi) **avant** que le client ne pose la question. Cible d'exécution idéale : **le système embarqué de la station**. Langage : **Python**.
## État et prochaine étape (au 2026-10-12)
## État et prochaine étape (au 2026-10-13)
L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.md`.
@@ -14,7 +14,10 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m
- **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).
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
- **Prochaine étape** : é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).
- **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`.
- **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`.
- **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).
## Analyses (domaine Energy)
@@ -30,6 +33,29 @@ Code dans `src/energy/`, fiche dans `docs/energy/analyses/<règle en minuscules>
- **Couleur du jour** : `src/energy/day_color.py` (`MATRIX`, `focus()` pour J−1 / J), transcription de `docs/energy/matrice-etat-tendance.drawio`.
- **Travailler sur une analyse** : `.claude/rules/analyses.md` (contrat `run(series)`, calcul causal, constantes sourcées, graphiques, fiche à jour) se charge seul dès qu'on touche `src/` ou `docs/*/analyses/`.
- **Créer une analyse** : skill `nouvelle-analyse`.
- **Créer un domaine (une nouvelle notification)** : skill `nouveau-domaine` (D-030).
## Analyses (domaine Cellular)
Code dans `src/cellular/`, fiche dans `docs/cellular/analyses/<règle en minuscules>.md`, page de comparaison `src/cellular/all_analyses.py` (WEISSHORN et NORDEND, D-032).
| Règle | Question | Statut | Code |
|---|---|---|---|
| `DAILY_LINK_STATE` | Chaque jour : tous les envois arrivés avec `link = up`, un lien signalé `down`, ou des envois ou messages manquants ? | prototype (D-031) | `link_state.py` |
| `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).
## Analyses (domaine Storage)
Code dans `src/storage/`, fiche dans `docs/storage/analyses/<règle en minuscules>.md`, page de comparaison `src/storage/all_analyses.py` (WEISSHORN, D-034).
| Règle | Question | Statut | Code |
|---|---|---|---|
| `DAILY_STORAGE_STATE` | Chaque jour : espace libre de `/data` en % de l'utilisable, `OK`, `LOW` ou `CRITICAL` (planchers arbitraires 20 % / 10 %) ? | prototype (D-034) | `storage_state.py` |
| `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).
## Commandes
@@ -37,13 +63,15 @@ Code dans `src/energy/`, fiche dans `docs/energy/analyses/<règle en minuscules>
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 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/`. 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 à la maquette client : les lancer avec les mêmes dates.
- 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.
@@ -59,16 +87,18 @@ 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` (300 l, D-001 à D-027) : 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` (396 l, D-001 à D-037) : 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.
- `colonnes-des-deplacements.md` : colonnes des déplacements (cas d'usage suivant).
- `temperatures-de-la-station.md` : zones thermiques, constats sur trois stations, pistes non retenues, questions au spécialiste (D-036).
- `docs/energy/` : le domaine Energy.
- `analyses/<règle>.md` (80-120 l) : fiche vivante de chaque analyse (principe, constantes et sources, résultats, limites, options écartées, pistes, historique). Modèle : `.claude/skills/nouvelle-analyse/modele-fiche.md`.
- `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/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).
@@ -77,14 +107,18 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
- `AIMsight FAQ.pdf`, `AIMsight Test Manual.pdf` (en réalité le manuel de la station) : définitions des signaux et des colonnes CSV, alimentation, schedules.
- `collecteur_system_info.py` : copie de référence du collecteur `system_info` embarqué (INA219, table OCV LiFePO4, compensation IR 0,34 Ω). Source des unités. Ne pas modifier.
- `docs/superpowers/` : specs et plans superpowers (170-850 l chacun). Historique non maintenu, pas une référence. La spec d'une nouvelle analyse s'écrit dans sa fiche ; le plan peut aller dans `docs/superpowers/plans/`.
- `data/` : **jeu de travail = VERMONT seule** (D-009), le seul dataset complet : 7 CSV, un par métrique système (~5 000 l chacun). Les analyses tournent uniquement sur ce jeu.
- `metadata.md` (220 l) et `d.md` : notes brutes de l'expert, résumées dans `cas-annotes-par-l-expert.md`. `metadata.md` contient aussi des identifiants techniques de station (SIM, IP) : le dépôt doit rester privé (D-014).
- `archive/` : `BusVoltage` seule de 4 autres stations (incomplètes), mises de côté le 2026-10-09. Non analysées ; ne pas les réintroduire sans demande.
- `data/` : un dossier par station (D-029).
- `VERMONT/` : **jeu de travail = VERMONT seule** (D-009), le plus long historique : 7 CSV, un par métrique système (~5 000 l chacun). Les analyses Energy tournent uniquement sur ce jeu (défaut des scripts).
- `WEISSHORN/` : tous les champs de la caméra (export du 2026-10-13, du 09/08 au 13/10, mesures dès le 19/08) ; jeu de travail de `storage` (seul, D-034) et `cellular` (D-030). Contient des identifiants (`SIM_CCID`, `ip`) : ne pas les recopier ; le dépôt doit rester privé (D-014).
- `NORDEND/` : tous les champs d'une version plus ancienne du collecteur (export du 2026-10-13, 109 jours, sans `link`) ; deuxième jeu de travail de `cellular`, station à la liaison faible (D-032). Mêmes identifiants à ne pas recopier (`SIM_CCID`, `ip_*`).
- Les notes brutes de l'expert (`metadata.md`, `d.md`) et `archive/` ont été retirées le 2026-10-13 (D-033) : leur résumé est dans `docs/energy/domaine/cas-annotes-par-l-expert.md`.
- `src/` : un sous-dossier par domaine, plus le code commun (D-026).
- `common/` : `stations.py` (chargement des CSV, trous de mesure ; bibliothèque standard) et `page.py` (poste de dev : bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`).
- `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).
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `settings.json` (lecture de `.env` interdite).
- `.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).
- `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande.
- `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014).
+6 -6
View File
@@ -8,9 +8,9 @@ Agent de diagnostic **100 % analytique (sans LLM)** pour les stations AIMsight.
python3 src/energy/final.py
```
Le script analyse `data/` (station VERMONT) et ouvre dans le navigateur `out/VERMONT_daily.html`, l'état et la tendance de la batterie jour par jour : ce sont les analyses livrées, destinées au site de monitoring. La figure Plotly est aussi écrite dans `out/VERMONT_daily.json`.
Le script analyse `data/VERMONT/` et ouvre dans le navigateur `out/VERMONT_daily.html`, l'état et la tendance de la batterie jour par jour : ce sont les analyses livrées, destinées au site de monitoring. La figure Plotly est aussi écrite dans `out/VERMONT_daily.json`.
Pour comparer les quatre analyses Energy sur une même page (`out/VERMONT_energy.html`) : `python3 src/energy/all_analyses.py`. Pour comprendre la couleur d'un jour, en ne regardant que ce jour et la veille : `python3 src/energy/focus_jour.py 27.09`.
Pour comparer les quatre analyses Energy sur une même page (`out/VERMONT_energy.html`) : `python3 src/energy/all_analyses.py`. Pour comprendre la couleur d'un jour, en ne regardant que ce jour et la veille : `python3 src/energy/focus_jour.py 27.09`. Pages des autres domaines, sur WEISSHORN par défaut : `python3 src/storage/all_analyses.py` (espace disque) et `python3 src/cellular/all_analyses.py` (signal 4G).
La page de comparaison se lit ainsi :
- **en haut**, l'analyse ;
@@ -26,12 +26,12 @@ Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer c
| Vue d'ensemble, règles du projet, commandes | `CLAUDE.md` |
| Pourquoi le projet est comme il est (décisions, options écartées) | `docs/decisions.md` |
| Lire le diagnostic énergétique (manuel client et support) | `docs/energy/guide/diagnostic-energetique.md` |
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/energy/analyses/<règle>.md` |
| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs/energy/domaine/` |
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/<domaine>/analyses/<règle>.md` |
| 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) et diagnostics experts | `data/` |
| 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/` |
## État
Prototype expérimental, sans tests automatisés. Quatre analyses Energy sont en place. Deux sont livrées : `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour, et `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. Les deux autres servent à la comparaison : `MOVING_AVERAGE_7_DAYS_DROP` et sa variante sur la seule mesure de 00:00 UTC. Les suivantes sont listées dans les fiches `docs/energy/analyses/` (section « Pistes »).
Prototype expérimental, sans tests automatisés. Quatre analyses Energy sont en place. Deux sont livrées : `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour, et `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. Les deux autres servent à la comparaison : `MOVING_AVERAGE_7_DAYS_DROP` et sa variante sur la seule mesure de 00:00 UTC. Les suivantes sont listées dans les fiches `docs/energy/analyses/` (section « Pistes »). Deux autres domaines sont en prototype, sans cas annotés par l'expert. Storage (espace disque) : `DAILY_STORAGE_STATE`, `DAYS_UNTIL_STORAGE_FULL` et leur couleur du jour, avec des seuils arbitraires pour commencer (D-034, D-035) ; reste la livraison. Cellular (signal 4G) : `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE`, en pause en attendant le spécialiste. Le skill `nouveau-domaine` décrit comment ajouter un domaine (D-030).
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File renamed without changes.
Internal Server Error - Sensima GIT
500 Internal Server Error

An error occurred:

An error occurred

Gitea Version: 28.2.0