Files
aimsight-app/app/README.md
T

45 lines
6.3 KiB
Markdown
Raw Normal View History

# La web app AIMsight
L'outil du diagnostic manuel : une seule page, **Data**.
## La page Data
- **Les plots** : un au départ (déplacements, caméra, qualité d'image, métriques système), « Ajouter un plot » pour en voir plusieurs, alignés sur le temps, la croix pour en enlever un ; un clic sur une courbe cale les images sur l'image la plus proche de cet instant. Les zones des étiquettes y sont à peine visibles (opacité 0,05, 0,07 en sombre).
- **Les étiquettes**, sous les plots, et leur barre, selon la source choisie :
- **Detectors** (par défaut) : les événements des détecteurs (`detectors/scripts/categories.py`, `events`), en lecture seule. La barre ne porte que leur famille, la bulle leurs cibles ; au clic : leurs dates, leurs capteurs (cibles et références), le message (la première phrase du texte de l'événement, `categories.sentence`) et l'action (la colonne « Pour le client » de `labeling/familles.md`, précisée par sorte, `station.ACTION_SORTE`) ;
- **LLM** : `labeling/auto/<STATION>.jsonl`, en lecture seule ;
- **Analysis** : les mêmes étiquettes, à modifier ou supprimer ; écrit dans `labeling/auto/<STATION>.jsonl`.
Avec Detectors et LLM, glisser sur la barre zoome dans le temps ; avec Analysis, cela sélectionne une plage à analyser. Un clic met une étiquette en évidence sur les plots et la barre, cale les images sur son début et l'ouvre (avec Analysis : bornes, famille, texte, Enregistrer, Supprimer) ; un clic ailleurs sur la barre la referme. La page ne montre pas `labeling/manual/`.
- **Les images de la caméra**, à droite, sur la même station et la même plage : glisseur, ◀ ▶ et flèches du clavier ; molette pour zoomer, glisser pour se déplacer, double clic pour l'image entière ; case Noms ; une plage sur la barre sous le glisseur dessine la flèche de déplacement de chaque capteur. Une flèche en haut à gauche agrandit l'image et pousse les plots vers la gauche ; la flèche inverse la ramène.
- **Les paramètres du diagnostic**, sous l'image : « Focus on event curves » (un événement ouvert, les plots ne montrent que ses capteurs : ceux des détecteurs, ou ceux que nomme le texte d'une étiquette), les familles montrées et, pour Detectors seulement, les cibles considérées, les autres écartées avant les détecteurs (« Relancer les détecteurs », paramètre `cibles` de `/api/detecteurs`).
L'adresse garde la station et la plage (UTC, `au` exclu) : `#/data?station=NIEDERHORN&du=2026-09-25&au=2026-10-08` ; sans dates, les 5 derniers jours UTC, aujourd'hui compris.
## L'onglet Analysis
- **Analyser la plage** : une plage sélectionnée, des indices facultatifs, puis `serveur/analyse.py` lance l'analyste du dépôt agents par `claude -p` (non interactif), avec ses consignes (`consignes/analyste.md`) et sans les détecteurs (`DETECTEURS : non`). Il écrit dans `labeling/auto/analyses/<STATION>_<début>_<fin>/` ses étiquettes et un rapport de diagnostic (`rapport.md` et ses figures ; son travail et le journal de claude dans `travail/`, hors de git). La page suit son avancement, puis montre le rapport ; le serveur verse ses étiquettes dans `labeling/auto/<STATION>.jsonl` (champ `analyse`). « Voir le rapport » sur une telle étiquette le rouvre.
- **La barre latérale** range les analyses de `labeling/auto/analyses/` en dossiers, un par station (ouvert d'office s'il en a une en cours), et dedans une analyse par plage, la plus récente en tête, avec son état ; un clic ouvre Data sur elle.
- **Les messages** : après le rapport, l'utilisateur écrit à l'analyste, la même session reprend (`--resume`). Une analyse s'arrête avec le serveur (« interrompue ») ; « continue » dans le champ de message la reprend.
- **Optimiser les détecteurs**, sur une analyse finie : `/improve` dans Optimizer (`optimizer/`, avec le plugin `agents/`) sur la plage de l'analyse, puis le `tool-builder` du dépôt agents ; les détecteurs commités dans `detectors/`, les outils de lecture dans `tools/`, chacun sur sa branche courante. La page suit le fil de la séance (`travail/optimisation.jsonl`), puis montre son bilan sous le rapport (`optimizer/seances/<analyse>_<heure>/summary.md`, puis `<analyse>/outils.md`). Une optimisation à la fois ; pendant, ni analyse ni message à l'analyste ; une optimisation coupée par l'arrêt du serveur se relance par le bouton. Les événements des détecteurs sont gardés en mémoire jusqu'à la fin d'une optimisation : après un `/improve` lancé hors de l'app, relancer le serveur.
## Lancer
La tâche VS Code **Run app** (`.vscode/tasks.json`), ou à la main (Node 22 pour le front) :
```bash
cd app/web && npm install && npm run build # une fois, et après chaque changement de la page
.venv/bin/python app/serveur/serveur.py # .venv : voir le README à la racine
```
La page s'ouvre sur `http://127.0.0.1:8770`. Réglages par variables : `AIMSIGHT_DATA` (données, défaut `data/`), `AIMSIGHT_LABELS` (étiquettes, défaut `labeling/`), `AIMSIGHT_PORT` (8770). Pour travailler sur la page : `npm run dev` dans `app/web/` (http://localhost:5173), le serveur Python lancé à côté.
## Les dossiers
- `serveur/serveur.py` : FastAPI ; sert la page construite et l'API sous `/api` (stations, images, courbes, détecteurs, étiquettes, analyses) ; ne répond qu'aux pages du poste (Host local, JSON déclaré).
- `serveur/station.py` : les données de la page Data ; lecture seule sur `data/` (par `tools/donnees.py`), écrit seulement dans `labeling/{auto,manual}/`.
- `serveur/analyse.py` : l'onglet Analysis ; lance `claude` avec l'agent `agents:analyste` (Read, Write, Bash autorisés sans demande) ; et l'optimisation, `/improve` dans Optimizer (Read, Write, Edit, Bash, Agent) puis l'agent `agents:tool-builder` (Read, Write, Edit, Bash).
- `serveur/check.py` : vérifications, sans appel à claude : `.venv/bin/python app/serveur/check.py`.
- `web/` : React (Vite) et Mantine ; `src/App.jsx` (en-tête, barre latérale, adresse), `src/pages/Data.jsx` (la page), `src/pages/Images.jsx` (les images, dans Data), `src/commun.jsx` (requêtes, cartes, sélecteur), `src/main.jsx` (thème). Plotly, habillé aux couleurs de Mantine, ne se charge qu'avec Data. `dist/` et `node_modules/` hors de git.
Le calcul de `serveur/station.py` (images, courbes, étiquettes) vient d'outils du dépôt Support-Agent, copiés le 2026-11-05 (commit 6e9f69a) ; il évolue désormais ici.