docs(docs): owner trial guide for the checkpoint decisions, SSH tunnel

This commit is contained in:
bchanot committed 2026-11-04 20:22:05 +01:00
1 parent 46fd861224
commit 086d6e939b
1 file changed
+74 -8
+74 -8
View File
@@ -4,8 +4,14 @@ Ce guide permet de tester l'éditeur de brouillon (niveau 1) dans votre navigate
fonctionnelle, sur une pile Supabase jetable. Rien ne touche DEV : les conteneurs `supabase_*_faunosteo`
ne sont ni lus ni arrêtés, la base de l'essai est `faunosteo_dbsandbox_*` et disparaît avec `down`.
Toutes les commandes se lancent à la racine du dépôt, une
commande `pnpm db:sandbox` à la fois. Prérequis : Docker, `pnpm install` fait, une application
Toutes les commandes se lancent depuis `/home/bchanot/Documents/faunosteo-v1-2` (la racine du worktree
durable), une commande `pnpm db:sandbox` à la fois. Première commande :
```bash
cd /home/bchanot/Documents/faunosteo-v1-2
```
Prérequis : Docker, `pnpm install` fait, une application
d'authentification TOTP (téléphone ou gestionnaire de mots de passe) pour l'étape 3, et un écran d'au moins
1 024 px de large (en dessous l'éditeur est en lecture seule).
@@ -50,7 +56,8 @@ de l'essai, publiée sur `127.0.0.1:57801` uniquement : le navigateur ne parle q
commande refuse de démarrer si la passerelle de l'essai existe déjà ou si l'un des ports est pris.
Ouvrez `http://127.0.0.1:5193/login` et connectez-vous avec le compte de l'étape 2. Le site n'est joignable que
depuis cette machine (pas depuis un téléphone du réseau local).
depuis cette machine (pas depuis un téléphone du réseau local). Pour l'ouvrir depuis un autre ordinateur, voir
la section « Accès depuis une autre machine (tunnel SSH) ».
### Double authentification (TOTP)
@@ -73,7 +80,11 @@ Chaque étape donne l'action et le résultat attendu. Notez tout écart avec la
acceptée), renseignez « Nom (français) », « Nom (anglais) » et l'identifiant (slug, par exemple `essai-chien`),
« Créer la fiche ».
2. Attendu : la création ouvre directement le brouillon vide dans l'éditeur, sans page intermédiaire (onglets Général, Vues et
illustrations, Annotations, Constats, Références, Vertèbres, Vérification).
illustrations, Annotations, Constats, Références, Vertèbres, Vérification). Une fiche neuve et vide s'ouvre
sur l'onglet « Général ».
3. Dans « Général », tapez des espaces autour d'un nom (par exemple ` Essai `) et validez. Attendu : les espaces
du début et de la fin sont retirés des noms et des libellés courts de l'éditeur ; les descriptions, notes,
citations et adresses ne sont jamais modifiées.
### 4.2 Importer une illustration SVG
Préparez trois fichiers dans un dossier hors du dépôt :
@@ -101,16 +112,37 @@ SVG
### 4.3 Créer des annotations
1. Onglet « Général », bloc « Nouvelle catégorie » : renseignez les noms, puis « Ajouter la catégorie ». Sans
catégorie, l'onglet Annotations le signale : « Créez d'abord une catégorie d'annotation (onglet Général). »
catégorie, l'onglet Annotations le signale quand vous y passez : « Créez d'abord une catégorie d'annotation
(onglet Général). »
2. Onglet « Annotations », outil « Point » : cliquez dans le dessin, renseignez les noms FR et EN, la catégorie, la
latéralité, « Créer ». Attendu : le point apparaît dans la liste et sur le dessin.
3. Outil « Zone » : posez au moins trois sommets, Entrée ou « Fermer le tracé ». Attendu : la zone est créée.
4. Ajoutez une vue de détail (onglet « Vues et illustrations », formulaire « Nouvelle vue de détail », bouton
« Ajouter la vue » ; le recadrage est facultatif), puis l'outil « Accès à
une vue détaillée » : tracez un contour et choisissez la « Vue ouverte ». Attendu : l'accès est créé.
5. « Annuler » et « Rétablir » (barre d'outils) défont et refont chaque création. Ne les confondez pas avec
5. « Annuler » et « Rétablir » (barre d'outils de l'onglet Annotations) défont et refont chaque création. Ne les confondez pas avec
« Annuler les modifications » (en-tête), qui abandonne tout ce qui n'est pas enregistré.
### 4.3 bis Utiliser l'illustration de la vue parente
Cette étape suppose une vue de détail qui a un recadrage (quatre valeurs) et sa propre illustration : ajoutez-la
dans « Vues et illustrations » avec un recadrage, puis « Choisir une illustration » avec `valide.svg`. Placez
une annotation sur cette vue (onglet Annotations).
1. Retour dans « Vues et illustrations », sur cette vue : « Utiliser l'illustration de la vue parente ».
Attendu : la boîte « Utiliser l'illustration de la vue parente ? » qui précise que la vue affichera
l'illustration de la vue parente à travers son recadrage, que son propre fichier reste enregistré, que le
changement s'annule, et que ses annotations repassent « à confirmer ». Boutons « Annuler » et « Utiliser
l'illustration parente ».
2. « Annuler » ne change rien. Recommencez et confirmez. Attendu : « Utilise l'illustration de la vue parente. »
et l'annotation de la vue marquée « À confirmer ».
3. Dans l'onglet Annotations, « Annuler » (barre d'outils) restaure l'illustration propre de la vue.
### 4.3 ter Catégories de constats
1. Onglet « Constats » : « Ajouter une zone », renseignez les noms, « Créer ».
2. Sélectionnez la zone puis « Ajouter une catégorie ». Attendu : le formulaire s'intitule « Nouvelle catégorie
dans la zone « … » » avec le nom de la zone ; la catégorie est créée directement sous la zone, quel que soit
l'élément sélectionné. Le bouton est grisé tant que rien n'est sélectionné.
3. Sélectionnez la catégorie puis « Ajouter un constat » : le constat s'insère sous l'élément sélectionné.
### 4.4 Correction de géométrie
1. Avec l'outil « Point », cliquez très près d'un bord du dessin. Attendu : « Le point ne tient pas à l'endroit
choisi. Position corrigée proposée : x = …, y = … » avec « Utiliser cette position » et « Annuler ». Le
@@ -126,7 +158,8 @@ SVG
modifications non enregistrées.
2. Faites une autre modification sans enregistrer et rechargez la page (F5). Attendu : le navigateur demande de
confirmer le départ (beforeunload). Confirmez le rechargement.
3. Attendu au retour, sur l'onglet « Annotations » (l'onglet affiché après tout rechargement) : une offre de copie locale (« Une copie locale temporaire de ce brouillon existe dans cet
3. Attendu au retour, sur l'onglet « Annotations » (une fiche qui a une vue mesurable s'ouvre sur cet onglet,
après rechargement aussi ; une fiche sans vue mesurable s'ouvre sur « Général ») : une offre de copie locale (« Une copie locale temporaire de ce brouillon existe dans cet
onglet… ») avec « Restaurer la copie » et « Ignorer la copie ». Restaurez : la modification revient, toujours
non enregistrée.
4. Limites sur mobile : `beforeunload` est peu fiable sur Safari iOS et sur un onglet tué en arrière-plan ; la
@@ -143,18 +176,51 @@ SVG
du serveur et la révision avance.
### 4.7 Vérification et soumission
1. Onglet « Vérification » : les erreurs bloquantes sont listées ; « Aller à » ouvre l'onglet concerné.
1. Onglet « Vérification » : les erreurs bloquantes sont listées, avec leur nombre accordé (« 0 erreur
bloquante », « 1 erreur bloquante », « 2 erreurs bloquantes ») ; « Aller à » ouvre l'onglet concerné.
2. Corrigez-les, enregistrez, saisissez la « Note de soumission (obligatoire) », « Soumettre à la revue ».
Attendu : le brouillon passe en lecture seule, avec la mention de la revue et de la vérification en cours.
3. Gel : aucun worker de vérification ne tourne dans cet essai et le retrait d'une soumission n'existe pas. Le
brouillon reste donc gelé jusqu'à `down`. C'est attendu, pas un défaut. Refaites un essai avec une nouvelle
fiche (4.1) si vous voulez continuer à modifier.
### 4.8 Déconnexion avec du travail non enregistré
1. Faites une modification sans l'enregistrer, puis « Se déconnecter ». Attendu : la boîte « Se déconnecter et
perdre le travail local ? » : des modifications non enregistrées ou des copies locales de cet onglet seraient
perdues, les enregistrer avant les conserve.
2. « Annuler » : vous restez connecté, rien n'est perdu.
3. Recommencez et choisissez « Se déconnecter quand même ». Attendu : déconnexion, et les copies locales de ce
compte dans cet onglet sont supprimées. Reconnectez-vous (TOTP compris) et rouvrez le brouillon : aucune offre
de copie locale, la dernière révision enregistrée.
4. Fin de session involontaire (expiration) : la copie locale est conservée et n'est proposée qu'au même compte ;
si un autre compte se connecte dans l'onglet, les copies des autres comptes sont supprimées sans lui être
montrées.
## 5. Limites à connaître
- Risque résiduel RR-12 : les opérations du catalogue lisent la mention `aal2` du jeton, pas la session vivante.
Un jeton émis à `aal2` reste accepté après la suppression du facteur, jusqu'à son expiration (une heure).
- Les e-mails ne partent nulle part (l'interface de courrier de la pile jetable est sur `127.0.0.1:57025`).
- Les mots de passe créés ici n'ont de valeur que pour cette pile.
- La pile est jetable : tout ce que vous créez (comptes, fiches, brouillons) est perdu à `down`.
- Safari iOS : `beforeunload` n'y est pas fiable (voir 4.5) ; seul « Enregistrer » protège le travail.
- Réparation à l'attache : si une vue sans illustration porte déjà des annotations (anciennes sauvegardes),
attacher une illustration dont le cadre en laisse certaines dehors ouvre la boîte « Réparer les annotations
hors du nouveau cadre » (boutons « Attacher et appliquer » et « Annuler »). Les valeurs proposées sont
modifiables et un seul « Annuler » restaure tout. Un tracé libre n'y est remplacé que par un petit triangle
au centre du cadre (« Remplacer par un polygone ») : sa forme est perdue. Ce cas ne s'obtient pas depuis une
fiche construite avec ce guide : il n'a pas d'étape et n'est couvert que par les tests automatiques.
## Accès depuis une autre machine (tunnel SSH)
Le serveur d'essai n'écoute que sur `127.0.0.1` (`apps/app/vite/trial.config.ts`). Depuis un autre ordinateur,
ouvrez un tunnel :
```bash
ssh -N -L 5193:127.0.0.1:5193 <utilisateur>@<machine>
```
Puis ouvrez `http://127.0.0.1:5193` sur cet ordinateur. Seul le port 5193 est nécessaire : Vite relaie les trois
routes Supabase vers la passerelle de l'essai sur `127.0.0.1:57801`. Laissez ce terminal ouvert ; Ctrl+C ferme
le tunnel. N'exposez jamais le port sur le réseau.
## 6. Arrêt et nettoyage
1. Dans le terminal de `trial` : Ctrl+C. Vite et la passerelle de l'essai s'arrêtent ensemble.