Add a dev container on the host network

Docker Engine in WSL (mirrored networking), Python 3.14 and plotly,
--network=host to reach the camera over Ethernet (D-038).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 15:42:33 +02:00
1 parent 5a886b4e7e
commit 28d441889f
3 files changed
+20 -1

No files matched your search

+6
View File
@@ -0,0 +1,6 @@
{
"name": "Support-Agent",
"image": "mcr.microsoft.com/devcontainers/python:3.14",
"runArgs": ["--network=host"],
"postCreateCommand": "pip install --user plotly"
}
+4 -1
View File
@@ -17,6 +17,7 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m
- **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`.
- **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).
## Analyses (domaine Energy)
@@ -87,7 +88,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` (396 l, D-001 à D-037) : 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` (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/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.
@@ -119,6 +120,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
- `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).
- `.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.
- `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014).
@@ -169,3 +171,4 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
- `pandas` n'est pas installé ; la bibliothèque standard suffit pour explorer les CSV (`csv`, `datetime.fromisoformat`).
- `.venv/` (Python 3.14) ne contient que plotly, pour le poste de dev. Le code d'analyse reste en bibliothèque standard.
- Dev container (D-038) : Docker Engine dans WSL (réseau `mirrored`), VS Code « Reopen in Container » ; dans le conteneur, les pages restent dans `out/` sans s'ouvrir seules.
+10
View File
@@ -394,3 +394,13 @@ Règles du journal :
- **Pourquoi** : choix de l'utilisateur, sur proposition. Le Red reprend `MIN_COVERAGE`, déjà sourcé, sans nouveau seuil : sur NORDEND, il retient 9 des 11 jours de coupure lourde (23 à 95 envois manquants), et aucun des petits manques (1 à 5 envois).
- **Options écartées** : `UP` × `CELL_EDGE` en Orange (NORDEND déclencherait une notification 76 jours sur 109 alors que tous ses envois sont arrivés ; la grille ne sépare pas ses bons jours des mauvais, fiche `daily_signal_state`) ; `DOWN` en Red dès un échantillon (le `down` fugitif du 03/09 sur WEISSHORN, les 96 envois arrivés) ; un nombre d'envois manquants comme seuil du Red (pas de source, pas de cas de l'expert).
- **Conséquence** : WEISSHORN, 46 jours Green, 7 Orange, 1 Red (20/08, fin de la mise en service), 12 gris ; NORDEND, 76 Green, 20 Orange, 9 Red, 5 gris. Tant que le signal est connu, sa classe ne change pas la couleur. Restent hors de la matrice : le croisement avec Energy, les deux corrections de `DAILY_LINK_STATE` (le 15/07 de NORDEND repasserait Green) et les seuils du signal, en attente du spécialiste.
## D-038 — 2026-10-13 — Dev container : Docker Engine dans WSL, réseau de l'hôte
- **Statut** : active. Prépare la communication avec la caméra (API REST, interface web, RTSP, FTP, MQTT ; manuel de la station, « Access Modes » et « Network Settings »).
- **Décision** :
- `.devcontainer/devcontainer.json` : image `mcr.microsoft.com/devcontainers/python:3.14` (la version de `.venv`), plotly installé à la création, `--network=host` ;
- Docker Engine installé dans WSL (script de commodité, dépôt `apt` de Docker), pas Docker Desktop ;
- le réseau de WSL reste en mode `mirrored` (`.wslconfig`) : WSL, donc le conteneur, voit les interfaces de Windows, dont le lien Ethernet direct vers la caméra (`192.168.1.2` par défaut).
- **Pourquoi** : choix de l'utilisateur, sur proposition. Le réseau de l'hôte évite de publier un port pour ce que la caméra envoie au poste (FTP, MQTT) ; Docker Engine est le chemin le plus direct vers ce réseau, sans licence.
- **Options écartées** : Docker Desktop for Windows (conteneurs dans sa propre distribution WSL, réseau de l'hôte à activer à part, licence payante au-delà d'une certaine taille d'entreprise) ; Docker Desktop for Linux (fait pour un Linux natif, pas pour WSL) ; le réseau `bridge` (suffit pour joindre la caméra, pas pour en recevoir).
- **Conséquence** : vérifié le 2026-10-13 (Docker 29.9.0, Python 3.14.8) : `all_analyses.py` et `final.py` tournent sur VERMONT dans le conteneur ; dans le conteneur, les pages ne s'ouvrent pas seules (pas de navigateur), elles restent dans `out/`. À reprendre quand on connaîtra la version de Python et l'architecture de la station (imiter la station), et la doc de l'API REST (dans l'interface web de la caméra). Le jeton d'API reste hors du dépôt ; les échanges avec la caméra restent en lecture seule.