app/: the web app in its own folder, with the Images and Labeling pages (D-138)

- app/serveur/ (FastAPI) and app/web/ (React, Mantine) moved out of API/, which keeps
  only the agents; the Support page drives them
- Images page: view.py in React (slider, zoom, sensor names, displacement arrows on a range)
- Labeling page: labeling.py in React (two aligned plots, label bar, add, edit, delete);
  labels are written to labeling/{auto,manual}/ of the repo (AIMSIGHT_LABELS)
- shared station and date selector kept in the address; buttons from a support session
- app/serveur/station.py: the data of both pages, copied computations listed in app/README.md
- app/serveur/check.py: server and station checks (labels in a temporary folder)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-05 14:25:57 +01:00
1 parent 374d91eb15
commit bd93e708d2
26 files changed
+1263 -206

No files matched your search

@@ -0,0 +1,76 @@
# Les pages Images et Étiquetage dans la web app support
Conception validée par Marc le 2026-11-05 ; l'app a ensuite quitté `API/` pour `app/` (D-138). Complète D-133 et D-137.
## L'intention
Marc fait son diagnostic à la main avec deux outils du projet : `view/view.py` (les images de la caméra) et `labeling/labeling.py` (les courbes et les étiquettes). Il veut que **tout soit centralisé dans l'app** : la page Support, plus ces deux pages, refaites en React dans la même app (Mantine, FastAPI), avec les mêmes gestes. Pas de nouvelle fonction : les deux outils, à l'identique, dans l'app.
## Les buts et les limites
- **Buts** : trois pages dans la barre latérale (Support, Images, Étiquetage) ; un seul sélecteur de station et de dates pour Images et Étiquetage ; depuis une séance de support, un accès direct à Images et à Étiquetage sur la station du cas.
- **Hors du périmètre** : rien de neuf dans les deux pages (pas de nouveau plot, pas de nouvelle fonction d'image) ; pas de PostgreSQL ni d'authentification ; les anciens outils restent dans le dépôt (le projet Claude Code s'en sert : `run.sh`, `/review-labels`), Marc cesse simplement de les utiliser.
- **À éviter** : deux vérités pour les étiquettes. Les étiquettes restent dans `labeling/` du dépôt, là où les détecteurs et les agents les lisent ; l'app y écrit, rien n'est copié.
## Ce que Marc a décidé
- Les deux pages refaites en React dans l'app, pas intégrées telles quelles (2026-11-05).
- L'app écrit les étiquettes dans `labeling/` du projet (proposé, accepté avec React).
## La navigation
- **Barre latérale** : trois liens, Support, Images, Étiquetage, avec une icône chacun. La section « Séance » (état des agents, coût) ne s'affiche que sur la page Support.
- **L'adresse suit la page** : `#/support`, `#/images?station=LENZSPITZE&du=2026-10-26&au=2026-10-28`, `#/etiquetage?…`. Recharger garde la page, la station et les dates ; le bouton Retour du navigateur marche. Pas de bibliothèque de routage : un `hashchange` suffit pour trois pages.
- **Le sélecteur** (Images, Étiquetage) : en haut de la page, une ligne : Station (menu des dossiers de `data/`), Du, Au (dates UTC, Au exclue, vides : toute la période), Charger. Il est partagé : passer d'Images à Étiquetage garde la station et les dates, et recharge la page sur elles.
- **Depuis le support** : dès que la séance a sa station (`poser_station`), deux boutons en tête des fils, « Images » et « Étiquetage », ouvrent la page sur cette station et les 7 derniers jours de ses données (la séance ne garde pas la plage du client ; Marc la règle ensuite).
## La page Images (comme `view.py`)
- L'image dans un cadre noir : molette pour zoomer autour du pointeur (×1 à ×40), glisser pour se déplacer, double clic pour l'image entière ; le zoom reste d'une image à l'autre.
- Glisseur, ◀ ▶ et les flèches du clavier ; l'heure UTC et le rang (« 12/288 ») ; les deux images voisines préchargées ; l'heure change quand la nouvelle image est chargée ; une image illisible le dit.
- Case **Noms** : chaque capteur à sa position médiane sur la plage, cible en jaune, référence en bleu et cercle pointillé (référence : `reproj_err` rempli) ; les noms restent à 12 px à l'écran quel que soit le zoom ; case grisée, avec la phrase « x, y ne sont pas des positions dans l'image », sur les stations où x, y ne sont pas des pixels (NADELHORN par endroits).
- **La barre des plages** sous le glisseur : y glisser choisit une plage d'images ; une plage placée se modifie par ses bords ou se déplace en entier ; un clic hors d'elle l'efface. Chaque capteur porte alors sa flèche verte : corr_x, corr_y à la fin moins au début (mesure valide la plus proche de l'heure de l'image, à 30 min près), amplifiée par un facteur modifiable, proposé pour que la plus grande flèche fasse 8 % de la largeur de l'image ; au survol d'une flèche, ses valeurs ; la plage en texte, et les capteurs sans mesure valide à une borne.
## La page Étiquetage (comme `labeling.py`)
- **Étiquettes** : un menu, `auto` (celles de l'étiqueteur, par défaut) ou `manual` (celles de Marc).
- **Deux plots** l'un sous l'autre, chacun avec son menu, dans l'ordre de `labeling.py` : error_value, x, y, relative_x, relative_y, corr_x, corr_y, reproj_err, mouvement de la caméra, métriques de qualité, puis les métriques système numériques (sans les identifiants). À l'ouverture : corr_x en haut, corr_y en bas. Le zoom de l'un s'applique à l'autre et à la barre (mêmes abscisses, mêmes marges) ; les capteurs cachés et le zoom restent d'un plot à l'autre ; au survol : capteur, valeur, heure UTC. Les zones étiquetées grisées sur les deux plots, la sélection en bleu.
- **La barre des étiquettes** sous les plots : une barre par étiquette, couleur de sa famille, son texte dedans, celles qui se chevauchent sur des rangées différentes ; y glisser sélectionne une plage ; un clic sur une étiquette l'ouvre.
- **Ajouter** : la plage sélectionnée (en texte), la famille (menu, facultative : les six familles et « None »), le texte ; Ajouter écrit aussitôt une ligne dans `labeling/<auto|manual>/<STATION>.jsonl`. Dans `auto`, l'étiquette reçoit son id stable (D-131).
- **Modifier** : l'étiquette ouverte montre ses bornes (UTC), sa famille, son texte ; Enregistrer (actif seulement si quelque chose a changé ; retire le champ `revue`, D-103), Fermer (demande confirmation si un changement n'est pas enregistré), Supprimer (avec confirmation). L'étiquette est retrouvée dans le fichier par son contenu, pas par son rang ; si le fichier a changé entre-temps, l'app le dit et ne touche à rien. Écriture par fichier temporaire puis remplacement.
- Les étiquettes sont relues à chaque chargement : la page montre toujours le fichier.
## Le serveur
Nouvelles routes de `app/serveur/serveur.py` (le calcul dans `app/serveur/station.py`), toutes en lecture seule sur `data/` :
| Route | Rend |
|---|---|
| `GET /api/stations` | les dossiers de `data/` |
| `GET /api/images?station&du&au` | les images de la plage (heure, adresse), les positions médianes, les références, corr_x/corr_y de chaque capteur à l'heure de chaque image |
| `GET /api/image/<station>/<fichier>` | une image de `data/<station>/images/` |
| `GET /api/courbes?station&du&au` | les plots de la page Étiquetage (heures une fois par série, valeurs, titres, couleurs) et les bornes de la plage |
| `GET /api/etiquettes?station&dossier` | les étiquettes du fichier |
| `POST`, `PUT`, `DELETE /api/etiquettes` | ajouter, modifier, retirer |
- Station : seulement un dossier de `data/` ; `dossier` : `auto` ou `manual` ; image : seulement un fichier de `images/` (chemins contenus).
- La garde actuelle (Host local, JSON déclaré) s'étend à PUT et DELETE.
- Les calculs viennent des outils existants, **copiés** dans `app/serveur/station.py`, leur provenance dans `app/README.md` : `positions`, `references`, les couleurs des capteurs et de la pose (`detectors-view/detecteurs.py`), `attribuer` (`labeling/ids.py`) ; la lecture des données par `API/tools/agent-tools/donnees.py` (déjà copié : `charger`, `charger_camera`, `charger_metriques`, `heure_image`).
- Réglage : `AIMSIGHT_LABELS` (défaut : `labeling/` du dépôt), comme `AIMSIGHT_DATA`. `API/` ne lit toujours que `data/` ; c'est l'app qui lit `data/` et écrit dans `labeling/{auto,manual}/` (D-138).
## Le front
- Une page par fichier dans `app/web/src/pages/` (`Support.jsx`, `Images.jsx`, `Etiquetage.jsx`), le reste dans `App.jsx`.
- Les courbes : Plotly (`plotly.js-dist-min`, la bibliothèque des outils actuels), chargé seulement à l'ouverture d'Étiquetage, pour que Support reste léger.
- Textes de l'interface en français (outil interne).
- Les heures partout en UTC.
## Vérifier
- `check.py` : les routes `stations`, `images`, `courbes` sur une station de `data/` ; ajouter, modifier, retirer une étiquette dans un dossier `labeling/` temporaire (avec l'id en `auto`) ; une station ou un chemin hors de `data/` refusés.
- Par captures (Chrome headless) : Images et Étiquetage sur NIEDERHORN du 2026-09-25 au 2026-10-08 (le jeu de test des détecteurs) et sur LENZSPITZE et NADELHORN, sur ordinateur et téléphone.
- Marc compare avec ses outils actuels sur une plage qu'il connaît.
## Laissé au constructeur
La forme exacte des réponses JSON, le découpage en composants, la façon d'aligner les plots (celle de `labeling.py` marche : relayout des trois figures sur la plage et les marges de celle qui change).