diff --git a/docs/development/V1-2-6_OWNER_TRIAL.md b/docs/development/V1-2-6_OWNER_TRIAL.md index c8c66c66..cd53145d 100644 --- a/docs/development/V1-2-6_OWNER_TRIAL.md +++ b/docs/development/V1-2-6_OWNER_TRIAL.md @@ -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 @ +``` + +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.