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:
1 parent
77c8f24d2f
commit
8a32f4d418
44 files changed
+1757
-771
No files matched your search
+22
-4
@@ -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.
|
||||
Reference in new issue
Block a user