docs(docs): owner trial guide for the checkpoint decisions, SSH tunnel
This commit is contained in:
1 parent
46fd861224
commit
086d6e939b
1 file changed
+74
-8
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user