Carte du projet, chargée à chaque session : ce qui existe et où, pas le détail (D-012, D-028). Elle reste sous 200 lignes ; le reste se lit à la demande, et seulement la partie utile (« Lire sans saturer le contexte »).
Diagnostic proactif pour **AIMsight**, un système de surveillance optique de déplacements : une caméra suit des cibles (prismes, réflecteurs) sur un ouvrage, et son propre mouvement est compensé grâce à des cibles de référence. Le projet analyse les séries temporelles des stations avec des **méthodes analytiques (pas de LLM)**, détecte les anomalies et explique chacune (preuves calculées, puis ce qui reste non établi) **avant** que le client ne pose la question. Des agents Claude Code s'y ajoutent pour lire les données, améliorer les détecteurs et répondre au support. Langage : **Python** ; cible idéale du calcul : le système embarqué de la station.
Cadrage du product owner : sous-projet G, santé des sites et notifications au client (`docs/aimsight/AIMsight_handoff_G_site_health.md`). Sa dernière section liste les écarts de ce dépôt, à arbitrer par l'utilisateur.
- **Domaines système, livrés en prototype** : Energy (D-020, D-043), Storage (D-034, D-035), Cellular (D-031, D-037), Temperature (D-040) ; chacun avec ses analyses, sa couleur du jour, sa figure du site, son bloc dans la vue client, sa notification support et son guide (D-039, D-041). Seul Energy repose sur des events de l'expert ; les autres ont des seuils provisoires et attendent le spécialiste.
- **Maquettes du site** (D-022, D-039) : client « System Summary », une page par station, un bloc par domaine ; support « Home », une notification par station et par domaine Orange ou Red, liée à la vue client (D-025).
- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/events-learner` (D-057), base d'events `events/` revue par `/review-event` (D-075). `/events-learner` sur les étiquettes (D-112) : l'`etiqueteur` étiquette le lot en amont (`labeling/auto/`), puis le `detectors-critic` juge les détecteurs face à ses étiquettes, par famille, le `detectors-upgrader` les adapte, le `detectors-control` garde la base d'events ; l'analyste, le `tool-builder` et l'`event-builder` (D-088 à D-092, D-097) sont hors de la séance ; la carte des événements apprend de chaque event validé (D-087). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
- **Support** (D-079, D-113) : `/support <mail>` répond à la question d'un client, et à elle seule (premier cas : LENZSPITZE, nuit du 26 au 27.10) ; `/support <STATION>` fait le rapport de situation de la station à partir de ses étiquettes (`labeling/auto/`), appuyé d'images ; `/presentation <STATION>` le met en diapositives PDF à la charte AIMsight, par la fabrique Typst `~/docfactory-presentation` (D-114). Rapports par mois.
- **Agent de diagnostic** (D-046, D-058, D-082) : gardé dans le doute, pour un cas que les détecteurs n'expliquent pas.
- **En attente** : agents LLM côté serveur (D-027) et enquête par API (D-042), documents seulement ; communication avec la caméra (dev container, D-038), en attente de la doc de l'API REST ; détection des sauts et tendances (D-055, onglet `Displacements`), très expérimentale.
- **Prochaine étape** :
- journal du matin : les points ouverts du plan vivant, sur les consignes de l'utilisateur ; un point validé n'est plus repris ;
- les étiquettes de l'expert (`labeling/`, D-098, D-100) : 24, revues avec l'utilisateur par `/review-labels` le 2026-11-02 (D-103), sauf celle de PS_DES_COUDRES, sans données ; rangées par phénomène dans `labeling/carte-des-etiquettes.md` (`/labels-map`, D-104), à revoir par l'utilisateur, puis lue par l'`etiqueteur`, qui étiquette seul un lot (`labeling/auto/`, D-105, D-106) ; puis le premier `/labels-learner` (D-099, point 69 du plan), sur la perte de référence, lancé par l'utilisateur ;
- la première séance de `/events-learner` sur les étiquettes de l'étiqueteur, lancée par l'utilisateur sur un lot étiqueté (point 72 du plan, D-112) ; le releveur et l'améliorateur, communs aux processus automatiques, dans une autre conversation ;
- les écarts du handoff, dont « consistent with » face aux phrases catégoriques du journal, quand l'utilisateur les arbitre ;
- Cellular, Storage, Temperature : les réponses du spécialiste (`docs/<domaine>/domaine/questions-pour-l-expert.md`, pour Temperature la question 1 de `point-de-depart.md`), puis corrections et guides.
| energy | `DAILY_BATTERY_STATE` | Chaque jour : pleine charge, charge partielle (incertain), sous le plateau ou aucune charge ? | livrée (D-020) | `battery_state.py` |
| energy | `DAILY_BATTERY_TREND` | Face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | livrée (D-020) | `battery_trend.py` |
| energy | `DAILY_POWER_SOURCE` | Sur secteur (moyenne des 3 jours avant ≥ 14,0 V) ? Si oui, une heure < 13,4 V (perte du secteur) ? | livrée (D-043) | `power_source.py` |
| energy | `MOVING_AVERAGE_7_DAYS_DROP` | La moyenne sur 7 jours décroche-t-elle de son passé récent (> 0,2 V) ? | comparaison : ~2,7 jours d'avance sur VERMONT, bruitée | `moving_average.py` |
| energy | `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` | Même question, sur la seule mesure de 00:00 UTC | comparaison : peu bruitée, 1 h d'avance | `moving_average.py` |
| storage | `DAYS_UNTIL_STORAGE_FULL` | Dans combien de jours le disque sera-t-il plein, au rythme médian de 7 jours ? | prototype (D-034) | `days_until_full.py` |
| cellular | `DAILY_LINK_STATE` | Envois arrivés avec `link = up`, lien `down`, ou envois manquants ? | prototype (D-031) ; deux corrections retenues, non codées | `link_state.py` |
| cellular | `DAILY_SIGNAL_STATE` | Médianes du RSRP et du RSRQ sur la grille publiée | prototype (D-031) | `signal_state.py` |
| temperature | `DAILY_GPU_TEMPERATURE_LIMIT` | Une moyenne horaire du GPU a-t-elle atteint 97,5 °C dans les 24 dernières heures ? | prototype (D-040) | `gpu_temperature_limit.py` |
- **Couleur du jour** : `src/<domaine>/day_color.py`, transcription de la matrice tenue par l'utilisateur, `docs/<domaine>/matrice-*.drawio` : Energy état × tendance (sur secteur, la perte du secteur décide à sa place), Storage état × horizon, Cellular lien × signal ; Temperature sans matrice (Red si la limite est atteinte, sinon Green).
- **Par domaine** : calcul embarquable (bibliothèque standard ; Energy sans import de `common/`) ; scripts plotly du poste de dev, `final.py` (figure du site, D-021) et `all_analyses.py` (page de comparaison, D-016).
- **Travailler sur une analyse** : `.claude/rules/analyses.md` se charge seule dès qu'on touche `src/` ou `docs/*/analyses/`. Créer une analyse : skill `nouvelle-analyse` ; un domaine, donc une notification : skill `nouveau-domaine` (D-030).
-`[données]` : CSV ou dossiers ; défauts : `data/VERMONT/` (Energy), `data/WEISSHORN/` (Storage), `data/WEISSHORN/` et `data/NORDEND/` (Cellular, Temperature). Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; lancer les deux maquettes 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 ; dans le dev container, la page reste dans `out/`).
- **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 ; pour les détecteurs, le benchmark et la page des détecteurs.
-`docs/decisions.md` (990 l, D-001 à D-099) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
-`README.md` : point d'entrée pour un humain. `run.md` (125 l) : les commandes que lance l'utilisateur (pompage, étiquetage, métriques de qualité par `~/optical_emulator`, `/events-learner`, `/review-event`). `push.sh "<message>"` : pull, commit de tout, push. `run.sh` : la page Status, View et Labeling, chacun par son data loader.
-`decisions.md` : 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.
-`aimsight/` : documents reçus d'AIMsight, en anglais sauf les rapports d'analyse. À 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) : **la référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10).
-`AIMsight_agentic_support_project_context.md` (2 090 l) : extension support : chaîne de dépendance (§4), santé système (§5.1), règles épistémiques (§10), familles d'hypothèses (§12), format de sortie (§14-15), cas de régression (§16-17), cas d'usage (§23).
-`AIMsight_handoff_G_site_health.md` (150 l) : cadrage du product owner (2026-10-25), tel quel : sous-projet G, domaines de mesure, étiquette de responsabilité, « consistent with », traductions, sécurité de production ; puis nos écarts. À lire avant de concevoir côté client ou notifications.
-`AIMsight FAQ.pdf`, `AIMsight Test Manual.pdf` (en réalité le manuel de la station) : signaux, colonnes CSV, alimentation, schedules. `Mur de soutènement GN-1.472.pdf`, `GN-5.054.pdf` : rapports d'analyse remis au client (mai 2026, en français).
-`collecteur_system_info.py` : copie de référence du collecteur embarqué (INA219, table OCV LiFePO4, compensation IR 0,34 Ω), source des unités. Ne pas modifier.
- Ces documents prévoient un LLM pour la synthèse : la couche déterministe reste 100 % analytique ; la couche d'agents côté serveur (D-027) reprend l'idée, en exploration.
-`domaine/` : savoir métier commun, une note courte par question : `ce-que-mesure-la-station.md` (format CSV, métriques, unités ; la consommation est mesurée, pas l'apport), `pieges-des-donnees.md`, `colonnes-des-deplacements.md`, `images-de-la-camera.md` (IRON, la scène ; DIFF, les réflecteurs).
-`energy/`, `storage/`, `cellular/`, `temperature/` : un dossier par domaine système : `analyses/` (fiches, 70-120 l ; modèle `.claude/skills/nouvelle-analyse/modele-fiche.md`), `domaine/` (savoir métier, `point-de-depart.md`, `questions-pour-l-expert.md`), `guide/` (~90 l, client puis support ; la partie 1 est affichée dans la vue client), la matrice `.drawio`. Energy : `domaine/cas-annotes-par-l-expert.md` (diagnostics de 5 stations, vérité de référence), guide de 200 l en brouillon.
-`displacement/` : `cadrage.md` (158 l, séries optiques, D-044) ; `domaine/` : `ce-que-regarde-le-client.md` (sauts et tendances, D-055), `cas-annotes-par-l-expert.md` (les deux rapports d'analyse, sans données), `incident-de-barcelone.md` (E-004 : mouvement réel selon l'expert, instabilité des références selon la doc), `cycle-thermique.md`.
-`agents/` : `rapport-exploratoire.md` (292 l, agents LLM côté serveur, D-027), `enquete-a-la-demande.md` (233 l, D-042), `agent-diagnostic.md` (377 l, spec de l'agent), `pipelines-ia.drawio` (les processus automatiques, une page chacun).
-`ameliorations-faq.md` : idées pour la prochaine FAQ. `ameliorations-processus.md` : difficultés des processus automatiques, tenu par le `releveur` (D-060).
-`superpowers/` : specs et plans (110-1 450 l), historique non maintenu ; vivants : le plan `plans/2026-10-23-journal-du-matin.md` (1 440 l, index en tête) et `specs/2026-10-28-support-agent-design.md`. La spec d'une nouvelle analyse s'écrit dans sa fiche.
-`vues-deplacements/` : le chantier des déplacements (D-052), avec sa propre carte, `vues-deplacements/CLAUDE.md` : `maquette/` (page Explore et `spec.md`, D-053 à D-056), `contexte/` (journal du matin, seuils, lissage, `events-learner`, aiguisage, retiré), `cas/` (NORDEND, parcours de l'utilisateur), `benchmark/historique.csv` (D-069).
-`detectors/` : les détecteurs du journal (D-067, D-068, D-084), un détecteur élémentaire par fichier, contrat `detect(mesures)`, classés en événements par `categories.py` ; `archive/` : versions écartées.
-`detectors-view/` : le développement de la page des détecteurs (D-093), `detecteurs.py` : images, courbes, Status, catégories, Error rate ; `run-detectors.sh` : la page sur chaque station de `data/` ; `status.py` : la page Status, version pseudo finale de la page Explore du site : corr_x, corr_y, mouvement de la caméra, événements des détecteurs en plages colorées et en étiquettes cliquables au-dessus (sélection : ses capteurs, ses détails et son timelapse sous la figure, sans zoom) (D-094), occultés selon `hierarchie-des-status.md` (D-095, regroupement thermique suspendu) ; en haut, le data loader `data-loader/chargeur.py` (station, dates, « Analyse » ; son serveur, port 8766) ; la page des détecteurs est reprise par la page de fin de séance de `/events-learner` (`comparaison.py`) et par `/review-event`.
-`labeling/` : l'outil d'étiquetage de l'expert (D-098), `labeling.py` : un plot à la fois (déplacements, métriques système), une barre de temps pour sélectionner une plage, du texte libre et, au choix, une famille (D-109) ; Add écrit une ligne dans `manual/<STATION>.jsonl`, versionné ; un clic sur une étiquette la lit, la modifie ou la retire ; `familles.md` : les familles des étiquettes, leurs frontières (D-109) ; `carte-des-etiquettes.md` : les étiquettes revues rangées par phénomène, pour l'analyste, refaite par `/labels-map` (D-104) ; `manual/` : les étiquettes faites à la main, revues avec l'utilisateur par `/review-labels`, dont celles des events validés (D-100) ; `auto/` : celles de l'`etiqueteur` (D-105 à D-107) ; `lecons/` : les leçons de `/labels-learner` (D-099), une par phénomène.
-`view/` : `view.py`, les images IRON d'une station sous le data loader de la page Status (glisseur, flèches ; molette pour zoomer, glisser pour se déplacer ; case Labels : le nom des cibles et des références).
-`events-learner/`, `aiguiser/` : les séances de `/events-learner` et de `/aiguiser`, retiré (D-084, D-097), une par dossier `<séance>_<STATION>/` (`lot-NN/`, `bilan.md`) ; historique, à ne lire que sur demande.
-`events/` : **la base d'events, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre, seule porte d'entrée ; mode d'emploi : skill `read-event`, D-085), un dossier `E-xxx/` par event (`event.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/events-learner` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal, faux amis ; elle apprend de chaque event validé, D-087) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par l'event-builder de `/events-learner`.
-`agent-tools/` : les outils de lecture des agents (D-081) : `donnees.py` (lecture commune, aussi des détecteurs), `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `graphique`, `vignettes`, `gif` ; mode d'emploi : skill `lire-les-donnees` ; optimisés ou complétés par le `tool-builder` (D-097), hors de `/events-learner` depuis D-112.
-`support/` : un dossier par demande d'un client (D-079), `<date>_<STATION>_<sujet>/` : `demande.md`, `analyse.md`, `reponse.md` (le mail prêt à envoyer), GIF des images ; ou `<date>_<STATION>_rapport-situation/` : `rapport.md`, ses images, `presentation.typ` (le source) et `presentation.pdf`. Contient des mails et images de clients.
-`extraction/` : pompage `pomper.py` des données de la plateforme (D-056), en lecture seule, lancé par l'utilisateur dans le dev container de l'application de référence `~/monitoring-dashboard` ; sans argument, il met à jour jusqu'à maintenant les stations de `stations.txt` (D-096) ; mode d'emploi `extraction/README.md`.
-`src/` : un sous-dossier par domaine système (D-026), plus `common/` : `stations.py` (chargement des CSV, métriques texte en listes, trous de mesure ; bibliothèque standard) et `page.py` (bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`).
-`maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande : `user/summary.py` et `support/home.py`, chacun avec son gabarit, parcourent la liste de domaines `DOMAINS` (D-039).
-`data/` : un dossier par station, au numéro de série du système (D-029), rempli par le pompage, **hors de git** (D-065) : `metrics/` (un CSV par métrique et par jour), `displacement/` (« advanced », un CSV par jour), `camera/`, `images/`, au besoin `images_diff/` et `quality/`. Les stations présentes : `ls data/`.
- Jeux de travail : VERMONT pour Energy (D-009, le plus long historique) ; WEISSHORN pour Storage (D-034) ; WEISSHORN et NORDEND pour Cellular (D-030, D-032) et Temperature (D-040) ; à pomper s'ils manquent.
- WEISSHORN et NORDEND contiennent des identifiants (`SIM_CCID`, `ip`, `ip_*`) : ne pas les recopier.
- Un processus automatique à plusieurs agents (`/events-learner`) fait remonter ses difficultés : chaque sous-agent finit son rendu par `## Difficultés`, l'orchestrateur appelle le `releveur` en fin de processus, qui les note dans `docs/ameliorations-processus.md` (D-060). Pas dans une conversation ordinaire.
- Langue : échanges et documents projet en français ; documentation AIMsight en anglais (garder ses termes techniques) ; tout ce qui va au site en anglais (D-023).
- **Point d'entrée : scan proactif d'un export** (D-001). L'agent détecte les événements, les classe et explique chacun ; le mode « question de support » s'appuie sur le même socle.
- **Santé énergétique d'abord** (D-002) : ici, le trou de données *est* l'anomalie. Les déplacements ont suivi (D-044, D-056).
- **Pas de LLM dans la couche déterministe, pas de données synthétiques** (ni CSV simulés, ni générateur de scénarios : refus explicite de l'utilisateur). Le code d'analyse est **embarquable** : bibliothèque standard, calcul léger.
- **Anomalie énergétique = régime non soutenable** (l'apport ne couvre pas la consommation), pas une batterie basse. Une station débranchée avec une batterie pleine est déjà en anomalie.
- **Analyses combinées** : chaque analyse est une preuve imparfaite, juste « dans la majorité des cas » ; la combinaison fait le diagnostic (pour Energy, la matrice état × tendance, D-020). Une analyse seule conclut au plus `consistent with`. Préférer des fenêtres larges (plusieurs jours, multiples de 24 h).
- **Livrables** : pour le site, une figure Plotly par station et la couleur du jour (D-021) ; pour comparer, une page HTML par station, un panneau par analyse puis un graphique par série (D-016). Zoom dans le temps seulement, ordonnée recalée sur la plage visible (D-013).
- **Données** : CSV horaires en UTC, colonnes `,time_utc,metric` ; une valeur vide signifie qu'il n'y a pas de mesure. **Toute heure est en UTC** (données, noms de fichiers, documents, échanges) ; une heure locale ne figure que pour décrire une source qui l'utilise.
- **Unités** : `BusVoltage` [V], `BusCurrent` [mA], `Power` [mW], `ShuntVoltage` [mV]. Ces trois dernières sont une seule mesure : la **consommation**. **L'apport (panneau ou secteur) n'est pas mesuré.**
- **Batterie LiFePO4 de 12,8 V** :
- entre 30 et 90 % de charge, la tension de nuit reste plate ; elle ne chute qu'au coude (~12,8 V, puis ~12,5 V) ;
- sous 12 V, la station s'éteint et ne redémarre que vers ~12,6 V ;
- ≥ 14,0 V dans la journée signale une charge complète.
- **Les seuils de tension absolus ne se transposent pas d'une station à l'autre** : comparer la station à son propre passé. Exception : les seuils du matériel (fin de charge ~14,0 V, coude 12,8 V), admis pour les analyses d'état (D-018).
- **Un trou n'est pas forcément une coupure** : retard de synchronisation en fin de fichier, début d'historique, cause commune si plusieurs stations ont un trou en même temps.
-`pandas` n'est pas installé ; la bibliothèque standard suffit (`csv`, `datetime.fromisoformat`). `.venv/` (Python 3.14) ne contient que plotly et matplotlib (graphiques des agents), pour le poste de dev.
- Dev container (D-038) : Docker Engine dans WSL (réseau `mirrored`), VS Code « Reopen in Container ».