Add the day focus: a day and the day before only

D-024: to explain a day's color, show only that day and the day before,
the only days analyses 03 and 04 read for it. day_color.focus() selects
the data (standard library); src/focus_jour.py prints a traceable fact
summary and writes a 48 h BusVoltage figure (out/<STATION>_focus_<date>
.html and .json). Analysis 03 gains the night_end_h fact; the other
facts are unchanged. The client Energy mockup does not use this figure:
the user prefers numeric facts there.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-12 16:23:45 +02:00
1 parent 8452973912
commit 1a2220d317
8 files changed
+177 -4

No files matched your search

+2 -1
View File
@@ -44,7 +44,7 @@ Sortie (contrat commun) : un point par jour.
- `t` = dernière heure du jour présente dans la série.
- `value` = `max_v`, en V (`None` sans mesure).
- `anomaly` = `None` pour tous les jours. **En phase C, `None` veut dire « pas de verdict »**, et non UNKNOWN comme dans le contrat ; l'UNKNOWN de l'état est porté par `state = None`. La phase B remplira `anomaly`.
- `facts` = `{state, max_v, min_v, night_end_v, rise_v, hours_full, coverage}`.
- `facts` = `{state, max_v, min_v, night_end_v, night_end_h, rise_v, hours_full, coverage}`. `night_end_h` est l'heure UTC (0 à 23) de la fin de nuit.
**Causalité** : le jour d n'utilise que les heures de d. Pour le dernier jour d'un export, s'il est incomplet, l'état est provisoire : une heure ≥ 14,0 V ou un passage sous le coude peut encore survenir.
@@ -116,3 +116,4 @@ Sortie (contrat commun) : un point par jour.
- **2026-10-12** : corrigée après la relecture finale. La fin de nuit et la montée étaient calées sur le premier maximum du jour, qui peut être la tension de 00:00 (queue de la soirée précédente). Conséquences : le 2026-05-05 était lu `NO_CHARGE` malgré une montée de +0,079 V, la fin de nuit affichée du 2026-09-30 était fausse (12,68 V au lieu de 12,19 V), et le 2026-09-26, évalué en cours de journée, restait UNKNOWN de 04:00 à 11:00 malgré des mesures sous 12,8 V. Désormais, la montée part d'un minimum antérieur, et le coude se teste sur le minimum du jour (`min_v`).
- **2026-10-12** : sur le graphique, chaque point est placé à midi UTC de son jour, et non plus à 23:00, comme les barres de l'analyse 04 (D-019). Le calcul ne change pas.
- **2026-10-12** : titres, légendes et survols du graphique en anglais, pour le site de monitoring (D-023). Le calcul ne change pas.
- **2026-10-12** : nouveau fait `night_end_h` (heure de la fin de nuit), pour placer la fin de nuit sur le graphique focus J−1 / J (D-024). Les autres faits ne changent pas (vérifié sur les 184 jours de VERMONT).
+11 -1
View File
@@ -216,7 +216,7 @@ Règles du journal :
- `python3 maquettes/user/energy.py [début] [fin]` écrit `out/maquette_user_energy.html` (ignoré par git, comme les autres pages générées) et l'ouvre. Il calcule lui-même la figure de D-021 (plotly, bascule seule sur `.venv`) ;
- la maquette « Energy » place en haut de la page System Summary une section « Diagnostic », un rectangle repliable par notification (ici Energy, avec Green, Orange ou Red pour le dernier jour de la fenêtre). Déplié : une phrase de très haut niveau, puis une échelle de batterie (niveau de ce matin, la fin de nuit, placé par la table OCV du collecteur dans des zones Off < 10 %, Low < 30 %, OK < 90 %, Full ; pas de % affiché, car sur le plateau la tension en dit peu ; la tension reste au survol), la tendance face à la veille en mots simples (better / same / worse), et deux dérouleurs : l'historique complet (figure de D-021) et « Guide », la partie 1 du manuel (lecture rapide, pour le client) rendue depuis le Markdown à chaque génération (marked.js). La partie 2, pour le support, ira côté support ;
- les jours Orange et Red, un bouton « Activate energy save mode » propose le remède attendu (veille profonde entre les mesures, `docs/domaine/comment-se-comporte-la-batterie.md`). C'est une action de la plateforme, déclenchée par le client : le diagnostic reste en lecture seule. Dans la maquette, le bouton n'envoie rien ;
- un tableau des faits de J−1 et de J, côte à côte, puis le jour J avec ses variations chiffrées, ont été essayés, puis remplacés par l'échelle et la tendance : une tension ne dit rien à un non-spécialiste, et il n'a pas besoin de savoir que la tendance vient de la fin de nuit ;
- le bloc n'utilise pas le graphique de 48 h de D-024 (`focus_jour.py`) : l'utilisateur préfère des faits chiffrés. Un tableau des faits de J−1 et de J, côte à côte, puis le jour J avec ses variations chiffrées, ont été essayés, puis remplacés par l'échelle et la tendance : une tension ne dit rien à un non-spécialiste, et il n'a pas besoin de savoir que la tendance vient de la fin de nuit ;
- une première version, avec une bande d'une case par jour au-dessus de `BusVoltage` (option écartée par D-021), a été remplacée.
## D-023 — 2026-10-12 — Site de monitoring en anglais, figure des analyses 03 et 04 comprise
@@ -227,3 +227,13 @@ Règles du journal :
- les panneaux 03 et 04 étant partagés (D-021), ils sont aussi en anglais sur la page des analyses (`out/<STATION>_energy.html`), dont le reste (analyses 01 et 02, séries) reste en français ;
- le code, ses commentaires, les fiches et le manuel restent en français (convention du projet). Les identifiants (`FULL_CHARGE`, `DAILY_BATTERY_STATE`…) ne changent pas.
## D-024 — 2026-10-12 — Focus sur un jour : J et la veille seulement
- **Statut** : active. Complète D-020 et D-021.
- **Décision** :
- pour comprendre la couleur d'un jour (ex. « Red » le 27/09), on ne montre que le jour J et la veille J−1 : ce sont les seuls jours que lisent les analyses 03 et 04 pour cette couleur ;
- `python3 src/focus_jour.py JJ.MM[.AAAA]` affiche un résumé texte traçable (couleur, case de la matrice, état et condition de chaque jour, maximum, fin de nuit et son heure, heures mesurées, tendance et ce qui l'a décidée). Il écrit aussi un graphique de 48 h (`out/<STATION>_focus_<AAAA-MM-JJ>.html` + `.json`) : `BusVoltage` horaire, bandes grises sans mesure, seuils 14,0 et 12,8 V, maximum et fin de nuit de chaque jour, flèche de fin de nuit J−1 → J colorée par tendance ;
- la sélection des données (`day_color.focus(series, jour)`) est en bibliothèque standard, livrable à la plateforme ; le graphique est en anglais (D-023).
- **Pourquoi** : demande de l'utilisateur. Le client qui voit une couleur veut voir les données qui l'expliquent, sans tout l'historique.
- **Conséquence** :
- l'analyse 03 gagne le fait `night_end_h` (heure de la fin de nuit), sans changer les autres ;
- un jour en cours, ou le dernier jour d'un export, est signalé « provisional » : la couleur peut encore changer jusqu'à minuit UTC.
+1
View File
@@ -151,6 +151,7 @@ Commande : `python3 src/analyse_03.py`. Elle écrit deux pages dans `out/` et le
- `<STATION>_daily.html` : le graphique destiné au site de monitoring (D-021), soit les panneaux `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND` décrits ci-dessous, sur le même axe du temps. Sa figure Plotly est aussi écrite en JSON (`<STATION>_daily.json`), pour `Plotly.newPlot`.
- `<STATION>_energy.html` : la page de toutes les analyses, avec ces deux panneaux, et une courbe par mesure dessous.
- `<STATION>_focus_<AAAA-MM-JJ>.html` : le focus sur un jour et sa veille (D-024), pour comprendre une couleur. Commande : `python3 src/focus_jour.py 27.09`. Le terminal affiche les faits qui ont produit la couleur ; le graphique montre les 48 h de `BusVoltage`, avec les heures sans mesure en gris, les seuils de 14,0 et 12,8 V, le maximum et la fin de nuit de chaque jour, et une flèche de la fin de nuit de la veille à celle du jour (bleue ↗, grise →, rouge ↘).
**Attention aux couleurs** : celles des panneaux ne sont pas celles de la matrice. Elles distinguent les états et les tendances ; elles ne disent pas le niveau de préoccupation. Par exemple, `BELOW_PLATEAU` y est en bleu.