Files
Support-Agent/app/README.md
T
maximeandClaude Opus 5.5 94e0f0b456 Data page: Labelling replaces Manual (D-144), LLM read-only, focus on event curves, family name in detector bars
Labelling creates, edits and deletes labels in labeling/auto/; LLM shows them read-only.
The focus switch shows only the open event's sensors in the plots.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 11:00:41 +01:00

49 lines
6.2 KiB
Markdown

# La web app AIMsight
L'outil interne du support et du diagnostic manuel (D-137, D-138) : deux pages dans la barre latérale (la page Images, retirée, D-143, vit dans Data).
- **Support** : coller le mail du client, ou choisir sa conversation dans le menu « Depuis LibreDesk » (le fil, le plus récent en tête, sans les notes privées, et ses images de plus de 10 ko ; retouchable), et son contexte, choisir PDF ou Mail, Analyser ; les fils du support et de l'analyste (les agents de `API/`, `API/README.md`), puis le PDF par version, ou le mail (texte, bouton Copier, pièces jointes à télécharger ; `mail-vN.json` dans la séance). Dès que la séance a sa station, un bouton ouvre Data sur elle.
- **Data** (D-139) : le visualiseur de courbes, et l'étiquetage de `labeling/labeling.py` : un plot au départ (déplacements, caméra, qualité, métriques système), « Ajouter un plot » pour en voir plusieurs, alignés sur le temps, la croix pour en enlever un ; sous eux le choix des étiquettes, Detectors (les événements des détecteurs du journal, `detectors/categories.py`, en lecture seule, D-140), LLM (`labeling/auto/`, en lecture seule) ou Labelling (les mêmes étiquettes de `labeling/auto/`, à créer, modifier, supprimer, D-144), et leur barre ; avec Labelling, y glisser sélectionne une plage, puis famille, texte, Ajouter ; un clic met une étiquette en évidence sur les plots et la barre, cale les images sur son début, et l'ouvre (avec Labelling : bornes, famille, texte, Enregistrer, Supprimer) ; un clic ailleurs sur la barre la referme. Les zones des étiquettes sur les plots sont à peine visibles (opacité 0,05, 0,07 en sombre). Écrit dans `labeling/auto/<STATION>.jsonl` ; `labeling/manual/` ne s'écrit plus que par `labeling/labeling.py`. À droite, les images de la caméra, comme `view/view.py` (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), sur la même station et la même plage (D-140) ; une flèche en haut à gauche de l'image l'agrandit et pousse les plots vers la gauche (les colonnes glissent, les plots se recalent à la fin du glissement), la flèche inverse la ramène. Les événements des détecteurs ne portent que leur famille dans la barre ; la bulle donne leurs cibles ; au clic, leurs dates, leurs capteurs (cibles et références), le message (la première phrase du journal) et l'action (la colonne « Pour le client » de `labeling/familles.md`, précisée par sorte, `station.ACTION_SORTE`). Sous l'image, les paramètres du diagnostic : « 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 (filtre immédiat de la page) 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`). Sans dates dans l'adresse, la sélection prend les 5 derniers jours UTC, aujourd'hui compris. Detectors est la source par défaut.
Data garde la station et la plage (UTC, Au exclue) dans l'adresse : `#/data?station=NIEDERHORN&du=2026-09-25&au=2026-10-08`.
## Lancer
En une commande, depuis la racine : `./run_server.sh` (construit le front, puis lance le serveur). Ou à la main :
Une fois, et après chaque changement de la page : construire le front (Node 22).
```bash
cd app/web && npm install && npm run build
```
Puis le serveur, avec l'environnement Python des agents (`API/.venv`, plus `app/requirements.txt`) :
```bash
API/.venv/bin/python app/serveur/serveur.py
```
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_CASES` (séances, défaut `API/cases/`), `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` (séance, flux des agents, PDF, stations, images, courbes, étiquettes) ; 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/`, écrit seulement dans `labeling/{auto,manual}/`.
- `serveur/libredesk.py` : les conversations et les mails de LibreDesk, en lecture seule (API REST v1, `token clé:secret`) ; ses réglages `LIBREDESK_*` dans `API/.env` (`API/README.md`).
- `serveur/check.py` : vérifications, sans appel à l'API : `API/.venv/bin/python app/serveur/check.py`.
- `web/` : React (Vite) et Mantine ; `src/App.jsx` (en-tête, barre latérale, pages, adresse), `src/pages/` (une page par fichier), `src/commun.jsx` (requêtes, cartes, sélecteur), `src/main.jsx` (thème). Plotly, habillé aux couleurs de Mantine (D-139), ne se charge qu'avec Data. `dist/` et `node_modules/` hors de git.
- `docs/` : la conception des pages Images et Étiquetage (devenue Data, D-139).
## Copies
Le calcul de la page Data reprend les outils du projet ; ce qui en est copié dans `serveur/station.py` vieillit avec eux.
| Source | Copie | Commit | Date | Adaptation |
|---|---|---|---|---|
| `view/view.py` : `page()` (images, corr à l'heure de chaque image) | `images()` | 6e9f69a | 2026-11-05 | rend du JSON, pas une page |
| `labeling/labeling.py` : `metriques()`, `plots()`, `ajouter()`, `modifier()`, `supprimer()`, `remplace()` | `metriques()`, `courbes()`, et les fonctions des étiquettes | 6e9f69a | 2026-11-05 | rend du JSON ; métriques lues sans `common.stations` |
| `detectors-view/detecteurs.py` : `positions()`, `references()`, `COULEURS`, `POSE`, `MARGE_PX` | idem | 6e9f69a | 2026-11-05 | aucune |
| `labeling/ids.py` : `attribuer()`, `en_tete()` | `attribuer()` | 6e9f69a | 2026-11-05 | sans `retires` (inutile à l'ajout) |
La lecture des données est celle des agents, `agent-tools/donnees.py` ; les événements des détecteurs, ceux du journal, `detectors/categories.py`, lus tels quels (pas une copie : la page montre les détecteurs du jour ; relancer le serveur après une séance de `/detector-learner`, il garde leurs résultats).