diff --git a/CLAUDE.md b/CLAUDE.md index 709fb0e..700312f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -20,7 +20,7 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m - **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`. - **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`. - **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, matplotlib, 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** : **déplacements (D-052)** : l'utilisateur (l'expert) apporte un nouveau cas réel avec les pages de la plateforme qu'il a consultées ; on en tire, pas à pas, des vues lisibles pour le client et l'expert, puis l'agent dans une maquette ; `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 ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; 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) ; agent de diagnostic : l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande. +- **Prochaine étape** : **déplacements (D-052)** : l'utilisateur (l'expert) apporte dans `vues-deplacements/` un nouveau cas réel avec les pages de la plateforme qu'il a consultées ; on en tire, pas à pas, des vues lisibles pour le client et l'expert, puis l'agent dans une maquette ; `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 ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; 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) ; agent de diagnostic : l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande. ## Analyses (domaine Energy) @@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . ### Fichiers - `README.md` (40 l) : point d'entrée pour un humain. -- `docs/decisions.md` (584 l, D-001 à D-052) : 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` (585 l, D-001 à D-052) : 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. @@ -145,8 +145,8 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . - `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040). - `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 »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `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. +- `vues-deplacements/` : chantier à part des vues des déplacements et de l'agent dans une maquette (D-052) : contexte, cas réels (données, pages de la plateforme, parcours de l'utilisateur), puis le code ; sa carte : `vues-deplacements/CLAUDE.md`. +- `.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 modifier sans demande. - `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014). ## Règles de travail diff --git a/docs/decisions.md b/docs/decisions.md index e0991cc..db88841 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -578,7 +578,8 @@ Règles du journal : - **Décision** : - l'agent de diagnostic (D-046 à D-051) suffit pour commencer : instructions, outils et base de cas (C-001 à C-005) restent en l'état ; la base grandit à l'usage, sur demande de l'utilisateur (`/nouveau-cas`) ; - suite : rendre les données de déplacement lisibles par un humain, client comme expert, et intégrer l'agent dans une maquette ; le but est de montrer à l'utilisateur ce que l'agent utilise pour diagnostiquer ; - - méthode : partir d'un nouveau cas réel, que l'utilisateur apporte avec les pages de la plateforme qu'il a consultées, et avancer pas à pas ; aucune vue n'est conçue avant ce contexte. -- **Pourquoi** : demande de l'utilisateur, qui est l'expert. Dès qu'une anomalie apparaît, les pages actuelles de la plateforme ne servent ni le client ni l'expert : il faut passer de page en page, et le diagnostic est difficile. L'agent aide, mais l'humain n'a pas accès à ses preuves. La roadmap AIMsight (§4) prévoit les mêmes preuves déterministes pour les tableaux de bord et pour l'explication par un LLM. + - méthode : partir d'un nouveau cas réel, que l'utilisateur apporte avec les pages de la plateforme qu'il a consultées, et avancer pas à pas ; aucune vue n'est conçue avant ce contexte ; + - rangement : tout le chantier vit à part, dans `vues-deplacements/` (contexte, cas réels avec leurs données, pages de la plateforme et parcours de l'utilisateur, puis le code), avec sa propre carte, `vues-deplacements/CLAUDE.md` ; ses données n'entrent pas dans `data/` (D-029), comme celles de la base de cas (D-050). +- **Pourquoi** : demande de l'utilisateur, qui est l'expert, et qui veut aussi encapsuler ce gros développement à part. Dès qu'une anomalie apparaît, les pages actuelles de la plateforme ne servent ni le client ni l'expert : il faut passer de page en page, et le diagnostic est difficile. L'agent aide, mais l'humain n'a pas accès à ses preuves. La roadmap AIMsight (§4) prévoit les mêmes preuves déterministes pour les tableaux de bord et pour l'explication par un LLM. - **Options écartées** : approfondir d'abord l'agent (plus de cas, plus d'outils), écarté par l'utilisateur pour rester efficace ; concevoir tout de suite trois vues tirées des cas connus (capteurs × temps en écart à leur niveau habituel, image annotée par capteur, capteur et témoin avec brut, corrigé, erreur et vignettes), reporté : sans les pages actuelles ni un cas vécu, on risque de refaire l'existant ou de viser à côté. Ces trois vues restent des pistes. - **Conséquence** : les maquettes (D-022, D-039) gagneront un volet déplacements, pour le client comme pour l'expert ; le cadrage des déplacements (D-044) reste au second plan. diff --git a/vues-deplacements/CLAUDE.md b/vues-deplacements/CLAUDE.md new file mode 100644 index 0000000..7ed9269 --- /dev/null +++ b/vues-deplacements/CLAUDE.md @@ -0,0 +1,23 @@ +# Vues des déplacements + +Chantier à part (D-052) : rendre les données de déplacement lisibles par un humain, client comme expert, et intégrer l'agent de diagnostic dans une maquette. Le but est de montrer à l'utilisateur ce que l'agent utilise pour diagnostiquer. On part de cas réels, apportés par l'utilisateur (l'expert) avec les pages de la plateforme qu'il a consultées, et on avance pas à pas. + +## Rangement + +``` +vues-deplacements/ +├── CLAUDE.md cette carte +├── contexte/ ce qui ne tient pas à un cas : designs actuels de la plateforme, documents, notes +└── cas// un cas réel par dossier (nom libre) + ├── / données de la station, rangées comme dans data/ : displacement/ (export « advanced », horaire), images/ + ├── plateforme/ pages de la plateforme, dans l'ordre où l'utilisateur les a ouvertes (01_…, 02_…) + └── parcours.md ce que l'utilisateur cherchait sur chaque page, où il a bloqué, ce qu'il aurait voulu voir d'un coup, son verdict +``` + +Le code et les maquettes du chantier viendront ici aussi ; leur rangement se décide au premier besoin. + +## Règles + +- Les données restent seules dans `/` : les outils de l'agent lisent tout le dossier qu'on leur donne, et une capture PNG y passerait pour une image de la caméra. Le verdict de l'utilisateur, dans `parcours.md`, reste hors de la vue de l'agent. +- Agent sur un cas, seulement si l'utilisateur le demande : `@agent-diagnostic vues-deplacements/cas/// [question]`. +- Les règles du projet (`CLAUDE.md` à la racine) s'appliquent : heures en UTC, documents en français, texte du site en anglais (D-023), pas de données synthétiques, identifiants (`SIM_CCID`, `ip`) jamais recopiés, décisions dans `docs/decisions.md`.