Deliver Storage and Cellular in the mockups, with site figures and guides
The mockups now walk a list of domains (D-039): the support Home loads every station in data/ and notifies each station x domain that is Orange or Red; the client view becomes maquettes/user/summary.py, one System Summary page per station with one block per measured domain. Storage shows a free-space scale and the estimated full date; Cellular shows the day's sends in words and a four-class signal scale. HEADLINE moves into each day_color.py, with a Green sentence for the client view. src/storage/final.py and src/cellular/final.py write the site figures in English; the comparison pages reuse their panels. Each domain gets a short two-layer guide in docs/<domaine>/guide/. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
28d441889f
commit
f0990c16e6
22 files changed
+682
-246
No files matched your search
@@ -12,13 +12,13 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m
|
||||
|
||||
- **Energy, livré (prototype, D-020)** : `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND`, combinées par la matrice état × tendance en une couleur par jour (vert / orange / rouge, gris si inconnu). Une figure Plotly pour le site (D-021 ; la matrice est codée mais pas tracée), un focus sur un jour et sa veille (D-024), un manuel en brouillon.
|
||||
- **Energy, comparaison seulement** : les deux moyennes glissantes sur 7 jours. Point ouvert : l'accoutumance après ~30 jours de déficit (fiche `moving_average_7_days_drop`).
|
||||
- **Maquettes du site (D-022)** : client « Energy » (section Diagnostic de la page System Summary) ; support « Home » (section Status, une notification par station Orange ou Red, lien vers la vue client, D-025).
|
||||
- **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025).
|
||||
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
|
||||
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; ni figure du site, ni maquette, ni guide (étape 7 de `nouveau-domaine`).
|
||||
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; ni figure du site, ni maquette, ni guide (étape 7 de `nouveau-domaine`). Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`.
|
||||
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||
- **Températures (D-036)** : explorées sur les trois stations, pas de domaine pour l'instant (ni épisode de chaleur, ni seuil sourcé, ni cas de l'expert) ; constats, pistes et questions dans `docs/domaine/temperatures-de-la-station.md`.
|
||||
- **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST.
|
||||
- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, puis la livraison (étape 7) ; `storage` : la livraison (étape 7 de `nouveau-domaine`, dans une autre conversation : figure du site `src/storage/final.py`, passage des maquettes à une liste de domaines, maquettes à proposer puis attendre les consignes, guide `docs/storage/guide/`) ; températures : rien à faire avant les réponses du spécialiste (questions de `docs/domaine/temperatures-de-la-station.md`) ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre « Energy » côté client pas à pas, puis le côté support pas à pas (points ouverts dans D-022).
|
||||
- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; températures : rien à faire avant les réponses du spécialiste (questions de `docs/domaine/temperatures-de-la-station.md`) ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039).
|
||||
|
||||
## Analyses (domaine Energy)
|
||||
|
||||
@@ -46,6 +46,7 @@ Code dans `src/cellular/`, fiche dans `docs/cellular/analyses/<règle en minuscu
|
||||
| `DAILY_SIGNAL_STATE` | Chaque jour : médianes du RSRP et du RSRQ sur la grille publiée (excellent, bon, moyen, limite de cellule) | prototype (D-031) | `signal_state.py` |
|
||||
|
||||
- **Couleur du jour** : `src/cellular/day_color.py` (`MATRIX[lien][signal]`, `HEADLINE`), transcription de `docs/cellular/matrice-lien-signal.drawio` (D-037).
|
||||
- **Livré (D-039)** : figure du site `src/cellular/final.py` (panneaux partagés avec la page de comparaison), guide `docs/cellular/guide/diagnostic-cellulaire.md`.
|
||||
|
||||
## Analyses (domaine Storage)
|
||||
|
||||
@@ -57,6 +58,7 @@ Code dans `src/storage/`, fiche dans `docs/storage/analyses/<règle en minuscule
|
||||
| `DAYS_UNTIL_STORAGE_FULL` | Chaque jour : dans combien de jours le disque sera-t-il plein, au rythme médian des 7 derniers jours ? | prototype (D-034) | `days_until_full.py` |
|
||||
|
||||
- **Couleur du jour** : `src/storage/day_color.py` (`MATRIX[état][horizon]`, `HEADLINE`), transcription de `docs/storage/matrice-etat-horizon.drawio` (D-035).
|
||||
- **Livré (D-039)** : figure du site `src/storage/final.py` (panneaux partagés avec la page de comparaison), guide `docs/storage/guide/diagnostic-stockage.md`.
|
||||
|
||||
## Commandes
|
||||
|
||||
@@ -64,17 +66,19 @@ Code dans `src/storage/`, fiche dans `docs/storage/analyses/<règle en minuscule
|
||||
python3 src/energy/final.py [données] # livré : out/<STATION>_daily.html + .json (figure du site, D-021)
|
||||
python3 src/energy/all_analyses.py [données] # les 4 analyses comparées (D-016) : out/<STATION>_energy.html
|
||||
python3 src/energy/focus_jour.py JJ.MM[.AAAA] [données] # un jour et sa veille (D-024) : faits + out/<STATION>_focus_<AAAA-MM-JJ>.html + .json
|
||||
python3 src/cellular/all_analyses.py [données] # analyses 4G comparées : out/<STATION>_cellular.html (défaut data/WEISSHORN/ et data/NORDEND/)
|
||||
python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/<STATION>_storage.html (défaut data/WEISSHORN/)
|
||||
python3 maquettes/user/energy.py [début] [fin] # maquette client : out/maquette_user_energy.html
|
||||
python3 src/cellular/final.py [données] # livré : out/<STATION>_cellular_daily.html + .json (défaut data/WEISSHORN/ et data/NORDEND/)
|
||||
python3 src/cellular/all_analyses.py [données] # analyses 4G comparées : out/<STATION>_cellular.html (même défaut)
|
||||
python3 src/storage/final.py [données] # livré : out/<STATION>_storage_daily.html + .json (défaut data/WEISSHORN/)
|
||||
python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/<STATION>_storage.html (même défaut)
|
||||
python3 maquettes/user/summary.py [début] [fin] # maquette client : out/maquette_user_<STATION>.html, une page par station de data/
|
||||
python3 maquettes/support/home.py [début] [fin] # maquette support : out/maquette_support_home.html
|
||||
pdftotext -layout "docs/aimsight/<fichier>.pdf" - # lire un PDF AIMsight
|
||||
python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
||||
```
|
||||
|
||||
- `[données]` : CSV ou dossiers, défaut `data/VERMONT/`. Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; la maquette support mène à la maquette client : les lancer avec les mêmes dates.
|
||||
- `[données]` : CSV ou dossiers, défaut `data/VERMONT/`. Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; la maquette support mène aux maquettes client : les lancer avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular).
|
||||
- Chaque script bascule seul sur `.venv` si plotly manque, puis ouvre sa page (navigateur Windows via `explorer.exe` sous WSL).
|
||||
- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur VERMONT.
|
||||
- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur le jeu de travail du domaine.
|
||||
|
||||
## Carte du dépôt
|
||||
|
||||
@@ -88,7 +92,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
||||
### Fichiers
|
||||
|
||||
- `README.md` (40 l) : point d'entrée pour un humain.
|
||||
- `docs/decisions.md` (406 l, D-001 à D-038) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/decisions.md` (424 l, D-001 à D-039) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
|
||||
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
|
||||
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
||||
@@ -99,7 +103,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
||||
- `domaine/` (< 80 l) : `comment-se-comporte-la-batterie.md` (LiFePO4, plateau et coude, table OCV, redémarrage à 12,6 V, capacité) ; `tensions-selon-l-etat-de-la-batterie.md` (tensions et pentes en charge, pleine charge et décharge) ; `cas-annotes-par-l-expert.md` (diagnostics experts des 5 stations, vérité de référence).
|
||||
- `guide/diagnostic-energetique.md` (180 l, brouillon) : manuel, partie 1 pour le client (§1-4), partie 2 pour le support (§5-9). À tenir à jour avec la matrice et les fiches des deux analyses livrées.
|
||||
- `matrice-etat-tendance.drawio` : matrice état × tendance, tenue par l'utilisateur.
|
||||
- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Storage a sa matrice état × horizon, `matrice-etat-horizon.drawio`, Cellular sa matrice lien × signal, `matrice-lien-signal.drawio`, tenues par l'utilisateur. Chacun a une note de départ, `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes), ses fiches dans `analyses/` et ses questions ouvertes dans `domaine/questions-pour-l-expert.md`.
|
||||
- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Storage a sa matrice état × horizon, `matrice-etat-horizon.drawio`, Cellular sa matrice lien × signal, `matrice-lien-signal.drawio`, tenues par l'utilisateur. Chacun a une note de départ, `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes), ses fiches dans `analyses/`, ses questions ouvertes dans `domaine/questions-pour-l-expert.md` et son guide (~90 l, client puis support) dans `guide/`, dont la partie 1 est affichée dans la vue client.
|
||||
- `docs/agents/rapport-exploratoire.md` (290 l) : cadre d'agents LLM (D-027) : choix retenus, architecture, démarrage par étapes (§6) ; annexe A : pistes à revoir étape par étape. Le code d'agent vivra à part (`agents/`, proposé, pas créé).
|
||||
- `docs/aimsight/` : documentation AIMsight d'origine, en anglais, non modifiée. À lire avant de concevoir, **par section** ; ne pas re-demander à l'utilisateur ce qui y figure.
|
||||
- `AIMsight_reference_quality_event_explainer_roadmap.md` (1 180 l) : **référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10).
|
||||
@@ -116,9 +120,9 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
||||
- `src/` : un sous-dossier par domaine, plus le code commun (D-026).
|
||||
- `common/` : `stations.py` (chargement des CSV, métriques texte en listes, trous de mesure ; bibliothèque standard) et `page.py` (poste de dev : bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`).
|
||||
- `energy/` : calcul embarquable, en bibliothèque standard et sans import de `common/` : `battery_state.py`, `battery_trend.py`, `moving_average.py`, `day_color.py`. Scripts plotly du poste de dev, à laisser hors de la station : `final.py`, `all_analyses.py`, `focus_jour.py`.
|
||||
- `cellular/` : calcul embarquable `link_state.py`, `signal_state.py`, `day_color.py` (D-037) ; page plotly `all_analyses.py` (D-031).
|
||||
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; page plotly `all_analyses.py` (D-034).
|
||||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/energy.py` + `energy_template.html` (client), `support/home.py` + `home_template.html` (support).
|
||||
- `cellular/` : calcul embarquable `link_state.py`, `signal_state.py`, `day_color.py` (D-037) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-031).
|
||||
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034).
|
||||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039).
|
||||
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `settings.json` (lecture de `.env` interdite).
|
||||
- `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra.
|
||||
- `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande.
|
||||
|
||||
Reference in new issue
Block a user