diff --git a/.claude/rules/analyses.md b/.claude/rules/analyses.md index 71ec3f6..13bfc86 100644 --- a/.claude/rules/analyses.md +++ b/.claude/rules/analyses.md @@ -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/`. -- **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). +- **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`. diff --git a/CLAUDE.md b/CLAUDE.md index 2cbd9ea..3ce82e5 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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,8 @@ 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 et Cellular (D-030)** : structure et notes de départ (`docs//domaine/point-de-depart.md`), jeu de travail WEISSHORN ; aucune analyse. +- **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 (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 +31,7 @@ Code dans `src/energy/`, fiche dans `docs/energy/analyses/ - **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). Domaines en attente d'analyses : `storage` (espace disque), `cellular` (signal 4G). ## Commandes @@ -59,7 +61,7 @@ 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` (310 l, D-001 à D-029) : 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` (330 l, D-001 à D-030) : 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. @@ -69,6 +71,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv - `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. Pour l'instant, une note de départ chacun : `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes). - `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). @@ -78,14 +81,16 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv - `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/` : un dossier par station (D-029). - - `VERMONT/` : **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 (défaut des scripts). + - `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, 10 jours) ; jeu de travail de `storage` et `cellular` (D-030). Contient des identifiants (`SIM_CCID`, `ip`) : ne pas les recopier. - `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. - `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`). - `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`. + - `storage/`, `cellular/` : vides (`__init__.py`), en attente de la première analyse (D-030). - `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). diff --git a/README.md b/README.md index 24bc784..e7d9617 100644 --- a/README.md +++ b/README.md @@ -27,11 +27,11 @@ Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer c | 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/.md` | -| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs/energy/domaine/` | +| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs//domaine/` (`energy`, `storage`, `cellular`) | | Documentation AIMsight d'origine | `docs/aimsight/` | -| Données de travail (VERMONT) et diagnostics experts | `data/VERMONT/`, `data/` | +| Données de travail (VERMONT pour Energy, WEISSHORN pour Storage et Cellular) et diagnostics experts | `data/VERMONT/`, `data/WEISSHORN/`, `data/` | | 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 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). diff --git a/docs/decisions.md b/docs/decisions.md index 9aef9fd..29cf9af 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -311,3 +311,18 @@ Règles du journal : - **Pourquoi** : demande de l'utilisateur, qui va ajouter de nouvelles données sans vouloir les mêler au jeu de travail. - **Options écartées** : un chargement récursif de `data/` : il mêlerait `archive/` et les nouvelles données au jeu de travail. - **Conséquence** : une nouvelle station s'analyse en passant son dossier en argument (`python3 src/energy/final.py data/`). + +## 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//` 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** : 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.