Plan analysis 04 DAILY_BATTERY_TREND implementation
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
f518881121
commit
722ea0841b
1 file changed
+428
@@ -0,0 +1,428 @@
|
||||
# Analyse 04 `DAILY_BATTERY_TREND` — 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 :** donner, pour chaque jour UTC, la tendance de la batterie face à la veille (`BETTER`, `STABLE`, `WORSE` ou UNKNOWN), et l'afficher en quatrième panneau de la page commune.
|
||||
|
||||
**Architecture :**
|
||||
- un module de calcul en bibliothèque standard, `src/battery_trend.py`, qui appelle `battery_state.run()` (analyse 03) et compare chaque jour à la veille ;
|
||||
- un panneau en barres dans `src/energy_plot.py`, ajouté à la liste des analyses de la page ;
|
||||
- un point d'entrée `src/analyse_04.py` qui lance la page commune, comme `analyse_03.py`.
|
||||
|
||||
**Tech Stack :** Python 3 (bibliothèque standard) pour le calcul ; plotly (`.venv`) pour le graphique.
|
||||
|
||||
**Spec :** `docs/analyses/analyse_04.md` (sections « Principe », « Constantes et sources », « Graphique », « Résultats »).
|
||||
|
||||
## Global Constraints
|
||||
|
||||
- `src/battery_trend.py` : bibliothèque standard uniquement (code embarquable). Plotly seulement dans `src/energy_plot.py`.
|
||||
- Contrat commun : `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`. Calcul causal : le jour J n'utilise que J et J−1.
|
||||
- `anomaly = None` pour tous les jours (pas de verdict). La tendance UNKNOWN est portée par `facts["trend"] = None`.
|
||||
- Constantes : `NIGHT_END_DEADBAND_V = 0.05` ; `STATE_RANK = {"FULL_CHARGE": 3, "PARTIAL_CHARGE": 2, "NO_CHARGE": 1, "BELOW_PLATEAU": 0}`, chacune avec sa source en commentaire.
|
||||
- Identifiants en anglais, en mots complets (D-017) : `DAILY_BATTERY_TREND`, `BETTER`, `STABLE`, `WORSE`, `state`, `night_end`. Libellés du graphique en français : mieux, stable, pire.
|
||||
- Couleurs du panneau : paire divergente du skill dataviz, bleu `#2a78d6` (mieux), gris `#8c8c8c` (stable), rouge `#d03b3b` (pire). Le vert prévu dans la spec est refusé par le validateur dataviz (vert `#008300` / rouge : ΔE 5,9 en deutéranopie, sous le plancher de 6).
|
||||
- **Pas de tests automatisés** (D-008) et **pas de données synthétiques** (refus de l'utilisateur). La vérification se fait en lançant le code sur les données réelles de VERMONT (`data/`), avec des `assert` dans une commande ponctuelle, sans fichier de test.
|
||||
- Ne pas modifier `src/__main__ (3).py`, `architecture.drawio`, ni `src/battery_state.py`.
|
||||
- Documents projet en français. Commits en anglais, terminés par `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
|
||||
|
||||
## Review Focus
|
||||
|
||||
1. **Premier jour de l'export** (VERMONT 2026-04-09) : pas de veille, donc `trend = None`, `decided_by = None`, tous les écarts à `None`, et pas de barre. Vérifié dans la tâche 1.
|
||||
2. **L'état décide contre le signe de la fin de nuit** (VERMONT 2026-08-29, `FULL_CHARGE` → `PARTIAL_CHARGE`, `delta_night_end_v` = +0,041 V) : `WORSE`, `decided_by = "state"`. Vérifié dans la tâche 1.
|
||||
3. **Écart pile à ±0,05 V** : les fins de nuit sont arrondies au mV par l'analyse 03, et une différence de flottants comme 13,15 − 13,10 donne 0,04999… L'écart est donc arrondi au mV **avant** la comparaison stricte, et 0,05 V donne `STABLE`. VERMONT n'a pas ce cas, et D-008 interdit d'en fabriquer : on vérifie à la relecture l'ordre `round` puis `>`, dans la tâche 1.
|
||||
4. **Jour manquant entre deux jours** (export troué de plus d'un jour entier) : J−1 n'est pas la veille calendaire, donc `trend = None`. VERMONT n'a pas de jour entier absent de la grille : on vérifie à la relecture le test `date(J) − date(J−1) == 1 jour`, dans la tâche 1.
|
||||
5. **Zoom sur le panneau des barres** : la zone morte (une seule courbe, `None` entre +0,05 et −0,05) et les barres doivent rester visibles, et l'ordonnée doit se recaler. Le script `AUTOSCALE_Y_JS` lit `t.x` et `t.y`, que les barres ont aussi. Vérifié à l'œil dans la tâche 2.
|
||||
|
||||
---
|
||||
|
||||
### Task 1 : calcul `src/battery_trend.py`
|
||||
|
||||
**Files :**
|
||||
- Create : `src/battery_trend.py`
|
||||
|
||||
**Interfaces :**
|
||||
- Consomme : `battery_state.run(series)`. Ses points ont `t` (datetime UTC, dernière heure du jour) et `facts` = `{state, max_v, min_v, night_end_v, rise_v, hours_full, coverage}`, ou `{state: None, coverage: 0.0}` pour un jour sans mesure. Les séries `{metric: {datetime UTC: float | None}}` viennent de `energy_check.load_stations(paths)`.
|
||||
- Produit :
|
||||
- `battery_trend.RULE` : dict avec les clés `id`, `verdict`, `night_end_deadband_v`, `state_rank`, `doc` ;
|
||||
- `battery_trend.run(series) -> {analysis, rule, points}` : un point par jour UTC, `t` = celui de l'analyse 03, `value` = `facts["delta_night_end_v"]`, `anomaly = None`, `facts` = `{trend, decided_by, state_prev, state, delta_night_end_v, delta_max_v, delta_hours_full}`.
|
||||
|
||||
- [ ] **Step 1 : lancer la commande de vérification (elle échoue tant que le module n'existe pas)**
|
||||
|
||||
Run :
|
||||
```bash
|
||||
cd /home/maxime/Support-Agent && python3 - <<'EOF'
|
||||
import sys; sys.path.insert(0, "src")
|
||||
from collections import Counter
|
||||
import energy_check as ec, battery_trend as bt
|
||||
r = bt.run(ec.load_stations(["data"])["VERMONT"])
|
||||
p = {q["t"].date().isoformat(): q for q in r["points"]}
|
||||
counts = dict(Counter(q["facts"]["trend"] for q in r["points"]))
|
||||
print(r["analysis"], len(r["points"]), counts)
|
||||
assert r["analysis"] == "DAILY_BATTERY_TREND" and len(r["points"]) == 184
|
||||
assert counts == {None: 1, "STABLE": 137, "WORSE": 26, "BETTER": 20}, counts
|
||||
assert all(q["anomaly"] is None and q["value"] == q["facts"]["delta_night_end_v"] for q in r["points"])
|
||||
# Premier jour : pas de veille.
|
||||
assert p["2026-04-09"]["facts"] == {"trend": None, "decided_by": None, "state_prev": None, "state": "FULL_CHARGE",
|
||||
"delta_night_end_v": None, "delta_max_v": None, "delta_hours_full": None}
|
||||
# L'état décide, même contre le signe de la fin de nuit.
|
||||
f = p["2026-08-29"]["facts"]
|
||||
assert (f["trend"], f["decided_by"], f["state_prev"], f["state"], f["delta_night_end_v"]) == \
|
||||
("WORSE", "state", "FULL_CHARGE", "PARTIAL_CHARGE", 0.041), f
|
||||
assert p["2026-09-02"]["facts"]["trend"] == "BETTER" # PARTIAL_CHARGE -> FULL_CHARGE
|
||||
# Même état : la fin de nuit décide.
|
||||
f = p["2026-09-16"]["facts"]
|
||||
assert (f["trend"], f["decided_by"], f["delta_night_end_v"], f["delta_max_v"], f["delta_hours_full"]) == \
|
||||
("WORSE", "night_end", -0.103, -0.052, 0), f
|
||||
assert p["2026-09-22"]["facts"]["trend"] == "STABLE" # -0,016 V : dans la zone morte (limite 2 de la fiche)
|
||||
assert p["2026-10-01"]["facts"]["trend"] == "BETTER" # +0,284 V, jour de coupure (limite 1 de la fiche)
|
||||
# Jours sains : FULL_CHARGE enchaînés presque tous STABLE.
|
||||
full = Counter(q["facts"]["trend"] for q in r["points"] if q["facts"]["state_prev"] == q["facts"]["state"] == "FULL_CHARGE")
|
||||
assert full == {"STABLE": 120, "BETTER": 4, "WORSE": 1}, full
|
||||
print(" ".join(d[5:] for d, q in sorted(p.items()) if q["facts"]["trend"] == "WORSE" and d >= "2026-08-01"))
|
||||
print("OK")
|
||||
EOF
|
||||
```
|
||||
Expected : `ModuleNotFoundError: No module named 'battery_trend'`.
|
||||
|
||||
- [ ] **Step 2 : créer `src/battery_trend.py`**
|
||||
|
||||
```python
|
||||
"""Analyse 04 DAILY_BATTERY_TREND : tendance de la batterie d'un jour à l'autre (modèle markovien : J face à J−1).
|
||||
|
||||
Documentation : docs/analyses/analyse_04.md
|
||||
Bibliothèque standard uniquement (cible : système embarqué de la station).
|
||||
"""
|
||||
from datetime import timedelta
|
||||
|
||||
import battery_state as bs
|
||||
|
||||
# Constantes (fiche analyse_04, « Constantes et sources »).
|
||||
NIGHT_END_DEADBAND_V = 0.05 # VERMONT : FULL_CHARGE enchaînés, écart de fin de nuit -0,026 à +0,043 V (5e-95e centiles, 125 paires)
|
||||
STATE_RANK = {"FULL_CHARGE": 3, "PARTIAL_CHARGE": 2, "NO_CHARGE": 1, "BELOW_PLATEAU": 0} # choix de conception (fiche 04)
|
||||
|
||||
RULE = {
|
||||
"id": "DAILY_BATTERY_TREND",
|
||||
"verdict": "aucun : anomaly = None ; la tendance est dans facts.trend",
|
||||
"night_end_deadband_v": NIGHT_END_DEADBAND_V,
|
||||
"state_rank": STATE_RANK,
|
||||
"doc": "docs/analyses/analyse_04.md",
|
||||
}
|
||||
|
||||
|
||||
def delta(prev, cur, key):
|
||||
"""Écart cur − prev d'un fait de DAILY_BATTERY_STATE, None si l'un des deux manque."""
|
||||
if prev.get(key) is None or cur.get(key) is None:
|
||||
return None
|
||||
return round(cur[key] - prev[key], 3) # arrondi au mV avant la comparaison à la zone morte
|
||||
|
||||
|
||||
def run(series):
|
||||
"""Analyse DAILY_BATTERY_TREND, causale : le jour J n'utilise que J et J−1. Un point par jour UTC."""
|
||||
points, prev = [], None
|
||||
for p in bs.run(series)["points"]:
|
||||
a = prev["facts"] if prev and p["t"].date() - prev["t"].date() == timedelta(days=1) else {} # J−1, sinon rien
|
||||
b = p["facts"]
|
||||
facts = {"trend": None, "decided_by": None, "state_prev": a.get("state"), "state": b["state"],
|
||||
"delta_night_end_v": delta(a, b, "night_end_v"), "delta_max_v": delta(a, b, "max_v"),
|
||||
"delta_hours_full": delta(a, b, "hours_full")}
|
||||
if facts["state_prev"] and facts["state"]:
|
||||
if facts["state_prev"] != facts["state"]: # l'état a changé : il décide
|
||||
up = STATE_RANK[facts["state"]] > STATE_RANK[facts["state_prev"]]
|
||||
facts.update(trend="BETTER" if up else "WORSE", decided_by="state")
|
||||
else: # même état : la fin de nuit décide, avec une zone morte
|
||||
d = facts["delta_night_end_v"]
|
||||
trend = "BETTER" if d > NIGHT_END_DEADBAND_V else "WORSE" if d < -NIGHT_END_DEADBAND_V else "STABLE"
|
||||
facts.update(trend=trend, decided_by="night_end")
|
||||
points.append({"t": p["t"], "value": facts["delta_night_end_v"], "anomaly": None, "facts": facts})
|
||||
prev = p
|
||||
return {"analysis": RULE["id"], "rule": RULE, "points": points}
|
||||
```
|
||||
|
||||
- [ ] **Step 3 : relancer la commande du Step 1**
|
||||
|
||||
Expected : la première ligne est `DAILY_BATTERY_TREND 184 {None: 1, 'STABLE': 137, 'WORSE': 26, 'BETTER': 20}`. L'avant-dernière ligne est `08-03 08-15 08-18 08-29 08-30 09-06 09-08 09-10 09-12 09-16 09-20 09-21 09-25 09-26 09-27 10-02 10-09`, puis vient `OK`. Garder ces valeurs pour la fiche (tâche 3).
|
||||
|
||||
- [ ] **Step 4 : commit**
|
||||
|
||||
```bash
|
||||
cd /home/maxime/Support-Agent && git add src/battery_trend.py && git commit -q -F - <<'EOF'
|
||||
Add analysis 04 DAILY_BATTERY_TREND computation
|
||||
|
||||
Day-over-day trend from DAILY_BATTERY_STATE: a state change decides
|
||||
(FULL > PARTIAL > NO_CHARGE > BELOW_PLATEAU), otherwise the night-end
|
||||
voltage delta with a 0.05 V dead band. No verdict (anomaly = None).
|
||||
|
||||
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
||||
EOF
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Task 2 : panneau du graphique
|
||||
|
||||
**Files :**
|
||||
- Modify : `src/energy_plot.py` (docstring ligne 3, imports, nouvelle constante `TREND_STYLE` et fonction `daily_trend_panel` avant `gaps()`, boucle des analyses dans `figure()`, `update_layout` de `figure()`, liste des résultats dans `main()`)
|
||||
|
||||
**Interfaces :**
|
||||
- Consomme : `battery_trend.run(series)` et `battery_trend.RULE` (tâche 1). Champs utilisés : `value`, `facts.trend`, `facts.decided_by`, `facts.state_prev`, `facts.state`, les trois `facts.delta_*`, et la clé de règle `night_end_deadband_v`.
|
||||
- Produit : `energy_plot.daily_trend_panel(fig, result, row)`. `figure()` dessine ce panneau pour tout résultat dont `analysis == battery_trend.RULE["id"]`.
|
||||
|
||||
- [ ] **Step 1 : lancer la commande de vérification (elle échoue tant que le panneau n'existe pas)**
|
||||
|
||||
Run :
|
||||
```bash
|
||||
cd /home/maxime/Support-Agent && .venv/bin/python src/energy_plot.py data/ && python3 - <<'EOF'
|
||||
import re
|
||||
h = open("out/VERMONT_energy.html").read()
|
||||
print(sorted(set(re.findall(r'"text":"Analyse [^"]*"', h))))
|
||||
assert '"text":"Analyse DAILY_BATTERY_TREND"' in h
|
||||
for n in ("zone morte \\u00b10.05 V", "mieux", "stable", "pire"): # plotly écrit « ± » en ±
|
||||
assert f'"name":"{n}"' in h, n
|
||||
assert '"barmode":"overlay"' in h
|
||||
print("OK")
|
||||
EOF
|
||||
```
|
||||
Expected : `AssertionError` (le titre `Analyse DAILY_BATTERY_TREND` est absent).
|
||||
|
||||
- [ ] **Step 2 : importer le module de calcul et mettre à jour la docstring**
|
||||
|
||||
Dans `src/energy_plot.py`, sous `import battery_state as bs` :
|
||||
|
||||
```python
|
||||
import battery_trend as bt
|
||||
```
|
||||
|
||||
Ligne 3, remplacer :
|
||||
`Documentation : docs/analyses/analyse_01.md, docs/analyses/analyse_02.md, docs/analyses/analyse_03.md`
|
||||
par :
|
||||
`Documentation : docs/analyses/analyse_01.md à analyse_04.md`
|
||||
|
||||
- [ ] **Step 3 : ajouter le style des tendances et le panneau, juste avant `def gaps(v):`**
|
||||
|
||||
```python
|
||||
# Tendances de DAILY_BATTERY_TREND : paire divergente bleu/rouge et gris neutre du skill dataviz
|
||||
# (vert/rouge refusé par son validateur : deutéranopie, ΔE 5,9). Chaque tendance a aussi sa légende et son survol.
|
||||
TREND_STYLE = {"BETTER": ("mieux", "#2a78d6"), "STABLE": ("stable", "#8c8c8c"), "WORSE": ("pire", "#d03b3b")}
|
||||
|
||||
|
||||
def daily_trend_panel(fig, result, row):
|
||||
"""Panneau DAILY_BATTERY_TREND : écart de fin de nuit J − J−1 en barres, couleur = tendance (fiche analyse_04)."""
|
||||
group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}")
|
||||
pts, db = result["points"], result["rule"]["night_end_deadband_v"]
|
||||
x = [p["t"] for p in pts]
|
||||
# Zone morte tracée comme une courbe (un point par jour, None entre +db et −db) : visible au zoom (D-013).
|
||||
fig.add_scatter(x=x + [None] + x, y=[db] * len(x) + [None] + [-db] * len(x), name=f"zone morte ±{db} V",
|
||||
mode="lines", hoverinfo="skip", line=dict(color="#52514e", dash="dash", width=1),
|
||||
row=row, col=1, **group)
|
||||
for trend, (label, color) in TREND_STYLE.items():
|
||||
sel = [p for p in pts if p["facts"]["trend"] == trend and p["value"] is not None]
|
||||
if not sel:
|
||||
continue
|
||||
hover = [f"{p['t']:%Y-%m-%d} : {label} (décidé par {p['facts']['decided_by']})<br>"
|
||||
f"{p['facts']['state_prev']} → {p['facts']['state']}<br>"
|
||||
+ "<br>".join(f"{k}={v}" for k, v in p["facts"].items() if k.startswith("delta")) for p in sel]
|
||||
fig.add_bar(x=[p["t"] for p in sel], y=[p["value"] for p in sel], name=label, marker_color=color,
|
||||
width=0.8 * 86_400_000, hovertext=hover, hovertemplate="%{hovertext}<extra></extra>",
|
||||
row=row, col=1, **group)
|
||||
fig.update_yaxes(title_text="Δ fin de nuit [V]", row=row, col=1)
|
||||
```
|
||||
|
||||
Notes pour l'implémenteur :
|
||||
- `hovertext` et non `text` : sur une barre, plotly écrit `text` dans la barre ;
|
||||
- `width` est en millisecondes sur un axe de dates : 0,8 jour.
|
||||
|
||||
- [ ] **Step 4 : brancher le panneau dans `figure()`**
|
||||
|
||||
Remplacer :
|
||||
|
||||
```python
|
||||
if result["analysis"] == bs.RULE["id"]:
|
||||
daily_state_panel(fig, result, row)
|
||||
continue
|
||||
```
|
||||
|
||||
par :
|
||||
|
||||
```python
|
||||
if result["analysis"] == bs.RULE["id"]:
|
||||
daily_state_panel(fig, result, row)
|
||||
continue
|
||||
if result["analysis"] == bt.RULE["id"]:
|
||||
daily_trend_panel(fig, result, row)
|
||||
continue
|
||||
```
|
||||
|
||||
Dans le `fig.update_layout(...)` de `figure()`, remplacer :
|
||||
|
||||
```python
|
||||
legend=dict(groupclick="toggleitem"))
|
||||
```
|
||||
|
||||
par :
|
||||
|
||||
```python
|
||||
barmode="overlay", legend=dict(groupclick="toggleitem"))
|
||||
```
|
||||
|
||||
En mode `group` (le défaut), plotly décalerait et amincirait les barres des trois tendances, comme s'il fallait les placer côte à côte.
|
||||
|
||||
- [ ] **Step 5 : ajouter le résultat dans `main()`**
|
||||
|
||||
Remplacer :
|
||||
|
||||
```python
|
||||
figure(station, series, [ec.run(series), ec.run_midnight(series), bs.run(series)]).write_html(
|
||||
```
|
||||
|
||||
par :
|
||||
|
||||
```python
|
||||
figure(station, series, [ec.run(series), ec.run_midnight(series), bs.run(series), bt.run(series)]).write_html(
|
||||
```
|
||||
|
||||
- [ ] **Step 6 : relancer la commande du Step 1**
|
||||
|
||||
Expected : la liste des titres contient `Analyse DAILY_BATTERY_TREND`, puis `OK`.
|
||||
|
||||
- [ ] **Step 7 : vérification visuelle**
|
||||
|
||||
Run : `cd /home/maxime/Support-Agent && python3 src/analyse_01.py` (la page s'ouvre dans le navigateur).
|
||||
À vérifier à l'œil :
|
||||
- le quatrième panneau se trouve sous `DAILY_BATTERY_STATE`, avec des barres d'environ un jour de large, non décalées ;
|
||||
- la zone morte est en tirets à +0,05 et −0,05 V ;
|
||||
- au survol d'une barre, on lit la tendance, ce qui l'a décidée, l'état de la veille puis celui du jour, et les trois écarts ;
|
||||
- en zoomant sur septembre 2026, l'ordonnée se recale, et les barres comme la zone morte restent visibles ;
|
||||
- les barres rouges se répètent en septembre ; le 29/08 est rouge malgré une barre positive (l'état décide).
|
||||
|
||||
- [ ] **Step 8 : commit**
|
||||
|
||||
```bash
|
||||
cd /home/maxime/Support-Agent && git add src/energy_plot.py && git commit -q -F - <<'EOF'
|
||||
Plot DAILY_BATTERY_TREND as the fourth analysis panel
|
||||
|
||||
One bar per day for the night-end voltage delta, coloured by trend
|
||||
(blue better, grey stable, red worse), with the 0.05 V dead band.
|
||||
|
||||
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
||||
EOF
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Task 3 : point d'entrée et documentation
|
||||
|
||||
**Files :**
|
||||
- Create : `src/analyse_04.py`
|
||||
- Modify : `src/analyse_01.py:2` (docstring)
|
||||
- Modify : `docs/analyses/analyse_04.md` (statut, graphique, résultats, options écartées, historique)
|
||||
- Modify : `docs/analyses/analyse_01.md:43` (section « Graphique »)
|
||||
- Modify : `CLAUDE.md` (« État et prochaine étape », tableau « Analyses », « Commandes », « Fichiers », contrat commun dans « Principes »)
|
||||
- Modify : `.claude/rules/analyses.md:17` (contrat commun)
|
||||
- Modify : `README.md:33` (analyses en place)
|
||||
|
||||
**Interfaces :**
|
||||
- Consomme : la page commune produite par `analyse_01.py` (tâche 2) ; les valeurs imprimées au Step 3 de la tâche 1.
|
||||
- Produit : la commande `python3 src/analyse_04.py`.
|
||||
|
||||
- [ ] **Step 1 : créer `src/analyse_04.py`**
|
||||
|
||||
```python
|
||||
"""Analyse 04 : DAILY_BATTERY_TREND (tendance de la batterie d'un jour à l'autre, J face à J−1).
|
||||
|
||||
Son graphique est le quatrième panneau d'analyse de la page commune : ce script lance analyse_01.py.
|
||||
Usage : python3 src/analyse_04.py [CSV ou dossiers...] (défaut : data/, sortie dans out/)
|
||||
Documentation : docs/analyses/analyse_04.md
|
||||
"""
|
||||
import runpy
|
||||
from pathlib import Path
|
||||
|
||||
runpy.run_path(str(Path(__file__).with_name("analyse_01.py")), run_name="__main__")
|
||||
```
|
||||
|
||||
- [ ] **Step 2 : lancer le point d'entrée**
|
||||
|
||||
Run : `cd /home/maxime/Support-Agent && python3 src/analyse_04.py`
|
||||
Expected : `/home/maxime/Support-Agent/out/VERMONT_energy.html`, et la page s'ouvre dans le navigateur.
|
||||
|
||||
- [ ] **Step 3 : docstring de `src/analyse_01.py`**
|
||||
|
||||
Remplacer la ligne 2 :
|
||||
`La page montre aussi, dessous, les analyses 02 (MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP) et 03 (DAILY_BATTERY_STATE).`
|
||||
par :
|
||||
`La page montre aussi, dessous, les analyses 02 (MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP), 03 (DAILY_BATTERY_STATE) et 04 (DAILY_BATTERY_TREND).`
|
||||
|
||||
- [ ] **Step 4 : fiche `docs/analyses/analyse_04.md`**
|
||||
|
||||
- Statut : `` **Statut** : prototype en place (2026-10-12). Pas de verdict : `anomaly = None`, la tendance est dans `facts.trend`. ``
|
||||
- Section « Graphique », dans le premier point de « Contenu », remplacer `(vert : mieux ; gris : stable ; rouge : pire ; tendance inconnue : pas de barre)` par :
|
||||
`(bleu : mieux ; gris : stable ; rouge : pire ; tendance inconnue : pas de barre). Ce sont la paire divergente et le gris neutre du skill dataviz.`
|
||||
- Section « Résultats sur VERMONT (jeu de travail) » : remplacer tout le contenu de la section par :
|
||||
|
||||
```markdown
|
||||
Sur 184 jours (du 2026-04-09 au 2026-10-09) :
|
||||
- **Répartition** : 137 `STABLE`, 26 `WORSE`, 20 `BETTER`, 1 UNKNOWN (le 2026-04-09, premier jour de l'export, sans veille).
|
||||
- **Jours sains** : sur 125 paires `FULL_CHARGE` enchaînées, 120 sont `STABLE`, 4 `BETTER` et 1 `WORSE`.
|
||||
- **`WORSE` isolés en août** (08-03, 08-15, 08-18) : des jours nuageux, chacun suivi d'un `BETTER`.
|
||||
- **Fin août à septembre** : des `WORSE` répétés (08-29, 08-30, 09-06, 09-08, 09-10, 09-12, 09-16, 09-20, 09-21, puis 09-25 à 09-27, passage sous le plateau). Chacun est suivi d'un `BETTER` le jour d'une pleine charge. C'est cohérent avec l'expert : charges complètes de plus en plus rares, puis déficit vers le 20/09.
|
||||
- **L'état décide contre la fin de nuit** : le 2026-08-29 (`FULL_CHARGE` → `PARTIAL_CHARGE`) est `WORSE`, alors que la fin de nuit monte de +0,041 V.
|
||||
- **Sous le plateau** (du 26/09 au 09/10) : des `BETTER` les 01/10, 03/10 et 08/10, faux (limite 1).
|
||||
```
|
||||
|
||||
Si les valeurs imprimées au Step 3 de la tâche 1 diffèrent, reporter celles-là.
|
||||
- Section « Options écartées », ajouter la ligne :
|
||||
`| Vert pour « mieux » (design validé en brainstorming) | Refusé par le validateur du skill dataviz : vert `#008300` et rouge `#d03b3b` ne se distinguent pas en deutéranopie (ΔE 5,9, sous le plancher de 6). Remplacé par le bleu de la paire divergente. |`
|
||||
- Historique, ajouter :
|
||||
`` - **2026-10-12** : implémentée (`src/battery_trend.py`, panneau dans `energy_plot.py`, point d'entrée `analyse_04.py`). Résultats conformes à l'essai de conception, à un UNKNOWN près (le premier jour, sans veille). Couleur de « mieux » : bleu au lieu de vert (skill dataviz). ``
|
||||
|
||||
- [ ] **Step 5 : fiche `docs/analyses/analyse_01.md`, section « Graphique »**
|
||||
|
||||
Après la ligne 43 (« **Puis le panneau de l'analyse 03**… »), ajouter :
|
||||
`` - **Puis le panneau de l'analyse 04** (`DAILY_BATTERY_TREND`) : tendance de la batterie d'un jour à l'autre (fiche `analyse_04.md`). ``
|
||||
|
||||
- [ ] **Step 6 : `CLAUDE.md`**
|
||||
|
||||
- « État et prochaine étape » : avant la ligne « **Prochaine étape** », ajouter :
|
||||
`` - **2026-10-12** : analyse 04 `DAILY_BATTERY_TREND` en place (tendance markovienne : chaque jour face à la veille, mieux / stable / pire). ``
|
||||
Remplacer la ligne « **Prochaine étape** » par :
|
||||
`` - **Prochaine étape** : phase B de l'analyse 03 (niveaux gradués à partir des séries d'états et des tendances de la 04, voir les pistes des fiches), puis la combinaison des analyses. ``
|
||||
- Tableau « Analyses », ajouter après la ligne 03 :
|
||||
`` | 04 | `DAILY_BATTERY_TREND` | Chaque jour, face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | prototype en place | `docs/analyses/analyse_04.md` | ``
|
||||
- « Commandes » :
|
||||
- dans la ligne `analyse_01.py`, remplacer `(panneaux des analyses 01, 02 et 03, D-016)` par `(panneaux des analyses 01 à 04, D-016)` ;
|
||||
- après la ligne `analyse_03.py`, ajouter : `` - `python3 src/analyse_04.py` : point d'entrée de l'analyse 04 ; il lance la même page. ``
|
||||
- « Fichiers », ligne `src/analyse_NN.py` : remplacer `` `src/battery_state.py` (analyse 03, idem) `` par `` `src/battery_state.py` (analyse 03, idem), `src/battery_trend.py` (analyse 04, idem) ``.
|
||||
- « Principes », contrat commun : remplacer
|
||||
`(exception : analyse 03 en phase C, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`)`
|
||||
par
|
||||
`(exception : analyses 03 en phase C et 04, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state` ou `facts.trend`)`.
|
||||
|
||||
- [ ] **Step 7 : `.claude/rules/analyses.md`, ligne 17**
|
||||
|
||||
Remplacer :
|
||||
`` - `anomaly = None` signifie UNKNOWN (exception : analyse 03 en phase C, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`) ; ``
|
||||
par :
|
||||
`` - `anomaly = None` signifie UNKNOWN (exception : analyses 03 en phase C et 04, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state` ou `facts.trend`) ; ``
|
||||
|
||||
- [ ] **Step 8 : `README.md`, ligne 33**
|
||||
|
||||
Remplacer `Trois analyses sont en place :` par `Quatre analyses sont en place :`, et `` `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour. `` par `` `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour ; `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. ``
|
||||
|
||||
- [ ] **Step 9 : contrôle de cohérence**
|
||||
|
||||
Run : `cd /home/maxime/Support-Agent && grep -n "en conception\|vert : mieux" CLAUDE.md docs/analyses/analyse_04.md; grep -c "analyse_04.py" CLAUDE.md; wc -l CLAUDE.md`
|
||||
Expected : aucune ligne pour le premier `grep` ; `1` pour le second ; moins de 200 lignes pour `CLAUDE.md`.
|
||||
|
||||
- [ ] **Step 10 : commit**
|
||||
|
||||
```bash
|
||||
cd /home/maxime/Support-Agent && git add src/analyse_04.py src/analyse_01.py docs/analyses/analyse_04.md docs/analyses/analyse_01.md CLAUDE.md .claude/rules/analyses.md README.md && git commit -q -F - <<'EOF'
|
||||
Add analysis 04 entry point and documentation
|
||||
|
||||
src/analyse_04.py launches the common page; sheet 04 moves to
|
||||
"prototype en place" with VERMONT results; CLAUDE.md, the analyses
|
||||
rule, README and sheet 01 list the fourth panel and extend the
|
||||
"no verdict" contract exception to analysis 04.
|
||||
|
||||
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
||||
EOF
|
||||
```
|
||||
Reference in new issue
Block a user