Add the client Energy mockup and switch site texts to English

D-022: page mockups are HTML built from real data, in maquettes/user/
(client) and maquettes/support/; Figma only on request.
maquettes/user/energy.py renders the System Summary page with a
Diagnostic section: an Energy box with the day's color, a one-line
headline, a battery scale (zones from the collector's LiFePO4 OCV
table, no percentage shown), the trend against the day before, an
"Activate energy save mode" button on orange and red days (mockup
only, sends nothing), and two collapsibles: the full history (D-021
figure) and the guide (part 1 of the manual, rendered from Markdown).

D-023: everything meant for the monitoring site is in English,
including the titles, legends, axes and hovers of the 03/04 panels.

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:37 +02:00
1 parent fc74fec10f
commit 8452973912
9 files changed
+366 -19

No files matched your search

+21
View File
@@ -206,3 +206,24 @@ Règles du journal :
- le calcul des analyses 03 et 04 (`battery_state.py`, `battery_trend.py`) n'importe plus rien des analyses 01 et 02 : il se livre seul ;
- le format d'intégration côté site (JSON, fragment HTML ou backend Python) reste à choisir avec l'équipe du site.
## D-022 — 2026-10-12 — Maquettes de page en HTML ; Figma seulement sur demande
- **Statut** : active.
- **Décision** : les maquettes de page (ex. « System Summary » du site de monitoring) sont des pages HTML générées à partir des données réelles, dans `maquettes/`. Un fichier Figma n'est produit que sur demande (designer, passation à l'équipe du site), à partir d'une maquette stable.
- **Pourquoi** : choix de l'utilisateur, sur recommandation. Le HTML s'itère plus vite (rendu et vérification en local), garde les données réelles et vivantes (calcul par `src/`), permet l'interaction (survol traçable, zoom), utilise la technologie du livrable (HTML Plotly) et se versionne.
- **Options écartées** : Figma comme référence. Chaque modification y passe par l'API Plugin, et le graphique n'y est qu'une image vectorielle figée, sans survol ni zoom. Un premier fichier, produit puis non maintenu, reste dans les brouillons Figma de l'utilisateur : https://www.figma.com/design/S16eZ7PoAAutFJWcyqAHSm.
- **Conséquence** :
- les maquettes sont rangées en deux blocs : `maquettes/user/` (côté client) et `maquettes/support/` (côté support AIMsight). Chaque design a son script, ou directement son HTML s'il n'a pas besoin de données ;
- `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 ;
- 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
- **Statut** : active. Complète D-021 et D-022.
- **Décision** : tout ce qui est destiné au site de monitoring est en anglais : la maquette System Summary et la figure des analyses 03 et 04 (`out/<STATION>_daily.json`), avec ses titres, légendes, axes et survols.
- **Pourquoi** : demande de l'utilisateur. Le site AIMsight est en anglais.
- **Conséquence** :
- 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.