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

2.4 KiB

paths
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.