845 lines
53 KiB
Markdown
845 lines
53 KiB
Markdown
# Structure Energy — plan d'implémentation
|
||||
|
|
|
|||
|
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|||
|
|
|
|||
|
|
**Goal:** Ranger le projet par domaine (`src/energy/`, `docs/energy/`, `src/common/`, `docs/aimsight/`), désigner les analyses par leur règle et ne garder que deux scripts d'analyse Energy (`daily.py` livré, `all_analyses.py` comparaison), sans changer les calculs ni les pages produites.
|
|||
|
|
|
|||
|
|
**Architecture:** On déplace avec `git mv`, puis on recâble les imports : imports absolus, et `src/` ajouté au chemin par chaque script lancé directement. Le code non propre à un domaine passe dans `src/common/`. On vérifie en comparant les pages de `out/` avant et après.
|
|||
|
|
|
|||
|
|
**Tech Stack:** Python 3 (bibliothèque standard pour le calcul), plotly dans `.venv/` pour les pages, git.
|
|||
|
|
|
|||
|
|
**Spec:** `docs/superpowers/specs/2026-10-12-structure-energy-design.md`
|
|||
|
|
|
|||
|
|
## Global Constraints
|
|||
|
|
|
|||
|
|
- Aucune constante, aucune règle, aucun résultat de calcul ne change.
|
|||
|
|
- Noms des fichiers de `out/` inchangés : `<STATION>_daily.html` + `.json`, `<STATION>_energy.html`, `<STATION>_focus_<AAAA-MM-JJ>.html` + `.json`, `maquette_user_energy.html` et `maquette_support_home.html`. `<STATION>_energy.json` n'est plus produit.
|
|||
|
|
- `moving_average.py`, `battery_state.py`, `battery_trend.py` et `day_color.py` : bibliothèque standard uniquement, sans aucun import de `common`.
|
|||
|
|
- Contenu intact : `architecture.drawio`, les documents AIMsight, le collecteur, la matrice `.drawio`, `data/` et `docs/superpowers/` (hors ce plan et la spec).
|
|||
|
|
- `docs/decisions.md` : on ajoute D-026 et on ne modifie que la ligne **Statut** de D-006, D-010 et D-012.
|
|||
|
|
- Dans les fiches, les entrées « Historique » existantes ne changent pas ; on en ajoute une datée du 2026-10-12.
|
|||
|
|
- `CLAUDE.md` reste sous 200 lignes.
|
|||
|
|
- Un seul commit à la fin, comprenant la spec et ce plan. Il se termine par `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
|
|||
|
|
- Pas de tests automatisés (D-008). La vérification se fait par comparaison avant/après (tâches 1 et 2).
|
|||
|
|
|
|||
|
|
## Review Focus
|
|||
|
|
|
|||
|
|
- **Lancement depuis un autre dossier** (`cd /tmp && python3 ~/Support-Agent/src/energy/daily.py`) : les imports et `out/` doivent se résoudre depuis `__file__`, pas depuis le dossier courant. Vérifié à l'étape 2.9.
|
|||
|
|
- **`python3` système sans plotly** : la bascule sur `.venv` doit encore marcher, avec `ROOT` calculé depuis `src/common/page.py`. Exercé par chaque lancement de la tâche 2, tous faits avec `python3`.
|
|||
|
|
- **Copie embarquée de `src/energy/` seul** : les quatre modules de calcul doivent s'importer sans `common` ni plotly. Vérifié à l'étape 2.8.
|
|||
|
|
- **Plusieurs stations ou un autre dossier en argument** (`daily.py data/archive`) : une page par station qui a `BusVoltage`, sans plantage. Vérifié à l'étape 2.9.
|
|||
|
|
- **Lien périmé dans un document vivant** (ancien chemin, « analyse 03 ») : un lecteur suivrait un chemin mort. Vérifié à l'étape 3.9.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### Task 1 : Référence avant le déplacement
|
|||
|
|
|
|||
|
|
**Files:**
|
|||
|
|
- Create : `$S/fakebin/explorer.exe`, `$S/compare.py`, `$S/before/` (scratchpad, hors dépôt)
|
|||
|
|
|
|||
|
|
`$S` = `/tmp/claude-1000/-home-maxime-Support-Agent/6099095d-2188-40c8-b309-77844d71d619/scratchpad`
|
|||
|
|
|
|||
|
|
**Interfaces:**
|
|||
|
|
- Produit : `$S/before/` (les pages actuelles) et `python3 $S/compare.py AVANT APRÈS`, qui affiche `identique`, `DIFFÉRENT` (avec un extrait de chaque ligne différente) ou `absent avant/après` pour chaque fichier.
|
|||
|
|
|
|||
|
|
- [ ] **Step 1 : faux `explorer.exe` (aucun onglet ouvert pendant les essais)**
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
S=/tmp/claude-1000/-home-maxime-Support-Agent/6099095d-2188-40c8-b309-77844d71d619/scratchpad
|
|||
|
|
mkdir -p $S/fakebin && printf '#!/bin/sh\nexit 0\n' > $S/fakebin/explorer.exe && chmod +x $S/fakebin/explorer.exe
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- [ ] **Step 2 : script de comparaison `$S/compare.py`**
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
"""Compare deux dossiers de pages générées ; neutralise les UUID des figures Plotly."""
|
|||
|
|
import re
|
|||
|
|
import sys
|
|||
|
|
from itertools import zip_longest
|
|||
|
|
from pathlib import Path
|
|||
|
|
|
|||
|
|
UUID = re.compile(r"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}")
|
|||
|
|
before, after = Path(sys.argv[1]), Path(sys.argv[2])
|
|||
|
|
for name in sorted({p.name for p in before.iterdir()} | {p.name for p in after.iterdir()}):
|
|||
|
|
a, b = before / name, after / name
|
|||
|
|
if not (a.exists() and b.exists()):
|
|||
|
|
print(f"{name} : absent {'avant' if not a.exists() else 'après'}")
|
|||
|
|
continue
|
|||
|
|
x, y = (UUID.sub("UUID", p.read_text()) for p in (a, b))
|
|||
|
|
if x == y:
|
|||
|
|
print(f"{name} : identique")
|
|||
|
|
continue
|
|||
|
|
print(f"{name} : DIFFÉRENT")
|
|||
|
|
for la, lb in zip_longest(x.splitlines(), y.splitlines(), fillvalue=""):
|
|||
|
|
if la != lb:
|
|||
|
|
i = next((k for k, (c, d) in enumerate(zip(la, lb)) if c != d), min(len(la), len(lb)))
|
|||
|
|
print(f" avant : {la[max(0, i - 60):i + 140]}\n après : {lb[max(0, i - 60):i + 140]}")
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- [ ] **Step 3 : générer les pages actuelles**
|
|||
|
|
|
|||
|
|
Le `out/` existant (pages générées, ignoré par git) est mis de côté, pas supprimé.
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && mv out $S/out-orig
|
|||
|
|
export PATH="$S/fakebin:$PATH"
|
|||
|
|
python3 src/analyse_01.py && python3 src/focus_jour.py 27.09 && python3 maquettes/user/energy.py && python3 maquettes/support/home.py
|
|||
|
|
cp -r out $S/before && ls $S/before
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Attendu : 7 fichiers, `VERMONT_daily.html`, `VERMONT_daily.json`, `VERMONT_energy.html`, `VERMONT_focus_2026-09-27.html`, `VERMONT_focus_2026-09-27.json`, `maquette_support_home.html` et `maquette_user_energy.html`.
|
|||
|
|
|
|||
|
|
- [ ] **Step 4 : contrôle du script de comparaison**
|
|||
|
|
|
|||
|
|
Run : `python3 $S/compare.py $S/before $S/before`
|
|||
|
|
Attendu : 7 lignes `identique`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### Task 2 : Code dans `src/common/` et `src/energy/`, maquettes recâblées
|
|||
|
|
|
|||
|
|
**Files:**
|
|||
|
|
- Move : `src/energy_check.py` → `src/energy/moving_average.py` ; `src/energy_plot.py` → `src/energy/daily.py` ; `src/battery_state.py`, `src/battery_trend.py`, `src/day_color.py`, `src/focus_jour.py` → `src/energy/`
|
|||
|
|
- Create : `src/common/stations.py`, `src/common/page.py`, `src/energy/all_analyses.py`
|
|||
|
|
- Delete : `src/analyse_01.py`, `src/analyse_02.py`, `src/analyse_03.py`, `src/analyse_04.py`
|
|||
|
|
- Modify : `maquettes/user/energy.py`, `maquettes/user/energy_template.html` (commentaires), `maquettes/support/home.py`
|
|||
|
|
|
|||
|
|
**Interfaces:**
|
|||
|
|
- Consomme : `$S/fakebin`, `$S/compare.py` et `$S/before/` (tâche 1).
|
|||
|
|
- Produit :
|
|||
|
|
- `common.stations` : `NAME_RE`, `parse_name(path)`, `load_csv(path)`, `load_stations(paths) -> {station: {metric: {datetime: float|None}}}`, `gaps(v) -> [(début, fin)]` ;
|
|||
|
|
- `common.page` : `ROOT: Path`, `VENV`, `AUTOSCALE_Y_JS: str`, `open_html(path)` (bascule `.venv` à l'import) ;
|
|||
|
|
- `energy.moving_average` : `run`, `run_midnight`, `_ma_drop`, `periods`, `RULE`, `RULE_MIDNIGHT` et les constantes ;
|
|||
|
|
- `energy.daily` : `STATE_STYLE`, `TREND_STYLE`, `noon(day)`, `daily_state_panel(fig, result, row)`, `daily_trend_panel(fig, result, row)`, `daily_figure(station, series)`, `main(paths) -> [Path]` ;
|
|||
|
|
- `energy.all_analyses` : `ZONES`, `figure(station, series, results)`, `main(paths) -> [Path]`.
|
|||
|
|
|
|||
|
|
- [ ] **Step 1 : copier les sources à découper, puis déplacer**
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && mkdir -p $S/old && cp src/energy_check.py src/energy_plot.py src/analyse_01.py $S/old/
|
|||
|
|
mkdir -p src/common src/energy
|
|||
|
|
git mv src/energy_check.py src/energy/moving_average.py
|
|||
|
|
git mv src/energy_plot.py src/energy/daily.py
|
|||
|
|
git mv src/battery_state.py src/battery_trend.py src/day_color.py src/focus_jour.py src/energy/
|
|||
|
|
git rm -q src/analyse_01.py src/analyse_02.py src/analyse_03.py src/analyse_04.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- [ ] **Step 2 : vérifier les bornes des blocs à découper**
|
|||
|
|
|
|||
|
|
Run :
|
|||
|
|
```bash
|
|||
|
|
sed -n '17p;49,51p;92p;95p;175p' $S/old/energy_check.py; echo ==; sed -n '15p;49p;52p;59,61p;142p;145p;156p;159p;206p' $S/old/energy_plot.py
|
|||
|
|
```
|
|||
|
|
Attendu :
|
|||
|
|
- `energy_check.py` : `HOUR = timedelta(hours=1)`, `}`, ligne vide, `NAME_RE = …`, ` return stations`, `def run(series):` et ` return out` ;
|
|||
|
|
- `energy_plot.py` : `# Plotly ne recale pas…`, `"""`, `# Zones de BusVoltage…`, `]`, ligne vide, `# États de DAILY_BATTERY_STATE…`, ` return fig`, `def gaps(v):`, ` return out`, `def figure(…` et ` return fig`.
|
|||
|
|
|
|||
|
|
Si une borne a bougé, corriger les plages de l'étape 3 avant de lancer quoi que ce soit.
|
|||
|
|
|
|||
|
|
- [ ] **Step 3 : assembler les nouveaux fichiers (`$S/assemble.py`)**
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
"""Découpe energy_check.py et energy_plot.py (copies dans $S/old) en modules ; plages 1-indexées, bornes incluses."""
|
|||
|
|
import sys
|
|||
|
|
from pathlib import Path
|
|||
|
|
|
|||
|
|
OLD, SRC = Path(sys.argv[1]), Path(sys.argv[2])
|
|||
|
|
check = (OLD / "energy_check.py").read_text().splitlines()
|
|||
|
|
plot = (OLD / "energy_plot.py").read_text().splitlines()
|
|||
|
|
cut = lambda lines, a, b: "\n".join(lines[a - 1:b]) # noqa: E731
|
|||
|
|
|
|||
|
|
SCRIPT_HEAD = '''import sys
|
|||
|
|
from pathlib import Path
|
|||
|
|
|
|||
|
|
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets common et energy
|
|||
|
|
'''
|
|||
|
|
|
|||
|
|
(SRC / "common" / "stations.py").write_text('''"""Chargement des exports CSV des stations, commun à tous les domaines.
|
|||
|
|
|
|||
|
|
Format des CSV : docs/domaine/ce-que-mesure-la-station.md. Bibliothèque standard uniquement.
|
|||
|
|
"""
|
|||
|
|
import csv
|
|||
|
|
import glob
|
|||
|
|
import os
|
|||
|
|
import re
|
|||
|
|
import sys
|
|||
|
|
from datetime import datetime
|
|||
|
|
|
|||
|
|
''' + cut(check, 51, 92) + "\n\n\n" + cut(plot, 145, 156).replace("sans BusVoltage", "sans mesure") + "\n")
|
|||
|
|
|
|||
|
|
(SRC / "common" / "page.py").write_text('''"""Pages HTML du poste de dev : bascule sur .venv si plotly manque, ouverture dans le navigateur, zoom (D-013).
|
|||
|
|
|
|||
|
|
À importer avant plotly : si plotly n'est pas installé, l'import relance le script sous .venv/bin/python.
|
|||
|
|
"""
|
|||
|
|
import importlib.util
|
|||
|
|
import os
|
|||
|
|
import shutil
|
|||
|
|
import subprocess
|
|||
|
|
import sys
|
|||
|
|
import webbrowser
|
|||
|
|
from pathlib import Path
|
|||
|
|
|
|||
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|||
|
|
VENV = ROOT / ".venv" / "bin" / "python"
|
|||
|
|
if importlib.util.find_spec("plotly") is None and VENV.exists():
|
|||
|
|
os.execv(VENV, [str(VENV), *sys.argv]) # plotly n'est installé que dans .venv
|
|||
|
|
|
|||
|
|
''' + cut(plot, 15, 49) + '''
|
|||
|
|
|
|||
|
|
|
|||
|
|
def open_html(path):
|
|||
|
|
if shutil.which("explorer.exe") and shutil.which("wslpath"): # WSL : navigateur Windows
|
|||
|
|
subprocess.run(["explorer.exe", subprocess.check_output(["wslpath", "-w", path], text=True).strip()])
|
|||
|
|
else:
|
|||
|
|
webbrowser.open(Path(path).resolve().as_uri())
|
|||
|
|
''')
|
|||
|
|
|
|||
|
|
(SRC / "energy" / "moving_average.py").write_text('''"""Tendance de BusVoltage en moyenne glissante sur 7 jours (comparaison seulement, non livrée : D-020).
|
|||
|
|
|
|||
|
|
- MOVING_AVERAGE_7_DAYS_DROP (docs/energy/analyses/moving_average_7_days_drop.md) : sur toutes les heures ;
|
|||
|
|
- MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP (docs/energy/analyses/moving_average_7_days_midnight_utc_drop.md) :
|
|||
|
|
le même calcul sur la seule mesure de 00:00 UTC.
|
|||
|
|
Bibliothèque standard uniquement (cible : système embarqué de la station).
|
|||
|
|
"""
|
|||
|
|
import math
|
|||
|
|
from datetime import timedelta
|
|||
|
|
|
|||
|
|
''' + cut(check, 17, 50) + "\n\n" + cut(check, 95, 175) + "\n")
|
|||
|
|
|
|||
|
|
(SRC / "energy" / "daily.py").write_text('''"""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/)
|
|||
|
|
Écrit out/<STATION>_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
|
|||
|
|
"""
|
|||
|
|
''' + SCRIPT_HEAD + '''from datetime import datetime, time, timezone # noqa: E402
|
|||
|
|
|
|||
|
|
from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
|||
|
|
from common.stations import load_stations # noqa: E402
|
|||
|
|
from plotly.subplots import make_subplots # noqa: E402
|
|||
|
|
from energy import battery_state as bs, battery_trend as bt # noqa: E402
|
|||
|
|
|
|||
|
|
''' + cut(plot, 61, 142) + '''
|
|||
|
|
|
|||
|
|
|
|||
|
|
def main(paths):
|
|||
|
|
"""Pour chaque station qui a BusVoltage : out/<STATION>_daily.html et .json. -> chemins écrits."""
|
|||
|
|
(ROOT / "out").mkdir(exist_ok=True)
|
|||
|
|
written = []
|
|||
|
|
for station, series in sorted(load_stations(paths).items()):
|
|||
|
|
if "BusVoltage" not in series:
|
|||
|
|
print(f"{station} : ignorée, pas de BusVoltage")
|
|||
|
|
continue
|
|||
|
|
path = ROOT / "out" / f"{station}_daily.html"
|
|||
|
|
fig = daily_figure(station, series)
|
|||
|
|
fig.write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS, config={"scrollZoom": True})
|
|||
|
|
fig.write_json(path.with_suffix(".json"))
|
|||
|
|
print(path)
|
|||
|
|
written.append(path)
|
|||
|
|
return written
|
|||
|
|
|
|||
|
|
|
|||
|
|
if __name__ == "__main__":
|
|||
|
|
for p in main(sys.argv[1:] or [str(ROOT / "data")]):
|
|||
|
|
open_html(p)
|
|||
|
|
''')
|
|||
|
|
|
|||
|
|
(SRC / "energy" / "all_analyses.py").write_text('''"""Les quatre analyses Energy ensemble, pour les comparer (D-016) : un panneau chacune, puis un graphique par série.
|
|||
|
|
|
|||
|
|
Usage : python3 src/energy/all_analyses.py [CSV ou dossiers...] (défaut : data/)
|
|||
|
|
Écrit out/<STATION>_energy.html et l'ouvre. Documentation : docs/energy/analyses/ (une fiche par analyse)
|
|||
|
|
"""
|
|||
|
|
''' + SCRIPT_HEAD + '''from common.page import AUTOSCALE_Y_JS, ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
|||
|
|
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
|
|||
|
|
|
|||
|
|
''' + cut(plot, 52, 59) + "\n\n\n" + cut(plot, 159, 206).replace("ec.periods(", "ma.periods(") + '''
|
|||
|
|
|
|||
|
|
|
|||
|
|
def main(paths):
|
|||
|
|
"""Pour chaque station qui a BusVoltage : out/<STATION>_energy.html. -> chemins écrits."""
|
|||
|
|
(ROOT / "out").mkdir(exist_ok=True)
|
|||
|
|
written = []
|
|||
|
|
for station, series in sorted(load_stations(paths).items()):
|
|||
|
|
if "BusVoltage" not in series:
|
|||
|
|
print(f"{station} : ignorée, pas de BusVoltage")
|
|||
|
|
continue
|
|||
|
|
path = ROOT / "out" / f"{station}_energy.html"
|
|||
|
|
results = [ma.run(series), ma.run_midnight(series), bs.run(series), bt.run(series)]
|
|||
|
|
figure(station, series, results).write_html(path, include_plotlyjs="cdn", post_script=AUTOSCALE_Y_JS,
|
|||
|
|
config={"scrollZoom": True})
|
|||
|
|
print(path)
|
|||
|
|
written.append(path)
|
|||
|
|
return written
|
|||
|
|
|
|||
|
|
|
|||
|
|
if __name__ == "__main__":
|
|||
|
|
for p in main(sys.argv[1:] or [str(ROOT / "data")]):
|
|||
|
|
open_html(p)
|
|||
|
|
''')
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Run : `python3 $S/assemble.py $S/old src && git add src/common src/energy`
|
|||
|
|
|
|||
|
|
`daily.py` reçoit `STATE_STYLE` … `daily_figure` (lignes 61-142). `ZONES`, `gaps`, `figure`, `main` et `AUTOSCALE_Y_JS` vont ailleurs, et l'ancien en-tête (lignes 1-14) disparaît. Le contenu que `git mv` avait placé dans `daily.py` et `moving_average.py` est remplacé par l'assemblage ; git suit quand même le renommage s'il reste assez de contenu commun.
|
|||
|
|
|
|||
|
|
- [ ] **Step 4 : imports et références des modules de calcul**
|
|||
|
|
|
|||
|
|
Dans `src/energy/battery_trend.py`, remplacer `import battery_state as bs` par `from energy import battery_state as bs`.
|
|||
|
|
|
|||
|
|
Dans `src/energy/day_color.py`, remplacer :
|
|||
|
|
```python
|
|||
|
|
import battery_state as bs
|
|||
|
|
import battery_trend as bt
|
|||
|
|
```
|
|||
|
|
par :
|
|||
|
|
```python
|
|||
|
|
from energy import battery_state as bs, battery_trend as bt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Puis appliquer les chemins et les noms (commentaires, docstrings, champs `"doc"`) aux quatre modules de calcul et à `focus_jour.py` :
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent/src/energy && sed -i \
|
|||
|
|
-e 's#docs/analyses/analyse_01.md#docs/energy/analyses/moving_average_7_days_drop.md#g' \
|
|||
|
|
-e 's#docs/analyses/analyse_02.md#docs/energy/analyses/moving_average_7_days_midnight_utc_drop.md#g' \
|
|||
|
|
-e 's#docs/analyses/analyse_03.md#docs/energy/analyses/daily_battery_state.md#g' \
|
|||
|
|
-e 's#docs/analyses/analyse_04.md#docs/energy/analyses/daily_battery_trend.md#g' \
|
|||
|
|
-e 's#docs/guide/diagnostic-energetique.md#docs/energy/guide/diagnostic-energetique.md#g' \
|
|||
|
|
-e 's#fiche analyse_01#fiche moving_average_7_days_drop#g;s#fiche analyse_02#fiche moving_average_7_days_midnight_utc_drop#g' \
|
|||
|
|
-e 's#fiche analyse_03#fiche daily_battery_state#g;s#fiche analyse_04#fiche daily_battery_trend#g' \
|
|||
|
|
-e 's#(fiche 04)#(fiche daily_battery_trend)#g' \
|
|||
|
|
-e 's#cas-d-usage-03-04.drawio#docs/energy/matrice-etat-tendance.drawio#g' \
|
|||
|
|
-e 's#docs/domaine/\(comment-se-comporte-la-batterie\|tensions-selon-l-etat-de-la-batterie\|cas-annotes-par-l-expert\)#docs/energy/domaine/\1#g' \
|
|||
|
|
moving_average.py battery_state.py battery_trend.py day_color.py focus_jour.py daily.py all_analyses.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Remplacements exacts restants :
|
|||
|
|
- `battery_state.py` :
|
|||
|
|
- ligne 1 : `"""Analyse 03 DAILY_BATTERY_STATE : état…` → `"""DAILY_BATTERY_STATE : état…` ;
|
|||
|
|
- `(sans import d'energy_check : 03 et 04 se livrent seules)` → `(aucun import du projet : DAILY_BATTERY_STATE et DAILY_BATTERY_TREND se livrent seules)` ;
|
|||
|
|
- `# repris de l'analyse 01 : 20 h mesurées sur 24` → `# repris de MOVING_AVERAGE_7_DAYS_DROP : 20 h mesurées sur 24`.
|
|||
|
|
- `battery_trend.py`, ligne 1 : `"""Analyse 04 DAILY_BATTERY_TREND :` → `"""DAILY_BATTERY_TREND :`.
|
|||
|
|
- `day_color.py` :
|
|||
|
|
- `matrice état (analyse 03) × tendance (analyse 04)` → `matrice état (DAILY_BATTERY_STATE) × tendance (DAILY_BATTERY_TREND)` ;
|
|||
|
|
- `causale comme les analyses 03 et 04` → `causale comme DAILY_BATTERY_STATE et DAILY_BATTERY_TREND`.
|
|||
|
|
- `moving_average.py` : `# Analyse 02 : les mêmes constantes` → `# MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP : les mêmes constantes`.
|
|||
|
|
- `daily.py` :
|
|||
|
|
- `(analyses 03 et 04)` → `(DAILY_BATTERY_STATE et DAILY_BATTERY_TREND)` ;
|
|||
|
|
- `analyse 03 en haut, analyse 04 dessous` → `DAILY_BATTERY_STATE en haut, DAILY_BATTERY_TREND dessous`.
|
|||
|
|
|
|||
|
|
Run : `grep -n "analyse\|energy_check\|energy_plot\|import battery\|import day_color" src/energy/*.py src/common/*.py`
|
|||
|
|
Attendu : seulement des mots courants (« analyses énergétiques », `Analyse {…}` dans un titre affiché), aucun ancien nom de fichier, aucun import relatif.
|
|||
|
|
|
|||
|
|
- [ ] **Step 5 : `focus_jour.py`**
|
|||
|
|
|
|||
|
|
Remplacer les lignes 1 à 16 (docstring et imports) par :
|
|||
|
|
```python
|
|||
|
|
"""Focus sur un jour : sa couleur (matrice état × tendance) et ce qui l'explique, sur le jour J et la veille seulement (D-024).
|
|||
|
|
|
|||
|
|
Usage : python3 src/energy/focus_jour.py JJ.MM[.AAAA] [CSV ou dossiers...] (défaut : data/ ; sans année, celle des données)
|
|||
|
|
Affiche le résumé des faits, écrit out/<STATION>_focus_<AAAA-MM-JJ>.html (+ .json, la figure Plotly pour le site)
|
|||
|
|
et l'ouvre dans le navigateur. Textes du résumé et du graphique en anglais : destinés au site (D-023).
|
|||
|
|
"""
|
|||
|
|
import sys
|
|||
|
|
from datetime import date, timedelta
|
|||
|
|
from pathlib import Path
|
|||
|
|
|
|||
|
|
sys.path.insert(0, str(Path(__file__).resolve().parents[1])) # src/ : paquets common et energy
|
|||
|
|
from common.page import ROOT, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
|||
|
|
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
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Puis :
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && sed -i -e 's/ep\.gaps(/gaps(/g;s/ep\.STATE_STYLE/STATE_STYLE/g;s/ep\.TREND_STYLE/TREND_STYLE/g;s/ep\.noon(/noon(/g;s/ec\.load_stations(/load_stations(/g' \
|
|||
|
|
-e 's/seuils de l.analyse 03/seuils de DAILY_BATTERY_STATE/;s/(comparaison de l.analyse 04)/(comparaison de DAILY_BATTERY_TREND)/' \
|
|||
|
|
-e 's/dashed: thresholds of the state (analysis 03)/dashed: thresholds of the daily state/;s/arrow: night end D-1 → D (trend, analysis 04)/arrow: night end D-1 → D (trend)/' \
|
|||
|
|
src/energy/focus_jour.py
|
|||
|
|
grep -n "ep\.\|ec\.\|analys" src/energy/focus_jour.py
|
|||
|
|
```
|
|||
|
|
Attendu : aucune ligne.
|
|||
|
|
|
|||
|
|
- [ ] **Step 6 : maquettes**
|
|||
|
|
|
|||
|
|
Dans `maquettes/user/energy.py`, remplacer :
|
|||
|
|
```python
|
|||
|
|
from analyse_01 import open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
|||
|
|
import battery_state as bs # noqa: E402
|
|||
|
|
import battery_trend as bt # noqa: E402
|
|||
|
|
import day_color as dc # noqa: E402
|
|||
|
|
import energy_check as ec # noqa: E402
|
|||
|
|
import energy_plot as ep # noqa: E402
|
|||
|
|
```
|
|||
|
|
par :
|
|||
|
|
```python
|
|||
|
|
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
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Dans `maquettes/support/home.py`, remplacer :
|
|||
|
|
```python
|
|||
|
|
from analyse_01 import open_html # noqa: E402
|
|||
|
|
import day_color as dc # noqa: E402
|
|||
|
|
import energy_check as ec # noqa: E402
|
|||
|
|
```
|
|||
|
|
par :
|
|||
|
|
```python
|
|||
|
|
from common.page import open_html # noqa: E402
|
|||
|
|
from common.stations import load_stations # noqa: E402
|
|||
|
|
from energy import day_color as dc # noqa: E402
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Puis :
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && sed -i -e 's/ec\.load_stations(/load_stations(/;s/ep\.daily_figure(/daily_figure(/;s/ep\.AUTOSCALE_Y_JS/AUTOSCALE_Y_JS/' \
|
|||
|
|
-e 's#ROOT / "docs" / "guide" / "diagnostic-energetique.md"#ROOT / "docs" / "energy" / "guide" / "diagnostic-energetique.md"#' \
|
|||
|
|
-e 's#(src/day_color.py)#(src/energy/day_color.py)#;s#(energy_plot.daily_figure, D-021)#(energy.daily.daily_figure, D-021)#' maquettes/user/energy.py
|
|||
|
|
sed -i -e 's/ec\.load_stations(/load_stations(/;s#(src/day_color.py, D-020)#(src/energy/day_color.py, D-020)#' maquettes/support/home.py
|
|||
|
|
sed -i -e 's#figure des analyses 03 et 04 (D-021)#figure de DAILY_BATTERY_STATE et DAILY_BATTERY_TREND (D-021)#' \
|
|||
|
|
-e 's#docs/domaine/comment-se-comporte-la-batterie.md#docs/energy/domaine/comment-se-comporte-la-batterie.md#g' \
|
|||
|
|
-e 's#src/__main__ (3).py#docs/aimsight/collecteur_system_info.py#' maquettes/user/energy_template.html
|
|||
|
|
grep -n "ec\.\|ep\.\|analyse_01\|energy_check\|energy_plot\|docs/guide\|docs/domaine/comment\|__main__ (3)" maquettes/*/*
|
|||
|
|
```
|
|||
|
|
Attendu : aucune ligne.
|
|||
|
|
|
|||
|
|
- [ ] **Step 7 : générer et comparer**
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && rm -r out # pages de l'étape 1.3, déjà copiées dans $S/before
|
|||
|
|
export PATH="$S/fakebin:$PATH"
|
|||
|
|
python3 src/energy/daily.py && python3 src/energy/all_analyses.py && python3 src/energy/focus_jour.py 27.09 \
|
|||
|
|
&& python3 maquettes/user/energy.py && python3 maquettes/support/home.py
|
|||
|
|
cp -r out $S/after && python3 $S/compare.py $S/before $S/after
|
|||
|
|
```
|
|||
|
|
Attendu :
|
|||
|
|
- `identique` pour `VERMONT_daily.html`, `VERMONT_daily.json`, `VERMONT_energy.html` et `maquette_support_home.html` ;
|
|||
|
|
- `DIFFÉRENT` pour `VERMONT_focus_2026-09-27.html` et `.json`, sur le seul sous-titre (`thresholds of the daily state`, `(trend)`) ;
|
|||
|
|
- `DIFFÉRENT` pour `maquette_user_energy.html`, sur les seuls commentaires JS du template (figure DAILY_…, `docs/energy/domaine/…`, `docs/aimsight/collecteur_system_info.py`).
|
|||
|
|
|
|||
|
|
Toute autre différence : s'arrêter et en trouver la cause.
|
|||
|
|
|
|||
|
|
- [ ] **Step 8 : le code de calcul s'importe seul (embarquable)**
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && /usr/bin/python3 -I -c "import sys; sys.path.insert(0, 'src'); from energy import moving_average, battery_state, battery_trend, day_color; print('ok', 'plotly' in sys.modules, 'common' in sys.modules)"
|
|||
|
|
grep -n "common\|plotly" src/energy/moving_average.py src/energy/battery_state.py src/energy/battery_trend.py src/energy/day_color.py
|
|||
|
|
```
|
|||
|
|
Attendu : `ok False False`, et aucune ligne trouvée par `grep`.
|
|||
|
|
|
|||
|
|
- [ ] **Step 9 : Review Focus (autre dossier, autres données)**
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /tmp && python3 /home/maxime/Support-Agent/src/energy/daily.py /home/maxime/Support-Agent/data/archive
|
|||
|
|
ls /home/maxime/Support-Agent/out/*_daily.json
|
|||
|
|
cd /home/maxime/Support-Agent && rm out/FLORIDA_daily.* out/JUNGFRAU_daily.* out/MISSISSIPPI_daily.* out/WILDSTRUBEL_daily.*
|
|||
|
|
```
|
|||
|
|
Attendu : 4 pages écrites dans `/home/maxime/Support-Agent/out/` (FLORIDA, JUNGFRAU, MISSISSIPPI, WILDSTRUBEL), et pas dans `/tmp/out`. Aucun plantage. Les fichiers créés sont ensuite retirés.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### Task 3 : Documents déplacés et mis à jour
|
|||
|
|
|
|||
|
|
**Files:**
|
|||
|
|
- Move :
|
|||
|
|
- `doc/*` → `docs/aimsight/` (la roadmap sans « (2) ») ;
|
|||
|
|
- `docs/analyses/analyse_0N.md` → `docs/energy/analyses/<règle>.md` ;
|
|||
|
|
- `docs/analyses/_modele.md` → `.claude/skills/nouvelle-analyse/modele-fiche.md` ;
|
|||
|
|
- `docs/guide/` → `docs/energy/guide/` ;
|
|||
|
|
- 3 notes de `docs/domaine/` → `docs/energy/domaine/` ;
|
|||
|
|
- `cas-d-usage-03-04.drawio` → `docs/energy/matrice-etat-tendance.drawio` ;
|
|||
|
|
- `src/__main__ (3).py` → `docs/aimsight/collecteur_system_info.py`.
|
|||
|
|
- Modify : `CLAUDE.md`, `README.md`, `.claude/rules/analyses.md`, `.claude/skills/nouvelle-analyse/SKILL.md`, `.claude/skills/nouvelle-analyse/modele-fiche.md`, les 4 fiches, le manuel, les notes de `docs/domaine/` et `docs/energy/domaine/`, `docs/decisions.md`.
|
|||
|
|
|
|||
|
|
**Interfaces:**
|
|||
|
|
- Consomme : les chemins du code de la tâche 2 (`src/energy/daily.py`, `all_analyses.py`, `focus_jour.py`, `src/common/`).
|
|||
|
|
|
|||
|
|
- [ ] **Step 1 : déplacements**
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && mkdir -p docs/aimsight docs/energy/analyses docs/energy/domaine
|
|||
|
|
git mv "doc/AIMsight FAQ.pdf" "doc/AIMsight Test Manual.pdf" doc/AIMsight_agentic_support_project_context.md docs/aimsight/
|
|||
|
|
git mv "doc/AIMsight_reference_quality_event_explainer_roadmap (2).md" docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md
|
|||
|
|
git mv "src/__main__ (3).py" docs/aimsight/collecteur_system_info.py
|
|||
|
|
git mv docs/analyses/analyse_01.md docs/energy/analyses/moving_average_7_days_drop.md
|
|||
|
|
git mv docs/analyses/analyse_02.md docs/energy/analyses/moving_average_7_days_midnight_utc_drop.md
|
|||
|
|
git mv docs/analyses/analyse_03.md docs/energy/analyses/daily_battery_state.md
|
|||
|
|
git mv docs/analyses/analyse_04.md docs/energy/analyses/daily_battery_trend.md
|
|||
|
|
git mv docs/analyses/_modele.md .claude/skills/nouvelle-analyse/modele-fiche.md
|
|||
|
|
git mv docs/guide docs/energy/guide
|
|||
|
|
git mv docs/domaine/comment-se-comporte-la-batterie.md docs/domaine/tensions-selon-l-etat-de-la-batterie.md docs/domaine/cas-annotes-par-l-expert.md docs/energy/domaine/
|
|||
|
|
git mv cas-d-usage-03-04.drawio docs/energy/matrice-etat-tendance.drawio
|
|||
|
|
ls doc docs/analyses 2>&1; git status --short | head -40
|
|||
|
|
```
|
|||
|
|
Attendu : `doc` et `docs/analyses` n'existent plus, et toutes les lignes de `git status` sont des `R` (renommages).
|
|||
|
|
|
|||
|
|
- [ ] **Step 2 : chemins dans les documents vivants**
|
|||
|
|
|
|||
|
|
Ni `docs/decisions.md`, ni `docs/superpowers/`, ni `docs/aimsight/` : ce sont des historiques ou des originaux.
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && FILES="CLAUDE.md README.md .claude/rules/analyses.md .claude/skills/nouvelle-analyse/SKILL.md .claude/skills/nouvelle-analyse/modele-fiche.md $(ls docs/energy/analyses/*.md docs/energy/guide/*.md docs/energy/domaine/*.md docs/domaine/*.md)"
|
|||
|
|
sed -i \
|
|||
|
|
-e 's#docs/analyses/analyse_01.md#docs/energy/analyses/moving_average_7_days_drop.md#g' \
|
|||
|
|
-e 's#docs/analyses/analyse_02.md#docs/energy/analyses/moving_average_7_days_midnight_utc_drop.md#g' \
|
|||
|
|
-e 's#docs/analyses/analyse_03.md#docs/energy/analyses/daily_battery_state.md#g' \
|
|||
|
|
-e 's#docs/analyses/analyse_04.md#docs/energy/analyses/daily_battery_trend.md#g' \
|
|||
|
|
-e 's#docs/analyses/_modele.md#.claude/skills/nouvelle-analyse/modele-fiche.md#g' \
|
|||
|
|
-e 's#docs/guide/diagnostic-energetique.md#docs/energy/guide/diagnostic-energetique.md#g' \
|
|||
|
|
-e 's#docs/domaine/comment-se-comporte-la-batterie.md#docs/energy/domaine/comment-se-comporte-la-batterie.md#g' \
|
|||
|
|
-e 's#docs/domaine/tensions-selon-l-etat-de-la-batterie.md#docs/energy/domaine/tensions-selon-l-etat-de-la-batterie.md#g' \
|
|||
|
|
-e 's#docs/domaine/cas-annotes-par-l-expert.md#docs/energy/domaine/cas-annotes-par-l-expert.md#g' \
|
|||
|
|
-e 's#src/__main__ (3).py#docs/aimsight/collecteur_system_info.py#g' \
|
|||
|
|
-e 's#doc/AIMsight_reference_quality_event_explainer_roadmap (2).md#docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md#g' \
|
|||
|
|
-e 's#\bdoc/#docs/aimsight/#g' \
|
|||
|
|
-e 's#`cas-d-usage-03-04.drawio`#`docs/energy/matrice-etat-tendance.drawio`#g' \
|
|||
|
|
$FILES
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- [ ] **Step 3 : `docs/decisions.md`**
|
|||
|
|
|
|||
|
|
- Dans l'entrée D-006, la ligne Statut `- **Statut** : active.` devient `- **Statut** : remplacée par D-026.`
|
|||
|
|
- Dans D-010, `- **Statut** : active, complétée par D-012.` devient `- **Statut** : active, complétée par D-012 ; remplacée en partie par D-026 (chemin des fiches).`
|
|||
|
|
- Dans D-012, `- **Statut** : active. Complète D-010.` devient `- **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`).`
|
|||
|
|
- Ajouter en fin de fichier l'entrée D-026, recopiée de la section « Texte de D-026 » de la spec, sans les `> ` de citation et précédée d'une ligne vide.
|
|||
|
|
|
|||
|
|
- [ ] **Step 4 : les quatre fiches**
|
|||
|
|
|
|||
|
|
Dans chaque fiche :
|
|||
|
|
- **Titre** : `# Analyse 0N — \`RÈGLE\` : …` devient `# \`RÈGLE\` : …`.
|
|||
|
|
- **Lignes `- **Script** :` et `- **Code** :`** (avec leurs sous-points) : elles sont remplacées par les blocs ci-dessous.
|
|||
|
|
- **Texte vivant** (tout sauf « Historique ») : remplacer les numéros, en accordant la phrase.
|
|||
|
|
- « l'analyse 01 » ou « analyse 01 » devient `MOVING_AVERAGE_7_DAYS_DROP` ; même chose pour 02 (`MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`), 03 (`DAILY_BATTERY_STATE`) et 04 (`DAILY_BATTERY_TREND`) ;
|
|||
|
|
- « fiche `analyse_03.md` » et « fiche analyse_03 » deviennent « fiche `daily_battery_state.md` », et ainsi de suite.
|
|||
|
|
- **Historique** : ajouter la ligne `- **2026-10-12** : fiche renommée d'après la règle (ex-\`analyse_0N.md\`) et déplacée dans \`docs/energy/analyses/\` ; code dans \`src/energy/\` (D-026). Calcul inchangé.`
|
|||
|
|
|
|||
|
|
`moving_average_7_days_drop.md` :
|
|||
|
|
```markdown
|
|||
|
|
- **Script** : `python3 src/energy/all_analyses.py [CSV ou dossiers]` (défaut : `data/`). Il écrit `out/<STATION>_energy.html` et l'ouvre dans le navigateur. Cette analyse est le premier panneau, et `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` est juste dessous (D-016). Elle sert à la comparaison seulement : elle n'est pas livrée (D-020).
|
|||
|
|
- **Code** :
|
|||
|
|
- `src/energy/moving_average.py` : calcul, bibliothèque standard uniquement. `run()` appelle `_ma_drop()`, commun avec `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`. Les séries sont chargées par `common.stations.load_stations` ;
|
|||
|
|
- `src/energy/all_analyses.py` : graphique plotly.
|
|||
|
|
```
|
|||
|
|
Le paragraphe qui commence par `` `python3 src/energy_check.py data/` produit en plus `` devient : `Le résumé texte et \`out/<STATION>_energy.json\` ont été supprimés (D-026) ; les périodes d'anomalie restent visibles, en rouge, sur la page.`
|
|||
|
|
|
|||
|
|
`moving_average_7_days_midnight_utc_drop.md` :
|
|||
|
|
```markdown
|
|||
|
|
- **Script** : `python3 src/energy/all_analyses.py [CSV ou dossiers]` (défaut : `data/`). Il écrit `out/<STATION>_energy.html`, où cette analyse est le panneau placé sous `MOVING_AVERAGE_7_DAYS_DROP` (D-016). Elle sert à la comparaison seulement : elle n'est pas livrée (D-020).
|
|||
|
|
- **Code** :
|
|||
|
|
- `src/energy/moving_average.py` : `run_midnight()` et `RULE_MIDNIGHT`, bibliothèque standard uniquement. Le calcul est celui de `MOVING_AVERAGE_7_DAYS_DROP` (`_ma_drop()`, commun aux deux analyses) ;
|
|||
|
|
- `src/energy/all_analyses.py` : graphique plotly.
|
|||
|
|
```
|
|||
|
|
La limite `**Pas de résumé texte ni de JSON** : …` devient : `**Pas de résumé texte ni de JSON** : supprimés pour les deux moyennes glissantes (D-026).`
|
|||
|
|
|
|||
|
|
`daily_battery_state.md` :
|
|||
|
|
```markdown
|
|||
|
|
- **Script** : `python3 src/energy/daily.py [CSV ou dossiers]` (défaut : `data/`). Il écrit la page livrée, `out/<STATION>_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.
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
`daily_battery_trend.md` :
|
|||
|
|
```markdown
|
|||
|
|
- **Script** : `python3 src/energy/daily.py [CSV ou dossiers]` (défaut : `data/`). Il écrit la page livrée, `out/<STATION>_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.
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Contrôle :
|
|||
|
|
```bash
|
|||
|
|
grep -n "analyse 0\|analyse_0\|fiche 0\|energy_check\|energy_plot\|src/analyse" docs/energy/analyses/*.md
|
|||
|
|
```
|
|||
|
|
Attendu : des lignes dans « Historique » seulement.
|
|||
|
|
|
|||
|
|
- [ ] **Step 5 : le manuel (`docs/energy/guide/diagnostic-energetique.md`)**
|
|||
|
|
|
|||
|
|
- **Ligne 3** : `calculée par \`src/day_color.py\`` devient `calculée par \`src/energy/day_color.py\``. Le chemin `.drawio` a déjà été traité à l'étape 2.
|
|||
|
|
- **§ 4** :
|
|||
|
|
- `- l'**état** du jour (analyse 03, \`DAILY_BATTERY_STATE\`) ;` devient `- l'**état** du jour (\`DAILY_BATTERY_STATE\`) ;` ;
|
|||
|
|
- même chose pour la tendance (`DAILY_BATTERY_TREND`).
|
|||
|
|
- **Titres** :
|
|||
|
|
- `## 5. L'état du jour (analyse 03)` devient `` ## 5. L'état du jour (`DAILY_BATTERY_STATE`) `` ;
|
|||
|
|
- `## 6. La tendance (analyse 04)` devient `` ## 6. La tendance (`DAILY_BATTERY_TREND`) ``.
|
|||
|
|
- **§ 8** : `Commande : \`python3 src/analyse_03.py\`. Elle écrit deux pages dans \`out/\` et les ouvre dans le navigateur.` devient :
|
|||
|
|
`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.`
|
|||
|
|
- **Puce `<STATION>_energy.html`** : `la page de toutes les analyses, avec ces deux panneaux, et une courbe par mesure dessous.` devient `la page de comparaison des quatre analyses (\`all_analyses.py\`), avec ces deux panneaux, et une courbe par mesure dessous.`
|
|||
|
|
- **Focus** : `python3 src/focus_jour.py 27.09` devient `python3 src/energy/focus_jour.py 27.09`.
|
|||
|
|
- **Langue et panneaux** :
|
|||
|
|
- `des panneaux 03 et 04` devient `des panneaux \`DAILY_BATTERY_STATE\` et \`DAILY_BATTERY_TREND\`` ;
|
|||
|
|
- `**Les panneaux 01 et 02** (moyennes sur 7 jours), en haut de la page,` devient `**Les panneaux \`MOVING_AVERAGE_*\`** (moyennes sur 7 jours), en haut de la page de comparaison,` ;
|
|||
|
|
- `**Panneau \`DAILY_BATTERY_STATE\`** (analyse 03),` devient `**Panneau \`DAILY_BATTERY_STATE\`**,` ;
|
|||
|
|
- `**Panneau \`DAILY_BATTERY_TREND\`** (analyse 04),` devient `**Panneau \`DAILY_BATTERY_TREND\`**,`.
|
|||
|
|
|
|||
|
|
Contrôle : `grep -n "analyse 0\|analyses 0\|panneaux 0\|src/analyse\|src/focus\|src/day" docs/energy/guide/diagnostic-energetique.md`
|
|||
|
|
Attendu : aucune ligne.
|
|||
|
|
|
|||
|
|
- [ ] **Step 6 : `.claude/rules/analyses.md`** (texte complet)
|
|||
|
|
|
|||
|
|
```markdown
|
|||
|
|
---
|
|||
|
|
paths:
|
|||
|
|
- "src/**"
|
|||
|
|
- "docs/*/analyses/**"
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Travailler sur une analyse
|
|||
|
|
|
|||
|
|
- **Avant de modifier** une analyse, lire sa fiche `docs/<domaine>/analyses/<règle>.md` (ex. `docs/energy/analyses/daily_battery_state.md`). En particulier :
|
|||
|
|
- le principe ;
|
|||
|
|
- les constantes et leurs sources ;
|
|||
|
|
- les limites connues ;
|
|||
|
|
- les **options écartées** (ne pas les reproposer sans raison nouvelle).
|
|||
|
|
- **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`) ;
|
|||
|
|
- 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.
|
|||
|
|
- **Graphique** :
|
|||
|
|
- en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle (D-011). Des analyses à comparer partagent une page, un panneau chacune (D-016) : pour Energy, `src/energy/all_analyses.py` ;
|
|||
|
|
- zoom horizontal seulement, avec l'ordonnée recalée sur la plage visible (`post_script=common.page.AUTOSCALE_Y_JS`, ordonnées en `fixedrange`, D-013).
|
|||
|
|
- **Après modification** :
|
|||
|
|
- 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/daily.py` si l'analyse est livrée. Pas de tests automatisés en phase prototype (D-008).
|
|||
|
|
- **Nouvelle analyse** : utiliser le skill `nouvelle-analyse`.
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- [ ] **Step 7 : skill `nouvelle-analyse`**
|
|||
|
|
|
|||
|
|
Texte complet de `SKILL.md` :
|
|||
|
|
```markdown
|
|||
|
|
---
|
|||
|
|
name: nouvelle-analyse
|
|||
|
|
description: Créer une nouvelle analyse dans le projet de diagnostic AIMsight — règle, fiche, code dans son domaine, panneau de comparaison, index, journal. À utiliser dès que l'utilisateur veut ajouter, concevoir ou prototyper une nouvelle analyse des séries temporelles d'une station.
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Créer une nouvelle analyse
|
|||
|
|
|
|||
|
|
## 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.
|
|||
|
|
- **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 ;
|
|||
|
|
- `docs/decisions.md`, en particulier les options écartées ;
|
|||
|
|
- la note de `docs/domaine/` ou de `docs/<domaine>/domaine/` qui concerne la question posée.
|
|||
|
|
- Si la conception demande des choix, en discuter avec l'utilisateur. Avec superpowers (brainstorming), **la spec s'écrit directement dans la fiche**, pas dans `docs/superpowers/specs/` (D-010).
|
|||
|
|
|
|||
|
|
## 2. Écrire la fiche
|
|||
|
|
|
|||
|
|
- Copier `modele-fiche.md` (à côté de ce fichier) vers `docs/<domaine>/analyses/<règle en minuscules>.md` (ex. `daily_battery_state.md`) et remplir :
|
|||
|
|
- la question posée ;
|
|||
|
|
- le principe et le calcul exact ;
|
|||
|
|
- les constantes **avec leur source** ;
|
|||
|
|
- les options écartées.
|
|||
|
|
- Statut : « en conception ».
|
|||
|
|
|
|||
|
|
## 3. Écrire le code
|
|||
|
|
|
|||
|
|
- Le calcul respecte le contrat commun : `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`.
|
|||
|
|
- Il est causal.
|
|||
|
|
- Il utilise uniquement la bibliothèque standard, sans importer `src/common/` : il doit pouvoir s'embarquer seul.
|
|||
|
|
- `value` est exprimé dans une unité physique, sans pseudo-probabilité.
|
|||
|
|
- Une analyse seule conclut au plus `consistent with`.
|
|||
|
|
- Le module va dans `src/<domaine>/`. 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`).
|
|||
|
|
- 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).
|
|||
|
|
|
|||
|
|
## 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`).
|
|||
|
|
- Reporter les dates et valeurs observées dans la section « Résultats » de la fiche.
|
|||
|
|
|
|||
|
|
## 5. Documenter
|
|||
|
|
|
|||
|
|
- Fiche : statut « prototype en place », résultats, limites, historique.
|
|||
|
|
- `CLAUDE.md` :
|
|||
|
|
- ajouter une ligne au tableau des analyses du domaine ;
|
|||
|
|
- mettre à jour « État et prochaine étape ».
|
|||
|
|
- `docs/decisions.md` : une entrée **seulement** si une décision de niveau projet a été prise (nouveau principe, changement de cap, nouveau domaine). Les choix propres à l'analyse restent dans sa fiche.
|
|||
|
|
- Un savoir métier découvert en chemin va dans `docs/domaine/` (commun) ou `docs/<domaine>/domaine/`.
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Dans `modele-fiche.md`, remplacer les quatre premières lignes (titre, Statut, Script, Code) par :
|
|||
|
|
```markdown
|
|||
|
|
# `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.
|
|||
|
|
- **Code** : les modules utilisés, dans `src/<domaine>/` ; le calcul est en bibliothèque standard uniquement.
|
|||
|
|
```
|
|||
|
|
Contrôle : `grep -n "NN\|analyse_\|src/analyse" .claude/skills/nouvelle-analyse/*.md`. Attendu : aucune ligne. Toute occurrence restante doit être corrigée dans le même esprit.
|
|||
|
|
|
|||
|
|
- [ ] **Step 8 : `CLAUDE.md` et `README.md`**
|
|||
|
|
|
|||
|
|
Dans `CLAUDE.md` :
|
|||
|
|
|
|||
|
|
**« État et prochaine étape »** : réécrire les puces avec les noms des règles, en gardant les dates et les faits :
|
|||
|
|
- `l'analyse 01 est en place` devient `` `MOVING_AVERAGE_7_DAYS_DROP` est en place `` ;
|
|||
|
|
- `Point ouvert de l'analyse 01` devient `` Point ouvert de `MOVING_AVERAGE_7_DAYS_DROP` `` ;
|
|||
|
|
- `analyse 02 (\`MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP\`, suggestion d'un collègue) en place, en panneau sous la 01 pour comparer` devient `` `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` (suggestion d'un collègue) en place, en panneau sous la précédente pour comparer `` ;
|
|||
|
|
- `contre ~2,7 jours pour la 01` devient `contre ~2,7 jours` ;
|
|||
|
|
- `analyse 03 \`DAILY_BATTERY_STATE\` en place` devient `` `DAILY_BATTERY_STATE` en place `` ;
|
|||
|
|
- `analyse 04 \`DAILY_BATTERY_TREND\` en place` devient `` `DAILY_BATTERY_TREND` en place `` ;
|
|||
|
|
- `ne retient que les analyses 03 et 04` devient `` ne retient que `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND` `` ;
|
|||
|
|
- `panneau 03 en haut et 04 dessous` devient `l'état en haut et la tendance dessous` ;
|
|||
|
|
- `figure 03 × 04 comprise` devient `figure état × tendance comprise` ;
|
|||
|
|
- les chemins `src/day_color.py` et `src/focus_jour.py` passent sous `src/energy/`.
|
|||
|
|
|
|||
|
|
Ajouter, avant « Prochaine étape » :
|
|||
|
|
`- **2026-10-12 (D-026)** : projet rangé par domaine (\`src/energy/\`, \`docs/energy/\`, code commun dans \`src/common/\`, documentation AIMsight dans \`docs/aimsight/\`). Les analyses ne sont plus numérotées : chacune est désignée par sa règle. Deux scripts Energy : \`daily.py\` (analyses livrées) et \`all_analyses.py\` (comparaison).`
|
|||
|
|
|
|||
|
|
**Section « Analyses »**, en entier :
|
|||
|
|
```markdown
|
|||
|
|
## Analyses (domaine Energy)
|
|||
|
|
|
|||
|
|
| Règle | Question | Statut | Fiche |
|
|||
|
|
|---|---|---|---|
|
|||
|
|
| `DAILY_BATTERY_STATE` | Chaque jour : pleine charge, charge partielle (incertain), sous le plateau ou aucune charge ? | livrée (prototype, D-020) | `docs/energy/analyses/daily_battery_state.md` |
|
|||
|
|
| `DAILY_BATTERY_TREND` | Chaque jour, face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | livrée (prototype, D-020) | `docs/energy/analyses/daily_battery_trend.md` |
|
|||
|
|
| `MOVING_AVERAGE_7_DAYS_DROP` | La tension moyenne sur 7 jours décroche-t-elle de son propre passé récent (> 0,2 V) ? | comparaison seulement | `docs/energy/analyses/moving_average_7_days_drop.md` |
|
|||
|
|
| `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` | Même question, sur la seule mesure de 00:00 UTC de chaque jour | comparaison seulement | `docs/energy/analyses/moving_average_7_days_midnight_utc_drop.md` |
|
|||
|
|
|
|||
|
|
Pour créer une analyse : skill `nouvelle-analyse` (`.claude/skills/nouvelle-analyse/`).
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Section « Commandes »**, en entier :
|
|||
|
|
```markdown
|
|||
|
|
## Commandes
|
|||
|
|
|
|||
|
|
- `python3 src/energy/daily.py [données]` : analyses livrées (`DAILY_BATTERY_STATE`, `DAILY_BATTERY_TREND`). Il écrit `out/<STATION>_daily.html` + `.json` (figure pour le site, D-021) et les ouvre dans le navigateur (via `explorer.exe` sous WSL). Défaut : `data/`. Il bascule seul sur `.venv` si plotly manque, comme tous les scripts plotly.
|
|||
|
|
- `python3 src/energy/all_analyses.py [données]` : les quatre analyses ensemble pour comparer (D-016), un panneau chacune, puis un graphique par série. Il écrit `out/<STATION>_energy.html` et l'ouvre.
|
|||
|
|
- `python3 src/energy/focus_jour.py 27.09` : focus sur un jour et sa veille (D-024). Il affiche les faits de la couleur et écrit `out/<STATION>_focus_<AAAA-MM-JJ>.html` + `.json`, puis l'ouvre.
|
|||
|
|
- `python3 maquettes/user/energy.py [début] [fin]` : maquette client « Energy » (page System Summary, section Diagnostic, D-022), écrite dans `out/maquette_user_energy.html` et ouverte.
|
|||
|
|
- `python3 maquettes/support/home.py [début] [fin]` : maquette support « Home » (toutes les stations, section Status, D-025), écrite dans `out/maquette_support_home.html` et ouverte.
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Section « Documentation »** :
|
|||
|
|
- la puce `docs/analyses/analyse_NN.md` devient `- \`docs/<domaine>/analyses/<règle>.md\` : fiche vivante de chaque analyse (principe, constantes et sources, résultats, limites, options écartées, historique). Modèle : \`.claude/skills/nouvelle-analyse/modele-fiche.md\`.` ;
|
|||
|
|
- la puce `docs/domaine/` et ses sous-puces deviennent :
|
|||
|
|
```markdown
|
|||
|
|
- `docs/domaine/` : le savoir métier commun, une note 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).
|
|||
|
|
- `docs/energy/domaine/` : le savoir métier Energy.
|
|||
|
|
- `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 (VERMONT, collecteur, chimie).
|
|||
|
|
- `cas-annotes-par-l-expert.md` : diagnostics experts des 5 stations.
|
|||
|
|
```
|
|||
|
|
- la puce du manuel devient `- \`docs/energy/guide/diagnostic-energetique.md\` : manuel du diagnostic énergétique, pour le client (partie 1) et le support (partie 2). À tenir à jour avec la matrice (\`docs/energy/matrice-etat-tendance.drawio\`) et les fiches \`DAILY_BATTERY_STATE\` et \`DAILY_BATTERY_TREND\`.` ;
|
|||
|
|
- dans la règle de travail, `un savoir métier nouveau va dans \`docs/domaine/\`` devient `un savoir métier nouveau va dans \`docs/domaine/\` (commun) ou \`docs/<domaine>/domaine/\`` ;
|
|||
|
|
- `quand Claude touche \`src/\` ou \`docs/analyses/\`` devient `quand Claude touche \`src/\` ou \`docs/*/analyses/\`` ;
|
|||
|
|
- dans la puce `docs/superpowers/`, la fiche devient `docs/<domaine>/analyses/<règle>.md`.
|
|||
|
|
|
|||
|
|
**Section « Fichiers »** :
|
|||
|
|
- la puce `doc/` et ses sous-puces deviennent :
|
|||
|
|
```markdown
|
|||
|
|
- `docs/aimsight/` : documentation AIMsight d'origine, à lire avant de concevoir. Ne pas re-demander à l'utilisateur ce qui y figure. Contenus non modifiés.
|
|||
|
|
- `AIMsight_reference_quality_event_explainer_roadmap.md` : **référence qui fait autorité**. Elle couvre la couche diagnostique commune, l'explainer d'événements, les classifications (§4.3) et l'API indépendante de l'estimateur (§10).
|
|||
|
|
- `AIMsight_agentic_support_project_context.md` : extension support. Contenu : chaîne de dépendance (§4), domaines dont la santé système (§5.1), règles épistémiques (§10), familles d'hypothèses (§12), format de sortie (§14-15), cas de régression (§16-17), cas d'usage (§23).
|
|||
|
|
- Les deux docs prévoient un LLM/agent pour la synthèse : **ne pas suivre ce point**, le projet est 100 % analytique.
|
|||
|
|
- `AIMsight FAQ.pdf` et `AIMsight Test Manual.pdf` (ce dernier est en réalité le manuel de la station) : définitions des signaux et des colonnes CSV, alimentation, schedules. Pour les lire : `pdftotext -layout "docs/aimsight/<fichier>.pdf" -`.
|
|||
|
|
- `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.
|
|||
|
|
```
|
|||
|
|
- les puces `src/analyse_NN.py` et `src/__main__ (3).py` sont remplacées par :
|
|||
|
|
```markdown
|
|||
|
|
- `src/` : un sous-dossier par domaine, plus le code commun (D-026).
|
|||
|
|
- `src/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`).
|
|||
|
|
- `src/energy/` : calcul embarquable, en bibliothèque standard et sans import de `common/` : `moving_average.py`, `battery_state.py`, `battery_trend.py` et `day_color.py` (matrice, couleur du jour, focus J−1 / J). Scripts plotly du poste de dev : `daily.py`, `all_analyses.py` et `focus_jour.py`.
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Sections « Principes » et « Environnement »** :
|
|||
|
|
- `exception : analyses 03 en phase C et 04` devient `` exception : `DAILY_BATTERY_STATE` en phase C et `DAILY_BATTERY_TREND` `` ;
|
|||
|
|
- `en lançant \`python3 src/analyse_01.py\` sur VERMONT` devient `en lançant \`python3 src/energy/all_analyses.py\` (et \`daily.py\` pour le livré) sur VERMONT`.
|
|||
|
|
|
|||
|
|
Dans `README.md` :
|
|||
|
|
- la section « Lancer l'analyse » est remplacée par :
|
|||
|
|
```markdown
|
|||
|
|
## Lancer l'analyse
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python3 src/energy/daily.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`.
|
|||
|
|
|
|||
|
|
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`.
|
|||
|
|
```
|
|||
|
|
`Le graphique se lit ainsi :` devient `La page de comparaison se lit ainsi :` (en haut les analyses, dessous les mesures, ce qui ne décrit pas la page livrée) ; le reste de ce paragraphe et celui sur Plotly restent tels quels.
|
|||
|
|
- dans le tableau « Où trouver quoi » :
|
|||
|
|
- `` `docs/guide/diagnostic-energetique.md` `` devient `` `docs/energy/guide/diagnostic-energetique.md` `` ;
|
|||
|
|
- `` `docs/analyses/analyse_NN.md` `` devient `` `docs/energy/analyses/<règle>.md` `` ;
|
|||
|
|
- `` `docs/domaine/` `` devient `` `docs/domaine/` (commun), `docs/energy/domaine/` `` ;
|
|||
|
|
- `` `doc/` `` devient `` `docs/aimsight/` `` ;
|
|||
|
|
- dans la section « État », `Quatre analyses sont en place : …` devient : `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 »).`
|
|||
|
|
|
|||
|
|
Contrôle : `wc -l CLAUDE.md`. Attendu : moins de 200.
|
|||
|
|
|
|||
|
|
- [ ] **Step 9 : références périmées**
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && grep -rn "analyse_0\|analyse_NN\|energy_check\|energy_plot\|docs/analyses\|docs/guide\|\`doc/\|\"doc/\|__main__ (3)\|cas-d-usage-03-04\|src/battery\|src/day_color\|src/focus_jour\|docs/domaine/comment\|docs/domaine/tensions\|docs/domaine/cas-annotes\|analyse 0[1-4]\|analyses 0[1-4]" \
|
|||
|
|
--include=*.md --include=*.py --include=*.html . | grep -v "^./.venv\|^./docs/superpowers/\|^./docs/decisions.md\|^./docs/aimsight/"
|
|||
|
|
```
|
|||
|
|
Attendu : rien, sauf des lignes « Historique » des fiches. Chaque ligne restante est corrigée, ou justifiée comme historique.
|
|||
|
|
|
|||
|
|
Run : `grep -n "analyse 0\|analyse_0\|src/" docs/decisions.md | awk -F: '$1 > 250'`
|
|||
|
|
Attendu : seule D-026 apparaît parmi les nouvelles lignes, et ses chemins sont les nouveaux.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### Task 4 : Vérification finale et commit
|
|||
|
|
|
|||
|
|
**Files:**
|
|||
|
|
- Modify : rien (vérification), puis commit de l'ensemble.
|
|||
|
|
|
|||
|
|
- [ ] **Step 1 : relancer les pages après les modifications de documents**
|
|||
|
|
|
|||
|
|
Le manuel est lu par la maquette client : sa partie 1 a pu changer à la tâche 3.
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && rm -r out && export PATH="$S/fakebin:$PATH"
|
|||
|
|
python3 src/energy/daily.py && python3 src/energy/all_analyses.py && python3 src/energy/focus_jour.py 27.09 && python3 maquettes/user/energy.py && python3 maquettes/support/home.py
|
|||
|
|
rm -rf $S/final && cp -r out $S/final && python3 $S/compare.py $S/after $S/final
|
|||
|
|
```
|
|||
|
|
Attendu : tout `identique`, sauf `maquette_user_energy.html` si la partie 1 du manuel a été touchée. La partie 1 ne cite ni chemin ni numéro, donc elle devrait rester identique ; toute différence doit venir du seul texte du guide.
|
|||
|
|
|
|||
|
|
- [ ] **Step 2 : rendre l'ancien `out/` ?**
|
|||
|
|
|
|||
|
|
Non : `$S/out-orig` contient les anciennes pages, régénérables. Le `out/` actuel les remplace, avec les mêmes noms.
|
|||
|
|
|
|||
|
|
- [ ] **Step 3 : revue du diff**
|
|||
|
|
|
|||
|
|
Run : `git status --short && git diff --cached --stat -M && git diff --stat`
|
|||
|
|
Attendu : des renommages (`R`) pour les déplacements, 3 nouveaux fichiers (`src/common/stations.py`, `src/common/page.py`, `src/energy/all_analyses.py`), 4 suppressions (`analyse_0N.py`) et aucun fichier de `data/`, `docs/aimsight/` (contenus), `docs/superpowers/` (hors spec et plan) ou `architecture.drawio`.
|
|||
|
|
|
|||
|
|
- [ ] **Step 4 : commit unique**
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /home/maxime/Support-Agent && git add -A src docs .claude CLAUDE.md README.md maquettes && git status --short
|
|||
|
|
git commit -m "$(cat <<'EOF'
|
|||
|
|
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>
|
|||
|
|
EOF
|
|||
|
|
)"
|
|||
|
|
git log --stat -1 | head -60
|
|||
|
|
```
|