Organize the project by domain and name analyses by their rule

Energy code moves to src/energy/ and its docs to docs/energy/; shared code
(CSV loading, venv switch, browser, zoom script) goes to src/common/, and the
AIMsight originals to docs/aimsight/. Analyses are no longer numbered: two
Energy scripts remain, daily.py (delivered state and trend) and
all_analyses.py (comparison of the four). Calculations and pages unchanged (D-026).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-12 17:12:37 +02:00
1 parent 77c8f24d2f
commit 8a32f4d418
44 files changed
+1757 -771

No files matched your search

+22 -4
View File
@@ -48,7 +48,7 @@ Règles du journal :
- **Conséquence** : toutes les analyses suivent le contrat commun `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`. Le calcul est causal. Une analyse seule conclut au plus `consistent with`.
## D-006 — 2026-10-09 — Un script et une fiche par analyse
- **Statut** : active.
- **Statut** : remplacée par D-026.
- **Décision** : l'analyse NN a un point d'entrée `src/analyse_NN.py` et une fiche `docs/analyses/analyse_NN.md`.
- **Pourquoi** : suivre une à une les analyses à venir, qui seront nombreuses.
- **Options écartées** : un `main.py` unique à la racine (essayé, puis renommé et déplacé).
@@ -75,7 +75,7 @@ Règles du journal :
- **Conséquence** : il n'y a plus de station saine pour vérifier qu'une analyse ne donne pas de fausse alerte. Les seuils calés avant cette décision gardent leur source historique.
## D-010 — 2026-10-09 — Organisation de la documentation
- **Statut** : active, complétée par D-012.
- **Statut** : active, complétée par D-012 ; remplacée en partie par D-026 (chemin des fiches).
- **Décision** : trois niveaux.
- `CLAUDE.md` est chargé à chaque session et reste court.
- `docs/decisions.md` (ce journal) porte les décisions de niveau projet.
@@ -93,7 +93,7 @@ Règles du journal :
- **Options écartées** : tous les champs sur un même axe, à la manière de la plateforme de monitoring (D-007), essayée puis abandonnée.
## D-012 — 2026-10-09 — Documentation : une carte et des documents chargés à la demande
- **Statut** : active. Complète D-010.
- **Statut** : active. Complète D-010. Remplacée en partie par D-026 (chemins des fiches, du modèle et de la règle `.claude`).
- **Décision** :
- `CLAUDE.md` devient une **carte** de moins de 200 lignes : état et prochaine étape, index des analyses, liens, règles non négociables, essentiel du domaine.
- Le savoir métier va dans `docs/domaine/`, une note par question.
@@ -135,7 +135,7 @@ Règles du journal :
- **Conséquence** : le seuil est une courbe, donc `AUTOSCALE_Y_JS` le garde visible sans cas particulier.
## D-016 — 2026-10-12 — Page commune : un panneau par analyse, pour les comparer
- **Statut** : active. Précise D-011 et D-006.
- **Statut** : active. Précise D-011 et D-006. Remplacée en partie par D-026 (un point d'entrée par analyse, ordre des panneaux par numéro).
- **Décision** : les analyses énergétiques partagent une page, `out/<STATION>_energy.html`. Chacune y a son panneau en haut, dans l'ordre de leur numéro (02 sous 01), puis viennent les graphiques des séries temporelles. Chaque analyse garde son point d'entrée `src/analyse_NN.py` (D-006), qui lance cette page.
- **Pourquoi** : demande de l'utilisateur, pour comparer `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` à `MOVING_AVERAGE_7_DAYS_DROP` sur le même axe de temps. C'est aussi un premier pas vers la combinaison des analyses (D-005).
- **Options écartées** : une page par analyse, qui obligerait à comparer deux onglets sans zoom commun.
@@ -254,3 +254,21 @@ Règles du journal :
- la section Status remplace, en haut de page, le panneau « Notifications » du site ;
- seule VERMONT a des données (`data/`) : les autres vignettes, noms repris du site, restent vides et grisées (pas de données synthétiques) ;
- la vue client doit être générée avec les mêmes dates (`maquettes/user/energy.py`) ; le script le rappelle si elle manque.
## D-026 — 2026-10-12 — Structure par domaine ; analyses désignées par leur règle
- **Statut** : active. Remplace D-006 ; remplace en partie D-010 (chemin des fiches), D-012 (chemins des fiches, du modèle et de la règle `.claude`) et D-016 (un point d'entrée par analyse).
- **Décision** :
- **Chaque domaine a son sous-dossier dans chaque couche** : `src/energy/` et `docs/energy/` (analyses, domaine, guide, matrice). Le code commun est dans `src/common/` (`stations.py` : chargement des CSV ; `page.py` : bascule `.venv`, ouverture, `AUTOSCALE_Y_JS`). `maquettes/` reste découpé par public (D-022). Les notes communes restent dans `docs/domaine/`.
- **Les analyses ne sont plus numérotées** : chacune est désignée par sa règle et sa fiche porte son nom (`docs/energy/analyses/daily_battery_state.md`). Correspondance : 01 = `MOVING_AVERAGE_7_DAYS_DROP`, 02 = `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`, 03 = `DAILY_BATTERY_STATE`, 04 = `DAILY_BATTERY_TREND`. Les entrées du journal antérieures à celle-ci gardent les numéros.
- **Deux scripts d'analyse pour Energy** : `src/energy/daily.py`, les analyses livrées (état et tendance, D-020 et D-021), qui écrit `out/<STATION>_daily.html` et `.json` ; `src/energy/all_analyses.py`, les quatre analyses ensemble pour comparer (D-016), qui écrit `out/<STATION>_energy.html`. `src/energy/focus_jour.py` reste l'outil de focus (D-024). Le résumé texte d'`energy_check.py` (`out/<STATION>_energy.json`) est supprimé.
- **La documentation AIMsight d'origine passe de `doc/` à `docs/aimsight/`**, avec la copie du collecteur (`collecteur_system_info.py`, ex-`src/__main__ (3).py`). La roadmap perd le suffixe « (2) ». `cas-d-usage-03-04.drawio` devient `docs/energy/matrice-etat-tendance.drawio`. Les contenus ne changent pas.
- Le modèle de fiche passe dans le skill `nouvelle-analyse` (`modele-fiche.md`).
- **Pourquoi** : demande de l'utilisateur. Encapsuler Energy pour que le domaine suivant (D-002) se range à côté. Ranger les fichiers dispersés (racine, `doc/` à côté de `docs/`, code commun mêlé aux analyses). Energy a convergé vers les analyses livrées : un numéro d'ordre de création n'aide plus, le nom de la règle suffit.
- **Options écartées** :
- une tranche verticale `energy/{src,docs,maquettes}` à la racine : elle mêle des couches aux destinataires différents (station, humains, équipe du site), et la maquette support couvre tous les domaines ;
- ne réorganiser que le code : la documentation Energy resterait mêlée au reste ;
- garder un script `analyse_NN.py` par analyse (D-006) : trois des quatre ne faisaient que relancer le premier ;
- une numérotation par domaine : elle ne dit pas plus que le nom de la règle.
- **Conséquence** :
- les anciens chemins restent dans `docs/superpowers/` et dans le texte des entrées antérieures du journal (historique non réécrit) ;
- le code de calcul s'embarque en copiant `src/energy/` sans `daily.py`, `all_analyses.py` ni `focus_jour.py`, qui demandent plotly.