Compare commits
21
Commits
ef8ad70285
...
5a886b4e7e
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5a886b4e7e | ||
|
|
1a18ddd059 | ||
|
|
d43db2a66a | ||
|
|
75b681d2db | ||
|
|
6d21f8652f | ||
|
|
67fbc39e11 | ||
|
|
75619e8f1c | ||
|
|
f803a7d596 | ||
|
|
f6d94148aa | ||
|
|
91ba1bd8ef | ||
|
|
28cbec408e | ||
|
|
f8a81c0990 | ||
|
|
b0e77d2745 | ||
|
|
22afd57b55 | ||
|
|
504c8634e3 | ||
|
|
dd4841a6d8 | ||
|
|
c97bd71b95 | ||
|
|
2e0f9cfa1c | ||
|
|
ed0a5ae790 | ||
|
|
ac2e95a90a | ||
|
|
c3e9eef4e4 |
No files matched your search
@@ -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`.
|
||||
@@ -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).
|
||||
@@ -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
|
||||
|
||||
@@ -3,3 +3,4 @@
|
||||
.env.*
|
||||
out/
|
||||
__pycache__/
|
||||
*:Zone.Identifier
|
||||
@@ -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).
|
||||
|
||||
|
||||
@@ -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.
|
500 Internal Server Error
An error occurred: An error occurred Gitea Version: 28.2.0 |