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
@@ -1,54 +1,54 @@
|
||||
# Diagnostic-app
|
||||
|
||||
Le poste de pilotage du diagnostic AIMsight : voir, analyser, lancer. La page Data montre les courbes, les images de la caméra, les étiquettes et les événements des détecteurs ; son onglet Analysis lance, par `claude -p`, des processus dont le code vit dans les autres dépôts :
|
||||
The control station of the AIMsight diagnostic: see, analyze, launch. The Data page shows the curves, the camera images, the labels and the detectors' events; its Analysis tab launches, by `claude -p`, processes whose code lives in the other repositories:
|
||||
|
||||
- **« Analyser la plage »** : l'`analyste` du dépôt agents, sur une plage choisie, avec les consignes de l'app (`consignes/analyste.md`) et sans les détecteurs (`DETECTEURS : non`) : des étiquettes, versées dans `labeling/auto/`, et un rapport de diagnostic ;
|
||||
- **« Optimiser les détecteurs »**, sur une analyse finie : `/improve` dans Optimizer améliore les détecteurs sur la plage de l'analyse, ses étiquettes pour vérité, sans sur-apprentissage ; puis le `tool-builder` du dépôt agents fait entrer les scripts de l'analyste dans le harnais de lecture (dépôt tools).
|
||||
- **"Analyze the range"**: the `analyst` of the agents repository, on a chosen range, with the app's instructions (`instructions/analyst.md`) and without the detectors (`DETECTORS: no`): labels, submitted to `labeling/auto/`, and a diagnostic report;
|
||||
- **"Optimize the detectors"**, on a finished analysis: `/improve` in Optimizer improves the detectors on the range of the analysis, its labels as truth, without overfitting; then the `tool-builder` of the agents repository brings the analyst's scripts into the reading harness (tools repository).
|
||||
|
||||
L'architecture des dépôts, une responsabilité chacun : `docs/architecture.drawio`.
|
||||
The architecture of the repositories, one responsibility each: `docs/architecture.drawio`.
|
||||
|
||||
## Le dépôt
|
||||
## The repository
|
||||
|
||||
- `app/` : la web app (serveur FastAPI, page React et Mantine) ; sa doc dans `app/README.md`.
|
||||
- `consignes/analyste.md` : ce que l'app demande à l'analyste (dossier de sortie, rapport, dialogue).
|
||||
- `docs/` : l'architecture des dépôts, les plans.
|
||||
- `app/`: the web app (FastAPI server, React and Mantine page); its doc in `app/README.md`.
|
||||
- `instructions/analyst.md`: what the app asks of the analyst (output folder, report, dialogue).
|
||||
- `docs/`: the architecture of the repositories, the plans.
|
||||
|
||||
Et six liens, ignorés par git, vers les dépôts voisins (un seul exemplaire de chacun sur le poste) :
|
||||
And six links, ignored by git, to the neighbouring repositories (a single copy of each on the workstation):
|
||||
|
||||
| Lien | Dépôt | Ce que l'app en fait |
|
||||
| Link | Repository | What the app does with it |
|
||||
|---|---|---|
|
||||
| `data/` | `~/aimsight-data/data` | lit les données des stations (hors de git) |
|
||||
| `labeling/` | `~/labeling` | lit et écrit les étiquettes ; les analyses vont dans `labeling/auto/analyses/` |
|
||||
| `detectors/` | `~/detectors` | lit les événements des détecteurs (`scripts/categories.py`) |
|
||||
| `tools/` | `~/tools` | lit les données par `tools/scripts/donnees.py` ; l'analyste s'en sert, le tool-builder y écrit |
|
||||
| `agents/` | `~/agents` | le plugin des agents (`--plugin-dir agents`, `--agent agents:analyste`) |
|
||||
| `optimizer/` | `~/Optimizer` | y lance `/improve` ; lit les bilans dans `optimizer/seances/` |
|
||||
| `data/` | `~/aimsight-data/data` | reads the data of the stations (outside git) |
|
||||
| `labeling/` | `~/labeling` | reads and writes the labels; the analyses go in `labeling/auto/analyses/` |
|
||||
| `detectors/` | `~/detectors` | reads the detectors' events (`scripts/categories.py`) |
|
||||
| `tools/` | `~/tools` | reads the data through `tools/scripts/data.py`; the analyst uses it, the tool-builder writes in it |
|
||||
| `agents/` | `~/agents` | the plugin of the agents (`--plugin-dir agents`, `--agent agents:analyst`) |
|
||||
| `optimizer/` | `~/Optimizer` | launches `/improve` there; reads the summaries in `optimizer/sessions/` |
|
||||
|
||||
On commite chaque chose dans son dépôt : les étiquettes dans `~/labeling`, les détecteurs dans `~/detectors` (la séance d'optimisation le fait, sans pousser), les outils dans `~/tools` (le tool-builder le fait).
|
||||
Each thing is committed in its own repository: the labels in `~/labeling`, the detectors in `~/detectors` (the optimization session does it, without pushing), the tools in `~/tools` (the tool-builder does it).
|
||||
|
||||
## Installer et lancer
|
||||
## Install and launch
|
||||
|
||||
```bash
|
||||
ln -s ~/aimsight-data/data data && ln -s ~/labeling labeling && ln -s ~/detectors detectors
|
||||
ln -s ~/tools tools && ln -s ~/agents agents && ln -s ~/Optimizer optimizer
|
||||
```
|
||||
|
||||
La tâche VS Code **Run app** crée `.venv` et construit le front s'ils manquent, puis lance le serveur. À la main :
|
||||
The VS Code task **Run app** creates `.venv` and builds the front end if they are missing, then launches the server. By hand:
|
||||
|
||||
```bash
|
||||
python3 -m venv .venv && .venv/bin/pip install -r app/requirements.txt
|
||||
cd app/web && npm install && npm run build && cd ../..
|
||||
.venv/bin/python app/serveur/serveur.py
|
||||
.venv/bin/python app/server/server.py
|
||||
```
|
||||
|
||||
La page s'ouvre sur `http://127.0.0.1:8770`. `claude` (Claude Code, connecté à l'abonnement) doit être sur le `PATH` pour l'onglet Analysis.
|
||||
The page opens on `http://127.0.0.1:8770`. `claude` (Claude Code, logged in to the subscription) must be on the `PATH` for the Analysis tab.
|
||||
|
||||
## Pomper les données
|
||||
## Pump the data
|
||||
|
||||
Le pompage est dans le dépôt `~/aimsight-data` (`extraction/`, tâches VS Code **pomper** et **pomper une plage**) ; mode d'emploi `~/aimsight-data/extraction/README.md`.
|
||||
The pumping is in the `~/aimsight-data` repository (`extraction/`, VS Code tasks **pump** and **pump a range**); user guide `~/aimsight-data/extraction/README.md`.
|
||||
|
||||
## Vérifier
|
||||
## Check
|
||||
|
||||
- l'app : `.venv/bin/python app/serveur/check.py` ;
|
||||
- les étiquettes : `python3 labeling/controle.py` (les étiquettes versées par l'app n'ont pas encore `revue`, qu'elle exige : autant d'erreurs attendues) ;
|
||||
- les détecteurs (benchmark, ~3 min) : `python3 detectors/bench/regression.py --labels labeling/auto --data data`.
|
||||
- the app: `.venv/bin/python app/server/check.py`;
|
||||
- the labels: `python3 labeling/validate.py` (the labels submitted by the app do not have `review` yet, which it requires: as many expected errors);
|
||||
- the detectors (benchmark, ~3 min): `python3 detectors/bench/regression.py --labels labeling/auto --data data`.
|
||||
Reference in new issue
Block a user