Record D-030 and map the Storage and Cellular domains
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
22afd57b55
commit
b0e77d2745
4 files changed
+29
-9
No files matched your search
@@ -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>/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/<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). 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).
|
||||
|
||||
|
||||
Reference in new issue
Block a user