diff --git a/.claude/rules/analyses.md b/.claude/rules/analyses.md index 90a94e8..61ecb21 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/`) : pour Energy, `python3 src/energy/all_analyses.py`, et `python3 src/energy/daily.py` si l'analyse est livrée. Pas de tests automatisés en phase prototype (D-008). +- **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). - **Nouvelle analyse** : utiliser le skill `nouvelle-analyse`. diff --git a/.claude/skills/nouvelle-analyse/SKILL.md b/.claude/skills/nouvelle-analyse/SKILL.md index e6c2cc0..b938955 100644 --- a/.claude/skills/nouvelle-analyse/SKILL.md +++ b/.claude/skills/nouvelle-analyse/SKILL.md @@ -32,7 +32,7 @@ description: Créer une nouvelle analyse dans le projet de diagnostic AIMsight - `value` est exprimé dans une unité physique, sans pseudo-probabilité. - Une analyse seule conclut au plus `consistent with`. - Le module va dans `src//`. Les séries arrivent par `common.stations.load_stations`. Extraire du code partagé seulement quand une deuxième analyse en a vraiment besoin. -- **Pas de point d'entrée par analyse** : ajouter le panneau de l'analyse à la page de comparaison du domaine (pour Energy, `figure()` et `main()` de `src/energy/all_analyses.py`). Si l'analyse devient livrée, elle rejoint aussi la page livrée (pour Energy, `src/energy/daily.py`). +- **Pas de point d'entrée par analyse** : ajouter le panneau de l'analyse à la page de comparaison du domaine (pour Energy, `figure()` et `main()` de `src/energy/all_analyses.py`). Si l'analyse devient livrée, elle rejoint aussi la page livrée (pour Energy, `src/energy/final.py`). - Graphique (D-011) : en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle. Écrire le HTML avec `post_script=common.page.AUTOSCALE_Y_JS` et des ordonnées en `fixedrange`, pour que l'ordonnée se recale à chaque zoom. - Pas de tests automatisés en phase prototype (D-008). diff --git a/.claude/skills/nouvelle-analyse/modele-fiche.md b/.claude/skills/nouvelle-analyse/modele-fiche.md index c5768c3..3d4539b 100644 --- a/.claude/skills/nouvelle-analyse/modele-fiche.md +++ b/.claude/skills/nouvelle-analyse/modele-fiche.md @@ -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/daily.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/`), 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//` ; le calcul est en bibliothèque standard uniquement. ## Question posée diff --git a/README.md b/README.md index b27a710..733e85e 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ Agent de diagnostic **100 % analytique (sans LLM)** pour les stations AIMsight. ## Lancer l'analyse ```bash -python3 src/energy/daily.py +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`. diff --git a/docs/energy/analyses/daily_battery_state.md b/docs/energy/analyses/daily_battery_state.md index 769ab71..468e4c8 100644 --- a/docs/energy/analyses/daily_battery_state.md +++ b/docs/energy/analyses/daily_battery_state.md @@ -1,10 +1,10 @@ # `DAILY_BATTERY_STATE` : état de la batterie jour par jour - **Statut** : prototype en place (2026-10-12). Phase C : l'état seul, sans verdict. La phase B (niveaux gradués) viendra ensuite (D-018). -- **Script** : `python3 src/energy/daily.py [CSV ou dossiers]` (défaut : `data/`). Il écrit la page livrée, `out/_daily.html` + `.json`, dont cette analyse est le panneau du haut (D-021), et l'ouvre dans le navigateur. Elle est aussi le troisième panneau de `python3 src/energy/all_analyses.py` (comparaison, D-016). +- **Script** : `python3 src/energy/final.py [CSV ou dossiers]` (défaut : `data/`). Il écrit la page livrée, `out/_daily.html` + `.json`, dont cette analyse est le panneau du haut (D-021), et l'ouvre dans le navigateur. Elle est aussi le troisième panneau de `python3 src/energy/all_analyses.py` (comparaison, D-016). - **Code** : - `src/energy/battery_state.py` : calcul, bibliothèque standard uniquement (`run()`, `day_facts()`). Il reçoit les séries chargées par `common.stations.load_stations`, mais n'importe rien d'autre du projet : avec `src/energy/battery_trend.py`, il se livre seul à la plateforme (D-021) ; - - `src/energy/daily.py` : graphique plotly. + - `src/energy/final.py` : graphique plotly. ## Question posée diff --git a/docs/energy/analyses/daily_battery_trend.md b/docs/energy/analyses/daily_battery_trend.md index fe23bbb..31dfd74 100644 --- a/docs/energy/analyses/daily_battery_trend.md +++ b/docs/energy/analyses/daily_battery_trend.md @@ -1,10 +1,10 @@ # `DAILY_BATTERY_TREND` : tendance de la batterie d'un jour à l'autre - **Statut** : prototype en place (2026-10-12). Pas de verdict : `anomaly = None`, la tendance est dans `facts.trend`. -- **Script** : `python3 src/energy/daily.py [CSV ou dossiers]` (défaut : `data/`). Il écrit la page livrée, `out/_daily.html` + `.json`, dont cette analyse est le panneau du bas (D-021), et l'ouvre dans le navigateur. Elle est aussi le quatrième panneau de `python3 src/energy/all_analyses.py` (comparaison, D-016). +- **Script** : `python3 src/energy/final.py [CSV ou dossiers]` (défaut : `data/`). Il écrit la page livrée, `out/_daily.html` + `.json`, dont cette analyse est le panneau du bas (D-021), et l'ouvre dans le navigateur. Elle est aussi le quatrième panneau de `python3 src/energy/all_analyses.py` (comparaison, D-016). - **Code** : - `src/energy/battery_trend.py` : calcul, bibliothèque standard uniquement (`run()`). Il s'appuie sur `battery_state.run()` (`DAILY_BATTERY_STATE`) ; - - `src/energy/daily.py` : graphique plotly. + - `src/energy/final.py` : graphique plotly. ## Question posée diff --git a/docs/energy/guide/diagnostic-energetique.md b/docs/energy/guide/diagnostic-energetique.md index ed07a37..b19736b 100644 --- a/docs/energy/guide/diagnostic-energetique.md +++ b/docs/energy/guide/diagnostic-energetique.md @@ -147,7 +147,7 @@ Lecture de chaque case, avec le nombre de jours observés sur VERMONT (184 jours ## 8. Lire les pages HTML -Commandes : `python3 src/energy/daily.py` écrit la page livrée, `python3 src/energy/all_analyses.py` la page de comparaison ; chacune est écrite dans `out/` et ouverte dans le navigateur. +Commandes : `python3 src/energy/final.py` écrit la page livrée, `python3 src/energy/all_analyses.py` la page de comparaison ; chacune est écrite dans `out/` et ouverte dans le navigateur. - `_daily.html` : le graphique destiné au site de monitoring (D-021), soit les panneaux `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND` décrits ci-dessous, sur le même axe du temps. Sa figure Plotly est aussi écrite en JSON (`_daily.json`), pour `Plotly.newPlot`. - `_energy.html` : la page de comparaison des quatre analyses (`all_analyses.py`), avec ces deux panneaux, et une courbe par mesure dessous. diff --git a/maquettes/user/energy.py b/maquettes/user/energy.py index 5e744b9..954c385 100644 --- a/maquettes/user/energy.py +++ b/maquettes/user/energy.py @@ -1,7 +1,7 @@ """Maquette côté client « Energy » : page System Summary du site de monitoring, avec une section Diagnostic (D-020 à D-023). Données réelles VERMONT. Bloc Energy : couleur du dernier jour de la fenêtre, échelle de batterie et tendance face à la veille -(src/energy/day_color.py), puis historique complet (energy.daily.daily_figure, D-021) et guide (partie 1 du manuel), repliés. +(src/energy/day_color.py), puis historique complet (energy.final.daily_figure, D-021) et guide (partie 1 du manuel), repliés. Écrit out/maquette_user_energy.html et l'ouvre dans le navigateur. Usage : python3 maquettes/user/energy.py [AAAA-MM-JJ début] [AAAA-MM-JJ fin] (défaut : 2026-09-18 à 2026-09-28) """ @@ -17,7 +17,7 @@ sys.path.insert(0, str(ROOT / "src")) from common.page import AUTOSCALE_Y_JS, open_html # noqa: E402 (bascule seule sur .venv si plotly manque) from common.stations import load_stations # noqa: E402 from energy import battery_state as bs, battery_trend as bt, day_color as dc # noqa: E402 -from energy.daily import daily_figure # noqa: E402 +from energy.final import daily_figure # noqa: E402 START = date.fromisoformat(sys.argv[1]) if len(sys.argv) > 1 else date(2026, 9, 18) END = date.fromisoformat(sys.argv[2]) if len(sys.argv) > 2 else date(2026, 9, 28) diff --git a/src/energy/all_analyses.py b/src/energy/all_analyses.py index e6ec634..487e8b5 100644 --- a/src/energy/all_analyses.py +++ b/src/energy/all_analyses.py @@ -11,7 +11,7 @@ from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule from common.stations import gaps, load_stations # noqa: E402 from plotly.subplots import make_subplots # noqa: E402 from energy import battery_state as bs, battery_trend as bt, moving_average as ma # noqa: E402 -from energy.daily import daily_state_panel, daily_trend_panel # noqa: E402 +from energy.final import daily_state_panel, daily_trend_panel # noqa: E402 # Zones de BusVoltage selon l'état de la batterie (bandes de fond) : docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md. # [V] = VERMONT, 5e-95e centiles horaires ; [M] = manuel ; [E] = experts. Les zones « en charge » et « décharge » diff --git a/src/energy/daily.py b/src/energy/final.py similarity index 99% rename from src/energy/daily.py rename to src/energy/final.py index bd3d82a..e32ea25 100644 --- a/src/energy/daily.py +++ b/src/energy/final.py @@ -1,6 +1,6 @@ """Analyses livrées (D-020) : DAILY_BATTERY_STATE et DAILY_BATTERY_TREND, en une figure pour le site (D-021). -Usage : python3 src/energy/daily.py [CSV ou dossiers...] (défaut : data/) +Usage : python3 src/energy/final.py [CSV ou dossiers...] (défaut : data/) Écrit out/_daily.html (page de démo) et .json (figure Plotly pour le site, Plotly.newPlot), puis les ouvre. Documentation : docs/energy/analyses/daily_battery_state.md et daily_battery_trend.md """ diff --git a/src/energy/focus_jour.py b/src/energy/focus_jour.py index 54c06bf..f9583e5 100644 --- a/src/energy/focus_jour.py +++ b/src/energy/focus_jour.py @@ -13,7 +13,7 @@ from common.page import ROOT, open_html # noqa: E402 (bascule seule sur .venv from common.stations import gaps, load_stations # noqa: E402 import plotly.graph_objects as go # noqa: E402 from energy import battery_state as bs, battery_trend as bt, day_color as dc # noqa: E402 -from energy.daily import STATE_STYLE, TREND_STYLE, noon # noqa: E402 +from energy.final import STATE_STYLE, TREND_STYLE, noon # noqa: E402 # Statuts : noms et couleurs de la maquette System Summary (maquettes/user/energy_template.html). COLOR = {"GREEN": ("Green", "#008300"), "ORANGE": ("Orange", "#eda100"), "RED": ("Red", "#d03b3b"),