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:
1 parent
8452973912
commit
1a2220d317
8 files changed
+177
-4
No files matched your search
+11
-1
@@ -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.
|
||||
Reference in new issue
Block a user