Le pompage (extraction/, tâches pomper et pomper une plage) ; docs alignées sur detectors et sans renvois à Support-Agent
- extraction/ : pomper.sh, pomper.py, stations.txt, lenzspitze_absolu.py repris de Support-Agent (code inchangé), README adapté ; .env à la racine, sortie dans out/ - README, CLAUDE.md, app/README réécrits : contrat avec detectors, pompage, vérifications - app/requirements.txt, seule liste des paquets Python (sans plotly ; matplotlib, pillow) - commentaires de l'app et nom du paquet npm sans renvois à Support-Agent ; familles.md : detectors/scripts/ Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
8c82368dec
commit
462ba9e9a1
19 files changed
+662
-60
No files matched your search
+27
-28
@@ -1,25 +1,35 @@
|
||||
# La web app AIMsight
|
||||
|
||||
L'outil du diagnostic manuel : la page Data (la page Images, retirée, vit dans Data ; la page Support est retirée).
|
||||
L'outil du diagnostic manuel : une seule page, **Data**.
|
||||
|
||||
- **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, un clic sur une courbe cale les images sur l'image la plus proche de son instant ; 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 Analysis (les mêmes étiquettes de `labeling/auto/`, à modifier, supprimer), et leur barre ; avec Detectors et LLM, y glisser zoome dans le temps ; avec Analysis, y glisser sélectionne une plage, puis des indices facultatifs, « Analyser la plage » : `serveur/analyse.py` lance l'analyste par `claude -p` (non interactif) sur la plage ; il écrit dans `labeling/auto/analyses/<STATION>_<début>_<fin>/` ses étiquettes et un rapport de diagnostic (`rapport.md`, ses figures ; son travail et le journal de claude dans `travail/`, hors de git) ; la page suit son avancement, puis montre le rapport, et le serveur verse ses étiquettes dans `labeling/auto/<STATION>.jsonl` (champ `analyse`, sans `revue` : à relire par `/review-auto-labels`) ; « Voir le rapport » sur une étiquette ainsi faite le rouvre. La barre latérale range toutes 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. Une analyse s'arrête avec le serveur (« interrompue ») : sa session gardée, « continue » dans le champ de message la reprend. Sur une analyse finie, « Optimiser les détecteurs » lance `/detectors:wf-improve` sur la plage de l'analyse, par `claude -p` (D-148) : les détecteurs, puis les outils de lecture, améliorés depuis l'analyse, commités sur `main` (les détecteurs dans `detectors/`) ; la page suit le fil de la séance (`travail/optimisation.jsonl`), puis montre son bilan (`<analyse>/detectors/<heure>/summary.md`, puis `<analyse>/outils.md`) sous le rapport. 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. 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. 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.
|
||||
## La page Data
|
||||
|
||||
Data garde la station et la plage (UTC, Au exclue) dans l'adresse : `#/data?station=NIEDERHORN&du=2026-09-25&au=2026-10-08`.
|
||||
- **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 par `claude -p` (non interactif). 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 : `/detectors:wf-improve` sur la plage de l'analyse (`--plugin-dir detectors`), puis le `tool-builder` ; les détecteurs commités dans `detectors/`, les outils de lecture ici, sur `main`. La page suit le fil de la séance (`travail/optimisation.jsonl`), puis montre son bilan sous le rapport (`<analyse>/detectors/<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 `/detectors:wf-improve` lancé hors de l'app, relancer le serveur.
|
||||
|
||||
## 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).
|
||||
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
|
||||
```
|
||||
|
||||
Puis le serveur, avec l'environnement Python du dépôt (`.venv`, voir le README à la racine) :
|
||||
|
||||
```bash
|
||||
.venv/bin/python app/serveur/serveur.py
|
||||
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é.
|
||||
@@ -27,20 +37,9 @@ La page s'ouvre sur `http://127.0.0.1:8770`. Réglages par variables : `AIMSIGHT
|
||||
## 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/`, écrit seulement dans `labeling/{auto,manual}/`.
|
||||
- `serveur/analyse.py` : l'onglet Analysis ; lance `claude` (Claude Code, connecté) avec l'agent `analyste`, outils Read, Write, Bash autorisés sans demande ; et l'optimisation, `/detectors:wf-improve` sur la plage de l'analyse (`--plugin-dir detectors`, outils Read, Write, Edit, Bash, Agent) puis l'agent `tool-builder` (Read, Write, Edit, Bash), autorisés sans demande.
|
||||
- `serveur/station.py` : les données de la page Data ; lecture seule sur `data/` (par `agent-tools/donnees.py`), écrit seulement dans `labeling/{auto,manual}/`.
|
||||
- `serveur/analyse.py` : l'onglet Analysis ; lance `claude` avec l'agent `analyste` (Read, Write, Bash autorisés sans demande) ; et l'optimisation, `/detectors:wf-improve` (Read, Write, Edit, Bash, Agent) puis l'agent `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/` (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.
|
||||
- `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.
|
||||
|
||||
## Copies
|
||||
|
||||
Le calcul de la page Data reprend des outils du dépôt Support-Agent ; 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/scripts/categories.py` (`events`), lus tels quels (pas une copie : la page montre les détecteurs du jour ; il garde leurs résultats, et les oublie à la fin d'une optimisation ; relancer le serveur après un `/detectors:wf-improve` lancé hors de l'app).
|
||||
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.
|
||||
@@ -1,3 +1,5 @@
|
||||
fastapi
|
||||
uvicorn
|
||||
markdown
|
||||
matplotlib
|
||||
pillow
|
||||
@@ -1,7 +1,7 @@
|
||||
"""La web app : .venv/bin/python app/serveur/serveur.py → http://127.0.0.1:8770
|
||||
|
||||
Le serveur FastAPI sert la page React construite (app/web/dist, `npm run build` dans app/web) et l'API sous /api.
|
||||
La page Data lit data/ et les étiquettes de labeling/ (station.py) ; son onglet Analysis lance l'étiqueteur, et l'optimisation
|
||||
La page Data lit data/ et les étiquettes de labeling/ (station.py) ; son onglet Analysis lance l'analyste, et l'optimisation
|
||||
des détecteurs (analyse.py).
|
||||
Réglages : AIMSIGHT_DATA (données), AIMSIGHT_LABELS (étiquettes), AIMSIGHT_PORT (port, 8770).
|
||||
"""
|
||||
@@ -100,7 +100,7 @@ def supprimer(corps: dict):
|
||||
return station.supprimer(corps)
|
||||
|
||||
|
||||
# --- l'onglet Analysis de la page Data (analyse.py) : l'étiqueteur lancé par claude -p sur une plage
|
||||
# --- l'onglet Analysis de la page Data (analyse.py) : l'analyste lancé par claude -p sur une plage
|
||||
|
||||
@app.post("/api/analyses")
|
||||
def lancer_analyse(corps: dict):
|
||||
|
||||
+8
-10
@@ -1,9 +1,7 @@
|
||||
"""Les données de la page Data : les images d'une station, ses courbes, ses étiquettes.
|
||||
|
||||
Repris de view/view.py et labeling/labeling.py (le calcul, pas les pages) ; positions, references, COULEURS, POSE et
|
||||
attribuer sont copiés de detectors-view/detecteurs.py et labeling/ids.py (app/README.md, « Copies »). La lecture des données est
|
||||
celle des agents, agent-tools/donnees.py ; les événements des détecteurs, ceux du journal,
|
||||
detectors/scripts/categories.py (D-140). Lecture seule sur data/ ; écrit seulement dans labeling/{auto,manual}/.
|
||||
La lecture des données est celle des agents, agent-tools/donnees.py ; les événements des détecteurs, ceux de
|
||||
detectors/scripts/categories.py (events). Lecture seule sur data/ ; écrit seulement dans labeling/{auto,manual}/.
|
||||
"""
|
||||
import bisect
|
||||
import functools
|
||||
@@ -24,7 +22,7 @@ from categories import events # noqa: E402
|
||||
|
||||
DONNEES = Path(os.environ.get("AIMSIGHT_DATA", RACINE / "data")).resolve()
|
||||
ETIQUETTES = Path(os.environ.get("AIMSIGHT_LABELS", RACINE / "labeling")).resolve()
|
||||
DOSSIERS = ("auto", "manual") # celles de l'étiqueteur (D-105), celles de Marc (D-102)
|
||||
DOSSIERS = ("auto", "manual") # celles des agents et de la page (D-105), celles de l'expert (D-102)
|
||||
FAMILLES = ("Visibility", "Obstruction", "Thermal displacement", "Displacement", "Target issue", "No data", "None") # D-109
|
||||
FORMAT = "%Y-%m-%dT%H:%MZ"
|
||||
MARGE_PX = 150 # detecteurs.MARGE_PX : x, y ne sont des positions dans l'image que loin du coin
|
||||
@@ -59,7 +57,7 @@ def bornes(du, au):
|
||||
return donnees.instant(du or "0001-01-01"), donnees.instant(au or "9999-01-01")
|
||||
|
||||
|
||||
# --- detectors-view/detecteurs.py
|
||||
# --- les positions des capteurs dans l'image
|
||||
|
||||
def positions(mesures, a, b):
|
||||
"""La position médiane de chaque capteur dans l'image sur [a, b) ({} si x, y n'y sont pas des positions)."""
|
||||
@@ -74,7 +72,7 @@ def references(mesures, a, b):
|
||||
return {s for s, ms in mesures.items() if any(m["reproj_err"] is not None for m in ms if a <= m["t"] < b)}
|
||||
|
||||
|
||||
# --- les images de la page Data (view/view.py)
|
||||
# --- les images de la page Data
|
||||
|
||||
def images(station, du, au):
|
||||
"""Les images de [du, au), les positions médianes des capteurs, les références, et par capteur entouré son corr_x,
|
||||
@@ -106,7 +104,7 @@ def image(station, nom):
|
||||
return f
|
||||
|
||||
|
||||
# --- la page Data (labeling/labeling.py)
|
||||
# --- les courbes de la page Data
|
||||
|
||||
def metriques(d, a, b):
|
||||
"""Les métriques système numériques de metrics/ sur [a, b) -> {nom: {t: valeur ou None}} (une valeur vide : None, le
|
||||
@@ -240,7 +238,7 @@ def action(v):
|
||||
or ACTION_FAMILLE.get(v["category"], "")
|
||||
|
||||
|
||||
# --- les étiquettes (labeling/labeling.py, labeling/ids.py)
|
||||
# --- les étiquettes
|
||||
|
||||
def fichier(station, source):
|
||||
if source not in DOSSIERS:
|
||||
@@ -307,7 +305,7 @@ def modifier(corps):
|
||||
del label["id"]
|
||||
if not c:
|
||||
del label["categorie"]
|
||||
label.pop("revue", None) # changée : à revoir par /review-labels (D-103)
|
||||
label.pop("revue", None) # changée : plus revue
|
||||
return remplace(corps.get("station"), corps.get("dossier", "manual"), avant, label)
|
||||
|
||||
|
||||
|
||||
Generated
+2
-2
@@ -1,10 +1,10 @@
|
||||
{
|
||||
"name": "support-aimsight",
|
||||
"name": "diagnostic-aimsight",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "support-aimsight",
|
||||
"name": "diagnostic-aimsight",
|
||||
"dependencies": {
|
||||
"@mantine/core": "^9.7.5",
|
||||
"@mantine/hooks": "^9.7.5",
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
{
|
||||
"name": "support-aimsight",
|
||||
"name": "diagnostic-aimsight",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
|
||||
@@ -7,7 +7,7 @@ import { IconPlus, IconX } from "@tabler/icons-react";
|
||||
import { appel, Selecteur } from "../commun.jsx";
|
||||
import { ImagesDe } from "./Images.jsx";
|
||||
|
||||
// Data, le visualiseur de courbes (et l'étiquetage de labeling/labeling.py) : un plot au départ, d'autres à ajouter ou enlever,
|
||||
// Data, le visualiseur de courbes et l'étiquetage : un plot au départ, d'autres à ajouter ou enlever,
|
||||
// tous alignés sur le temps ; sous eux les étiquettes : Detectors (les événements du journal), LLM (labeling/auto/, en lecture)
|
||||
// ou Analysis (les mêmes, à modifier, supprimer ; glisser sur la barre sélectionne une plage, que l'analyste diagnostique et
|
||||
// étiquette ; ailleurs, glisser zoome) ; un clic ouvre une
|
||||
|
||||
@@ -90,7 +90,7 @@ function Visionneuse({ station, d, compacte, large, basculer, instant }) {
|
||||
);
|
||||
}
|
||||
|
||||
// Le code de view/view.py (PAGE_JS), sur les éléments de la page -> la fonction qui défait ce qu'il a installé
|
||||
// Le comportement de l'image (zoom, déplacement, flèches), sur les éléments de la page -> la fonction qui défait ce qu'il a installé
|
||||
function installer(r, station, d) {
|
||||
const IM = d.images.map(i => ({ t: i.t, src: `/api/image/${encodeURIComponent(station)}/${encodeURIComponent(i.nom)}` }));
|
||||
const C = d.corr, XY = d.positions;
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
.message.relai { border-left: 3px solid var(--mantine-color-aimsight-filled); }
|
||||
.rapport { width: 100%; height: 78vh; border: 0; display: block; background: #fff; }
|
||||
|
||||
/* La page Images (view/view.py) */
|
||||
/* Les images de la caméra (Images.jsx) */
|
||||
.cadre { position: relative; height: calc(100vh - 420px); min-height: 300px; background: #000; overflow: hidden; cursor: grab;
|
||||
touch-action: none; border-radius: var(--mantine-radius-md) var(--mantine-radius-md) 0 0; }
|
||||
.cadre:active { cursor: grabbing; }
|
||||
|
||||
Reference in new issue
Block a user