Files
Support-Agent/.claude/rules/analyses.md
T
maximeandClaude Opus 5.5 9177982de1 Add DAILY_MAINS_POWER: on mains, a mains loss turns the day red at once
A station is on mains when its BusVoltage mean over the 3 days before
the day is >= 14.0 V (solar never exceeds 13.50 V on VERMONT; mains
stays >= 14.08 V). On mains, the mains loss decides the day color
instead of the state x trend matrix: red as soon as an hour falls under
13.4 V (top of the OCV plateau; mains-on hours stay >= 13.65 V, mains-off
hours are 13.1-13.3 V). On MISSISSIPPI the day turns red 1-2 h after the
loss instead of 29-40 h with the matrix; WEISSHORN and NORDEND (mains)
raise no false alert, VERMONT (solar) is unchanged (D-043).

The matrix drawio gets the mains case, the site figure a third panel,
and the support notification and the client Energy block header show
"On mains" / "Not on mains" / "Mains unknown".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 17:22:16 +02:00

30 lines
2.4 KiB
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, `DAILY_BATTERY_TREND`, `DAILY_LINK_STATE`, `DAILY_SIGNAL_STATE`, `DAILY_STORAGE_STATE`, `DAYS_UNTIL_STORAGE_FULL` et `DAILY_MAINS_POWER`, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`, `facts.trend`, `facts.filling` ou `facts.power`) ;
- 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 le jeu de travail du domaine : VERMONT (`data/VERMONT/`) pour Energy, avec `python3 src/energy/all_analyses.py`, et `python3 src/energy/final.py` si l'analyse est livrée ; WEISSHORN (`data/WEISSHORN/`) pour Storage et Cellular (D-030) ; WEISSHORN et NORDEND pour Temperature (D-040). Pas de tests automatisés en phase prototype (D-008).
- **Nouvelle analyse** : utiliser le skill `nouvelle-analyse`.