PDF | Mail before Analyser. In mail mode the support agent gets ecrire_mail (body + figures of the session as attachments, mail-vN.json) instead of the presentation tools; its prompt ends with prompts/support-mail.md, without presentation.md and modele.typ. The page shows the text, Copier, and the attachments to download. check_sortie_mail in API/support/check.py. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
48 lines
5.2 KiB
Markdown
48 lines
5.2 KiB
Markdown
# La web app AIMsight
|
|
|
|
L'outil interne du support et du diagnostic manuel (D-137, D-138) : trois pages dans la barre latérale.
|
|
|
|
- **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, deux boutons ouvrent Images et Data sur elle.
|
|
- **Images** : 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 (cibles en jaune, références en bleu) ; une plage sur la barre sous le glisseur dessine la flèche de déplacement de chaque capteur (corr_x, corr_y, facteur modifiable).
|
|
- **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, LLM (`labeling/auto/`, l'étiqueteur), Detectors (les événements des détecteurs du journal, `detectors/categories.py`, en lecture seule, D-140) ou Manual (`labeling/manual/`), et leur barre ; 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 : 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|manual>/<STATION>.jsonl`. À droite, le visualiseur de la page Images, 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.
|
|
|
|
Images et Data partagent la station et la plage (UTC, Au exclue), dans l'adresse : `#/images?station=NIEDERHORN&du=2026-09-25&au=2026-10-08`.
|
|
|
|
## Lancer
|
|
|
|
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 des pages Images et 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 des pages Images et 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).
|