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>
53 KiB
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.htmletmaquette_support_home.html.<STATION>_energy.jsonn'est plus produit. moving_average.py,battery_state.py,battery_trend.pyetday_color.py: bibliothèque standard uniquement, sans aucun import decommon.- Contenu intact :
architecture.drawio, les documents AIMsight, le collecteur, la matrice.drawio,data/etdocs/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.mdreste 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 etout/doivent se résoudre depuis__file__, pas depuis le dossier courant. Vérifié à l'étape 2.9. python3système sans plotly : la bascule sur.venvdoit encore marcher, avecROOTcalculé depuissrc/common/page.py. Exercé par chaque lancement de la tâche 2, tous faits avecpython3.- Copie embarquée de
src/energy/seul : les quatre modules de calcul doivent s'importer sanscommonni plotly. Vérifié à l'étape 2.8. - Plusieurs stations ou un autre dossier en argument (
daily.py data/archive) : une page par station qui aBusVoltage, 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) etpython3 $S/compare.py AVANT APRÈS, qui afficheidentique,DIFFÉRENT(avec un extrait de chaque ligne différente) ouabsent avant/aprèspour chaque fichier. -
Step 1 : faux
explorer.exe(aucun onglet ouvert pendant les essais)
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
"""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é.
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.pyet$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_MIDNIGHTet 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
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 :
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):etreturn 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(…etreturn 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)
"""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 :
import battery_state as bs
import battery_trend as bt
par :
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 :
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.
- ligne 1 :
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 :
"""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 :
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 :
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 :
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 :
from analyse_01 import open_html # noqa: E402
import day_color as dc # noqa: E402
import energy_check as ec # noqa: E402
par :
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 :
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
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 :
identiquepourVERMONT_daily.html,VERMONT_daily.json,VERMONT_energy.htmletmaquette_support_home.html;DIFFÉRENTpourVERMONT_focus_2026-09-27.htmlet.json, sur le seul sous-titre (thresholds of the daily state,(trend)) ;DIFFÉRENTpourmaquette_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)
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)
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 dedocs/domaine/etdocs/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
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.
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 « fichedaily_battery_state.md», et ainsi de suite.
- « l'analyse 01 » ou « analyse 01 » devient
- 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 :
- **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/_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 :
- **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 :
- **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 :
- **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 :
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`devientcalculé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.devientla 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.09devientpython3 src/energy/focus_jour.py 27.09. -
Langue et panneaux :
des panneaux 03 et 04devientdes 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),devientPanneau `DAILY_BATTERY_STATE`,` ;**Panneau \DAILY_BATTERY_TREND`** (analyse 04),devientPanneau `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)
---
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 :
---
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 :
# `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.mdetREADME.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 placedevient`MOVING_AVERAGE_7_DAYS_DROP` est en place;Point ouvert de l'analyse 01devientPoint 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 comparerdevient ``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 01devientcontre ~2,7 jours;analyse 03 \DAILY_BATTERY_STATE` en placedevient ``DAILY_BATTERY_STATE` en place `` ;analyse 04 \DAILY_BATTERY_TREND` en placedevient ``DAILY_BATTERY_TREND` en place `` ;ne retient que les analyses 03 et 04devientne retient que `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND`;panneau 03 en haut et 04 dessousdevientl'état en haut et la tendance dessous;figure 03 × 04 comprisedevientfigure état × tendance comprise;- les chemins
src/day_color.pyetsrc/focus_jour.pypassent soussrc/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 :
## 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 :
## 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.mddevient- \docs//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 :
- `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/`devientun savoir métier nouveau va dans `docs/domaine/` (commun) ou `docs//domaine/`` ; quand Claude touche \src/` ou `docs/analyses/`devientquand Claude touche `src/` ou `docs/*/analyses/`` ;- dans la puce
docs/superpowers/, la fiche devientdocs/<domaine>/analyses/<règle>.md.
Section « Fichiers » :
- la puce
doc/et ses sous-puces deviennent :
- `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.pyetsrc/__main__ (3).pysont remplacées par :
- `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 04devientexception : `DAILY_BATTERY_STATE` en phase C et `DAILY_BATTERY_TREND`;en lançant \python3 src/analyse_01.py` sur VERMONTdevienten 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 :
## 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.
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
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