English: the app (server/, analysis.py, routes and JSON fields), instructions/analyst.md, docs; the table of shared renames
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
1d80a77cb1
commit
a3e6ade845
24 files changed
+1959
-1835
No files matched your search
+29
-29
@@ -1,45 +1,45 @@
|
||||
# La web app AIMsight
|
||||
# The AIMsight web app
|
||||
|
||||
L'outil du diagnostic manuel : une seule page, **Data**.
|
||||
The tool of the manual diagnostic: a single page, **Data**.
|
||||
|
||||
## La page Data
|
||||
## The Data page
|
||||
|
||||
- **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`.
|
||||
- **The plots**: one at the start (displacements, camera, image quality, system metrics), "Add a plot" to see several, aligned in time, the cross to remove one; a click on a curve sets the images to the image nearest to that moment. The zones of the labels are barely visible there (opacity 0.05, 0.07 in dark mode).
|
||||
- **The labels**, under the plots, and their bar, according to the chosen source:
|
||||
- **Detectors** (default): the detectors' events (`detectors/scripts/categories.py`, `events`), read-only. The bar carries only their family, the tooltip their targets; on click: their dates, their sensors (targets and references), the message (the first sentence of the text of the event, `categories.sentence`) and the action (the "For the client" column of `labeling/families.md`, refined per kind, `station.ACTION_KIND`);
|
||||
- **LLM**: `labeling/auto/<STATION>.jsonl`, read-only;
|
||||
- **Analysis**: the same labels, to edit or delete; writes in `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`).
|
||||
With Detectors and LLM, dragging on the bar zooms in time; with Analysis, it selects a range to analyze. A click highlights a label on the plots and the bar, sets the images to its start and opens it (with Analysis: bounds, family, text, Save, Delete); a click elsewhere on the bar closes it. The page does not show `labeling/manual/`.
|
||||
- **The camera images**, on the right, on the same station and the same range: slider, ◀ ▶ and keyboard arrows; wheel to zoom, drag to move, double click for the whole image; Names box; a range on the bar under the slider draws the displacement arrow of each sensor. An arrow at the top left enlarges the image and pushes the plots to the left; the reverse arrow brings it back.
|
||||
- **The diagnostic settings**, under the image: "Focus on event curves" (with an event open, the plots show only its sensors: those of the detectors, or those the text of a label names), the families shown and, for Detectors only, the targets considered, the others removed before the detectors ("Rerun the detectors", parameter `targets` of `/api/detectors`).
|
||||
|
||||
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.
|
||||
The address keeps the station and the range (UTC, `end` excluded): `#/data?station=NIEDERHORN&start=2026-09-25&end=2026-10-08`; without dates, the last 5 UTC days, today included.
|
||||
|
||||
## L'onglet Analysis
|
||||
## The Analysis tab
|
||||
|
||||
- **Analyser la plage** : une plage sélectionnée, des indices facultatifs, puis `serveur/analyse.py` lance l'analyste du dépôt agents par `claude -p` (non interactif), avec ses consignes (`consignes/analyste.md`) et sans les détecteurs (`DETECTEURS : non`). 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 : `/improve` dans Optimizer (`optimizer/`, avec le plugin `agents/`) sur la plage de l'analyse, puis le `tool-builder` du dépôt agents ; les détecteurs commités dans `detectors/`, les outils de lecture dans `tools/`, chacun sur sa branche courante. La page suit le fil de la séance (`travail/optimisation.jsonl`), puis montre son bilan sous le rapport (`optimizer/seances/<analyse>_<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 `/improve` lancé hors de l'app, relancer le serveur.
|
||||
- **Analyze the range**: a range selected, optional hints, then `server/analysis.py` launches the analyst of the agents repository by `claude -p` (non-interactive), with its instructions (`instructions/analyst.md`) and without the detectors (`DETECTORS: no`). It writes in `labeling/auto/analyses/<STATION>_<start>_<end>/` its labels and a diagnostic report (`report.md` and its figures; its work and claude's log in `work/`, outside git). The page follows its progress, then shows the report; the server submits its labels to `labeling/auto/<STATION>.jsonl` (field `analysis`). "View the report" on such a label opens it again.
|
||||
- **The sidebar** sorts the analyses of `labeling/auto/analyses/` into folders, one per station (open by default if it has one running), and inside one analysis per range, the most recent first, with its state; a click opens Data on it.
|
||||
- **The messages**: after the report, the user writes to the analyst, the same session resumes (`--resume`). An analysis stops with the server ("interrupted"); "continue" in the message field resumes it.
|
||||
- **Optimize the detectors**, on a finished analysis: `/improve` in Optimizer (`optimizer/`, with the plugin `agents/`) on the range of the analysis, then the `tool-builder` of the agents repository; the detectors committed in `detectors/`, the reading tools in `tools/`, each on its current branch. The page follows the thread of the session (`work/optimization.jsonl`), then shows its summary under the report (`optimizer/sessions/<analysis>_<time>/summary.md`, then `<analysis>/tools.md`). One optimization at a time; meanwhile, no analysis and no message to the analyst; an optimization cut by the server stopping is rerun with the button. The detectors' events are kept in memory until the end of an optimization: after an `/improve` run outside the app, restart the server.
|
||||
|
||||
## Lancer
|
||||
## Launch
|
||||
|
||||
La tâche VS Code **Run app** (`.vscode/tasks.json`), ou à la main (Node 22 pour le front) :
|
||||
The VS Code task **Run app** (`.vscode/tasks.json`), or by hand (Node 22 for the front end):
|
||||
|
||||
```bash
|
||||
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
|
||||
cd app/web && npm install && npm run build # once, and after each change of the page
|
||||
.venv/bin/python app/server/server.py # .venv: see the README at the root
|
||||
```
|
||||
|
||||
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é.
|
||||
The page opens on `http://127.0.0.1:8770`. Settings by variables: `AIMSIGHT_DATA` (data, default `data/`), `AIMSIGHT_LABELS` (labels, default `labeling/`), `AIMSIGHT_PORT` (8770). To work on the page: `npm run dev` in `app/web/` (http://localhost:5173), the Python server launched next to it.
|
||||
|
||||
## Les dossiers
|
||||
## The folders
|
||||
|
||||
- `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/` (par `tools/scripts/donnees.py`), écrit seulement dans `labeling/{auto,manual}/`.
|
||||
- `serveur/analyse.py` : l'onglet Analysis ; lance `claude` avec l'agent `agents:analyste` (Read, Write, Bash autorisés sans demande) ; et l'optimisation, `/improve` dans Optimizer (Read, Write, Edit, Bash, Agent) puis l'agent `agents: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/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.
|
||||
- `server/server.py`: FastAPI; serves the built page and the API under `/api` (stations, images, curves, detectors, labels, analyses); answers only the pages of the workstation (local Host, declared JSON).
|
||||
- `server/station.py`: the data of the Data page; read-only on `data/` (through `tools/scripts/data.py`), writes only in `labeling/{auto,manual}/`.
|
||||
- `server/analysis.py`: the Analysis tab; launches `claude` with the agent `agents:analyst` (Read, Write, Bash allowed without asking); and the optimization, `/improve` in Optimizer (Read, Write, Edit, Bash, Agent) then the agent `agents:tool-builder` (Read, Write, Edit, Bash).
|
||||
- `server/check.py`: checks, without calling claude: `.venv/bin/python app/server/check.py`.
|
||||
- `web/`: React (Vite) and Mantine; `src/App.jsx` (header, sidebar, address), `src/pages/Data.jsx` (the page), `src/pages/Images.jsx` (the images, in Data), `src/common.jsx` (requests, selector), `src/main.jsx` (theme). Plotly, dressed in Mantine's colours, loads only with Data. `dist/` and `node_modules/` outside git.
|
||||
|
||||
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.
|
||||
The computation of `server/station.py` (images, curves, labels) comes from tools of the Support-Agent repository, copied on 2026-11-05 (commit 6e9f69a); it now evolves here.
|
||||
Reference in new issue
Block a user