Files
Support-Agent/app/README.md
T

3.7 KiB

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 et son contexte, Analyser ; les fils du support et de l'analyste (les agents de API/, API/README.md), le PDF par version. Dès que la séance a sa station, deux boutons ouvrent Images et Étiquetage 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).
  • Étiquetage : comme labeling/labeling.py : deux plots alignés (déplacements, caméra, qualité, métriques système), la barre des étiquettes (auto ou manual) ; y glisser sélectionne une plage, puis famille, texte, Ajouter ; un clic ouvre une étiquette : bornes, famille, texte, Enregistrer, Supprimer. Écrit dans labeling/<auto|manual>/<STATION>.jsonl.

Images et Étiquetage 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).

cd app/web && npm install && npm run build

Puis le serveur, avec l'environnement Python des agents (API/.venv, plus app/requirements.txt) :

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 Étiquetage ; lecture seule sur data/, écrit seulement dans labeling/{auto,manual}/.
  • 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). ECharts (les courbes, D-139) ne se charge qu'avec Étiquetage. dist/ et node_modules/ hors de git.
  • docs/ : la conception des pages Images et Étiquetage.

Copies

Le calcul des pages Images et Étiquetage 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 : API/tools/agent-tools/donnees.py.