Files
Support-Agent/app

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 : la tâche VS Code run app (.vscode/tasks.json : 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).

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 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).