- Analysis 02 MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP: same rule as analysis 01 on the 00:00 UTC BusVoltage sample only, one point per day. Shared computation in energy_check._ma_drop(); analysis 01 results unchanged on VERMONT. - Common page: one panel per analysis (02 under 01), then the time series (D-016); src/analyse_02.py launches that page. - Analysis panel reduced to two curves on one volt axis: 7-day mean and threshold; gap and reference moved to hover (D-015). - Date tick labels under every subplot. - Rule IDs spelled out: MA7D_DROP -> MOVING_AVERAGE_7_DAYS_DROP, MA7D_MIDNIGHT_DROP -> MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP (D-017). - Docs: analysis sheet 02, sheet 01, CLAUDE.md, README, decisions D-015..D-017, analysis rule and nouvelle-analyse skill. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
150 lines
13 KiB
Markdown
150 lines
13 KiB
Markdown
# Journal des décisions
|
||
|
||
Décisions de niveau **projet**, au format ADR allégé (inspiré de MADR). Ce qui est propre à une analyse va dans sa fiche (`docs/analyses/analyse_NN.md`).
|
||
|
||
Règles du journal :
|
||
- On ajoute, on ne réécrit pas.
|
||
- Une décision qui change garde son texte : son **statut** devient « remplacée par D-0XX », et la nouvelle entrée cite l'ancienne.
|
||
- Champs : **Statut**, **Décision**, **Pourquoi**, **Options écartées** (avec leur raison, pour ne pas les reproposer), **Conséquence**. Les champs sans objet sont omis.
|
||
- Statuts : `active` · `remplacée par D-0XX` · `remplacée en partie par D-0XX` · `abandonnée`.
|
||
|
||
---
|
||
|
||
## D-001 — 2026-10-09 — Point d'entrée : scan proactif d'un export
|
||
- **Statut** : active.
|
||
- **Décision** : l'agent parcourt un export, détecte les événements, les classe et explique chacun.
|
||
- **Pourquoi** : expliquer l'anomalie avant que le client ne pose la question.
|
||
- **Options écartées** : commencer par le mode « question de support » (« pourquoi D-300-A a sauté ? ») ; il viendra ensuite, sur le même socle.
|
||
|
||
## D-002 — 2026-10-09 — Premier cas d'usage : santé énergétique des stations
|
||
- **Statut** : active.
|
||
- **Décision** : commencer par la tension batterie et les interruptions de mesure, sur des stations solaires et sur secteur.
|
||
- **Pourquoi** : cas simple et fréquent, avec des diagnostics experts disponibles. Ici, le trou de données *est* l'anomalie.
|
||
- **Options écartées** : commencer par l'interprétation des déplacements ; elle viendra ensuite.
|
||
|
||
## D-003 — 2026-10-09 — 100 % analytique, embarquable, données réelles
|
||
- **Statut** : active.
|
||
- **Décision** : pas de LLM ; pas de données synthétiques ; code d'analyse en bibliothèque standard Python.
|
||
- **Pourquoi** : la cible est le système embarqué de la station, souvent sur batterie et panneau solaire. Chaque conclusion doit être traçable jusqu'aux faits calculés.
|
||
- **Options écartées** :
|
||
- le LLM ou l'agent de synthèse prévu par les docs AIMsight ;
|
||
- les CSV simulés et les générateurs de scénarios (refus explicite de l'utilisateur) ;
|
||
- pandas et numpy dans le code d'analyse.
|
||
|
||
## D-004 — 2026-10-09 — Définition : anomalie énergétique = régime non soutenable
|
||
- **Statut** : active.
|
||
- **Décision** : une anomalie énergétique est un régime qui menace le fonctionnement : l'apport ne couvre pas la consommation sur un cycle.
|
||
- **Pourquoi** : une station débranchée du secteur avec une batterie pleine est déjà en situation critique. Le niveau de charge dit **quand** la station tombera, pas **si** elle tombera.
|
||
- **Options écartées** : définir l'anomalie par une batterie basse ou par une zone de charge (plateau, coude). Ce n'est qu'un indicateur d'urgence.
|
||
- **Conséquence** : l'apport n'est pas mesuré (l'INA219 mesure la consommation). Il se déduit de la réaction de la batterie.
|
||
|
||
## D-005 — 2026-10-09 — Analyses multiples et imparfaites, combinées
|
||
- **Statut** : active.
|
||
- **Décision** : chaque analyse est une preuve parmi d'autres. Il suffit qu'elle ait raison dans la majorité des cas. C'est la combinaison d'analyses indépendantes qui fait le diagnostic. Préférer des fenêtres larges (plusieurs jours, multiples de 24 h).
|
||
- **Pourquoi** : ne pas surinvestir dans la précision d'une seule règle.
|
||
- **Options écartées** :
|
||
- une seule analyse « parfaite » qui couvrirait tous les cas ;
|
||
- un score continu de 0 à 1, qui serait une pseudo-probabilité, interdite.
|
||
- **Conséquence** : toutes les analyses suivent le contrat commun `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`. Le calcul est causal. Une analyse seule conclut au plus `consistent with`.
|
||
|
||
## D-006 — 2026-10-09 — Un script et une fiche par analyse
|
||
- **Statut** : active.
|
||
- **Décision** : l'analyse NN a un point d'entrée `src/analyse_NN.py` et une fiche `docs/analyses/analyse_NN.md`.
|
||
- **Pourquoi** : suivre une à une les analyses à venir, qui seront nombreuses.
|
||
- **Options écartées** : un `main.py` unique à la racine (essayé, puis renommé et déplacé).
|
||
|
||
## D-007 — 2026-10-09 — Livrable : graphiques HTML ouverts dans le navigateur
|
||
- **Statut** : remplacée en partie par D-011 (disposition des graphiques). Le reste est actif.
|
||
- **Décision** : le livrable d'une analyse est un graphique plotly, ouvert automatiquement dans le navigateur. Disposition initiale : en haut, tous les champs superposés, comme sur la plateforme de monitoring de l'entreprise ; dessous, l'analyse.
|
||
- **Pourquoi** : c'est le graphique qui sert, pas le texte.
|
||
- **Options écartées** : le résumé texte dans le terminal comme livrable principal, jugé peu utile. Il reste disponible via `energy_check.py`.
|
||
- **Conséquence** : plotly n'est installé que dans `.venv/`, sur le poste de dev. Le script y bascule seul.
|
||
|
||
## D-008 — 2026-10-09 — Prototype expérimental : pas de tests automatisés
|
||
- **Statut** : active, jusqu'à la fin de la phase prototype.
|
||
- **Décision** : les tests unitaires et de régression sont supprimés. On n'en ajoute pas.
|
||
- **Pourquoi** : ils ajoutent de la complexité pour un code très expérimental.
|
||
- **Options écartées** : des tests de régression sur données réelles (32 tests, supprimés).
|
||
- **Conséquence** : on vérifie à la main en lançant le script de l'analyse. Les tests restent récupérables dans l'historique git (commit `53b4f7e`).
|
||
|
||
## D-009 — 2026-10-09 — Jeu de travail : VERMONT seule
|
||
- **Statut** : active.
|
||
- **Décision** : les analyses ne tournent que sur VERMONT, le seul dataset complet (les 7 métriques système, comme sur la plateforme), placé dans `data/`. Les autres stations (`BusVoltage` seule) sont mises de côté dans `data/archive/`.
|
||
- **Pourquoi** : disposer de tous les champs vaut mieux qu'avoir plus de stations incomplètes.
|
||
- **Options écartées** : supprimer les autres stations (irréversible, car non versionnées) ; continuer à analyser les 5 stations.
|
||
- **Conséquence** : il n'y a plus de station saine pour vérifier qu'une analyse ne donne pas de fausse alerte. Les seuils calés avant cette décision gardent leur source historique.
|
||
|
||
## D-010 — 2026-10-09 — Organisation de la documentation
|
||
- **Statut** : active, complétée par D-012.
|
||
- **Décision** : trois niveaux.
|
||
- `CLAUDE.md` est chargé à chaque session et reste court.
|
||
- `docs/decisions.md` (ce journal) porte les décisions de niveau projet.
|
||
- `docs/analyses/analyse_NN.md` porte la fiche vivante de chaque analyse.
|
||
- **Pourquoi** : rien ne doit se perdre entre deux conversations, sans alourdir le contexte chargé en permanence.
|
||
- **Options écartées** :
|
||
- mettre à jour après coup les specs et plans superpowers ;
|
||
- garder le savoir projet dans la mémoire automatique de Claude, qui est locale et non partagée.
|
||
- **Conséquence** : `docs/superpowers/` est un historique de travail, pas une référence. La spec d'une nouvelle analyse s'écrit directement dans sa fiche.
|
||
|
||
## D-011 — 2026-10-09 — Disposition des graphiques : l'analyse en haut, une série par graphique dessous
|
||
- **Statut** : active. Remplace la disposition de D-007.
|
||
- **Décision** : en haut, l'analyse avec ses courbes superposées ; dessous, un graphique séparé par série temporelle, chacun avec sa propre échelle.
|
||
- **Pourquoi** : superposer tous les champs sur un seul axe écrase l'échelle, parce que les amplitudes vont de ~13 V à ~5000 mW.
|
||
- **Options écartées** : tous les champs sur un même axe, à la manière de la plateforme de monitoring (D-007), essayée puis abandonnée.
|
||
|
||
## D-012 — 2026-10-09 — Documentation : une carte et des documents chargés à la demande
|
||
- **Statut** : active. Complète D-010.
|
||
- **Décision** :
|
||
- `CLAUDE.md` devient une **carte** de moins de 200 lignes : état et prochaine étape, index des analyses, liens, règles non négociables, essentiel du domaine.
|
||
- Le savoir métier va dans `docs/domaine/`, une note par question.
|
||
- Une règle `.claude/rules/analyses.md` se charge seule quand Claude touche `src/` ou `docs/analyses/`.
|
||
- Ce journal prend le format ADR allégé (statut, options écartées).
|
||
- Un modèle de fiche `docs/analyses/_modele.md` et un skill `nouvelle-analyse` donnent la même forme à chaque analyse.
|
||
- **Pourquoi** :
|
||
- la doc officielle de Claude Code recommande moins de 200 lignes par CLAUDE.md, car un fichier plus long coûte du contexte à chaque session et est moins bien suivi ;
|
||
- les règles limitées à certains chemins et les skills ne se chargent qu'à la demande (divulgation progressive) ;
|
||
- les options écartées évitent de reproposer ce qui a déjà été rejeté.
|
||
- **Options écartées** : un CLAUDE.md exhaustif à la manière de DocLab (1194 lignes, ~93 Ko). Il donne une très bonne vue d'ensemble, mais chaque session paie ce contexte et l'adhérence baisse.
|
||
|
||
## D-013 — 2026-10-09 — Graphiques : zoom dans le temps, ordonnée recalée sur la plage visible
|
||
- **Statut** : active.
|
||
- **Décision** : dans tous les graphiques d'analyse :
|
||
- le zoom est horizontal seulement (dans le temps, au rectangle ou à la molette) et commun à tous les graphiques ;
|
||
- après chaque zoom, l'ordonnée de chaque graphique est recalée sur les points visibles. Le script est `energy_plot.AUTOSCALE_Y_JS`, avec les ordonnées en `fixedrange` ;
|
||
- la ligne de seuil reste visible ;
|
||
- un double-clic revient à la vue complète.
|
||
- **Pourquoi** : les graphiques sont peu hauts. Avec l'échelle de l'ensemble des données, les points sortaient du cadre dès qu'on zoomait, et plotly ne recale pas l'ordonnée tout seul.
|
||
- **Options écartées** : le zoom libre en rectangle sur les deux axes, parce que l'ordonnée fixée à la main serait écrasée par le recalage automatique.
|
||
- **Conséquence** : le script utilise l'API interne de plotly.js (`_fullLayout`, `d2l`, `r2l`). Il est à revérifier si plotly change de version majeure.
|
||
|
||
## D-014 — 2026-10-09 — Tout le projet est versionné et poussé sur le dépôt de l'entreprise
|
||
- **Statut** : active.
|
||
- **Décision** : `doc/` (documentation AIMsight), `data/` (dont `data/archive/`), `architecture.drawio` et la copie du collecteur `src/__main__ (3).py` sont versionnés et poussés sur `origin` (gitea de l'entreprise). Seuls `out/`, `.venv/` et `__pycache__/` restent ignorés.
|
||
- **Pourquoi** : demande explicite de l'utilisateur. Le projet doit être complet et récupérable depuis le dépôt.
|
||
- **Conséquence** :
|
||
- `data/metadata.md` contient des identifiants techniques de station (SIM CCID, adresses IP), d'où un dépôt qui doit rester privé ;
|
||
- les stations archivées deviennent récupérables, ce qui lève la raison « irréversible » évoquée dans D-009.
|
||
|
||
## D-015 — 2026-10-12 — Panneau d'analyse : deux courbes sur un seul axe en volts
|
||
- **Statut** : active. Précise D-011 pour le panneau du haut.
|
||
- **Décision** : le panneau d'analyse ne montre que la moyenne sur 7 jours et le seuil (référence − 0,2 V), en volts, sur un seul axe, avec le fond rouge des anomalies. L'écart et la référence restent au survol.
|
||
- **Pourquoi** : les 5 tracés précédents (écart, ligne à −0,2 V, moyenne, référence, seuil, sur deux axes) montraient deux fois le même test. L'utilisateur a demandé à simplifier.
|
||
- **Options écartées** :
|
||
- l'écart seul face à −0,2 V : le plus compact, mais on ne voit plus le niveau de tension ;
|
||
- moyenne, référence et seuil (3 courbes) : la référence n'est que le seuil décalé de 0,2 V.
|
||
- **Conséquence** : le seuil est une courbe, donc `AUTOSCALE_Y_JS` le garde visible sans cas particulier.
|
||
|
||
## D-016 — 2026-10-12 — Page commune : un panneau par analyse, pour les comparer
|
||
- **Statut** : active. Précise D-011 et D-006.
|
||
- **Décision** : les analyses énergétiques partagent une page, `out/<STATION>_energy.html`. Chacune y a son panneau en haut, dans l'ordre de leur numéro (02 sous 01), puis viennent les graphiques des séries temporelles. Chaque analyse garde son point d'entrée `src/analyse_NN.py` (D-006), qui lance cette page.
|
||
- **Pourquoi** : demande de l'utilisateur, pour comparer `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` à `MOVING_AVERAGE_7_DAYS_DROP` sur le même axe de temps. C'est aussi un premier pas vers la combinaison des analyses (D-005).
|
||
- **Options écartées** : une page par analyse, qui obligerait à comparer deux onglets sans zoom commun.
|
||
- **Conséquence** : `energy_plot.figure()` prend une liste de résultats. Le calcul commun des deux analyses est `energy_check._ma_drop()`.
|
||
|
||
## D-017 — 2026-10-12 — Identifiants de règle en mots complets
|
||
- **Statut** : active.
|
||
- **Décision** : l'identifiant d'une règle (champ `analysis`, titre du panneau, conclusions) s'écrit en anglais, en majuscules, avec des mots complets et sans abréviation. Les deux premières analyses sont renommées : `MA7D_DROP` devient `MOVING_AVERAGE_7_DAYS_DROP`, et `MA7D_MIDNIGHT_DROP` devient `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`.
|
||
- **Pourquoi** : demande de l'utilisateur : avec des abréviations, on ne comprend pas ce que fait la règle. L'identifiant est cité dans chaque conclusion, il doit se lire sans la fiche.
|
||
- **Options écartées** : les sigles courts (`MA7D_DROP`), illisibles pour qui ne connaît pas le projet.
|
||
- **Conséquence** : les documents de travail de `docs/superpowers/` gardent les anciens noms (historique non maintenu).
|