9.5 KiB
V1-2.6 : essai par le propriétaire de l'éditeur de fiche
Ce guide permet de tester l'éditeur de brouillon (niveau 1) dans votre navigateur, avant la validation
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 (/home/bchanot/Documents/faunosteo-v1-2), une
commande pnpm db:sandbox à la fois. 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).
1. Démarrer la pile jetable
pnpm db:sandbox up fresh
Attendu : une dizaine de secondes, puis == sandbox up (fresh): ….
2. Créer votre compte et ses droits
pnpm db:sandbox trial-account vous@example.com
Un mot de passe est demandé deux fois, sans écho (12 caractères au moins). Il n'est ni affiché ni enregistré.
Attendu : == account created and confirmed: vous@example.com. Le compte est déjà confirmé : aucun e-mail à lire.
pnpm db:sandbox trial-grant vous@example.com sheet_editor
pnpm db:sandbox trial-grant vous@example.com sheet_publisher
Attendu : == sheet_editor granted to vous@example.com, puis la même ligne pour sheet_publisher. Le droit
sheet_editor donne aussi le rôle d'administrateur (requis par l'éditeur). Relancer une commande est sans effet.
Un e-mail inconnu s'arrête sur no rows returned for \gset. Les droits possibles : catalog_reader,
sheet_editor, sheet_reviewer, sheet_publisher.
3. Lancer l'application d'essai
Dans un terminal que vous laissez ouvert :
pnpm db:sandbox trial
Attendu : == trial: http://127.0.0.1:5193, puis les lignes de Vite. L'application est servie sur
http://127.0.0.1:5193 et la même adresse relaie /auth/v1, /rest/v1 et /storage/v1 vers une passerelle
de l'essai, publiée sur 127.0.0.1:57801 uniquement : le navigateur ne parle qu'à une seule origine. La
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).
Double authentification (TOTP)
L'administration exige une session renforcée (aal2).
- Menu « Mon compte », section « Sécurité », bouton « Ajouter un facteur ».
- Nom du facteur (par exemple « Essai »), « Continuer ».
- Scannez le QR code avec l'application d'authentification (sinon recopiez la « Clé de configuration manuelle », affichée une seule fois), saisissez le code à 6 chiffres, « Vérifier ». Attendu : « Facteur ajouté et vérifié. »
- Menu « Administration » : la page « Double authentification requise » demande un code. Saisissez le code courant (attendez le suivant si le vôtre est sur le point d'expirer), « Vérifier ». Attendu : la liste des fiches officielles.
4. Parcours à dérouler
Chaque étape donne l'action et le résultat attendu. Notez tout écart avec la date et l'étape.
4.1 Créer une fiche non équine
- Administration, « Nouvelle fiche ». Choisissez une espèce autre que le cheval (une espèce inactive est
acceptée), renseignez « Nom (français) », « Nom (anglais) » et l'identifiant (slug, par exemple
essai-chien), « Créer la fiche ». - Attendu : la fiche apparaît, avec un brouillon vide, ouvrable dans l'éditeur (onglets Général, Vues et illustrations, Annotations, Constats, Références, Vertèbres, Vérification).
4.2 Importer une illustration SVG
Préparez deux fichiers dans un dossier hors du dépôt :
mkdir -p ~/essai-svg
cat > ~/essai-svg/valide.svg <<'SVG'
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 300"><rect x="20" y="20" width="360" height="260" fill="#eee" stroke="#333"/><circle cx="200" cy="150" r="60" fill="#c96"/></svg>
SVG
cat > ~/essai-svg/nettoyable.svg <<'SVG'
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 300"><style>.a{fill:#c96}</style><rect class="a" x="20" y="20" width="360" height="260"/></svg>
SVG
cat > ~/essai-svg/hostile.svg <<'SVG'
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 300"><script>alert(1)</script><rect x="20" y="20" width="360" height="260"/></svg>
SVG
- Onglet « Vues et illustrations », vue principale, « Choisir une illustration », fichier
valide.svg. Attendu : « L'illustration est ajoutée à la vue. » et le dessin s'affiche. - Même geste avec
nettoyable.svg. Attendu : la boîte « Nettoyer cette illustration ? » avec l'aperçu du dessin nettoyé et la mention que l'élément<style>est retiré. « Nettoyer et utiliser cette version » applique, « Annuler » n'ajoute rien. - Même geste avec
hostile.svg. Attendu : refus avec « Ce fichier contient du contenu actif ou externe… » ; aucune boîte de nettoyage, aucune illustration ajoutée.
4.3 Créer des annotations
- Onglet « Général » : créez une catégorie d'annotation (sans catégorie, l'onglet Annotations le signale).
- 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.
- Outil « Zone » : posez au moins trois sommets, Entrée ou « Fermer le tracé ». Attendu : la zone est créée.
- Ajoutez une vue de détail (onglet « Vues et illustrations », « Nouvelle vue de détail »), puis l'outil « Accès à une vue détaillée » : tracez un contour et choisissez la « Vue ouverte ». Attendu : l'accès est créé.
- « Annuler » et « Rétablir » défont et refont chaque création.
4.4 Correction de géométrie
- 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 brouillon ne change qu'après « Utiliser cette position ».
- Sélectionnez un point, ouvrez ses propriétés (« Position et rayon ») et saisissez dans « Centre x » une valeur hors du dessin (par exemple 9999). Attendu : « Valeurs non appliquées : le brouillon est inchangé. » ; « Revenir aux valeurs enregistrées » rétablit le champ. Une valeur valide s'applique.
4.5 Enregistrer et restaurer
- Faites une modification, puis « Enregistrer ». Attendu : « Révision N » avance, plus de mention de modifications non enregistrées.
- Faites une autre modification sans enregistrer et rechargez la page (F5). Attendu : le navigateur demande de confirmer le départ (beforeunload). Confirmez le rechargement.
- Attendu au retour : 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.
- Limites sur mobile :
beforeunloadest peu fiable sur Safari iOS et sur un onglet tué en arrière-plan ; la copie locale appartient à l'onglet et disparaît avec lui. Seul « Enregistrer » met le travail sur le serveur.
4.6 Concurrence entre deux onglets
- Ouvrez le même brouillon dans deux onglets (A et B). Dans A, modifiez et enregistrez.
- Dans B, modifiez autre chose et enregistrez. Attendu : la boîte « Conflit d'enregistrement » indiquant qu'une autre session de votre compte a enregistré la révision.
- « Recharger » (après confirmation) abandonne la modification de B et reprend la révision du serveur. Recommencez le conflit puis « Garder ma version » (après confirmation) : la version de B remplace la révision du serveur et la révision avance.
4.7 Vérification et soumission
- Onglet « Vérification » : les erreurs bloquantes sont listées ; « Aller à » ouvre l'onglet concerné.
- 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.
- 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.
5. Limites à connaître
- Risque résiduel RR-12 : les opérations du catalogue lisent la mention
aal2du jeton, pas la session vivante. Un jeton émis àaal2reste 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.
6. Arrêt et nettoyage
- Dans le terminal de
trial: Ctrl+C. Vite et la passerelle de l'essai s'arrêtent ensemble. - Puis :
pnpm db:sandbox down
Attendu : == sandbox removed. Vérification :
docker ps -a --format '{{.Names}}' | grep dbsandbox
Attendu : aucune ligne. Les secrets de la pile jetable sont supprimés avec elle. Rien n'a été écrit dans DEV.
Si le terminal de trial a été fermé sans Ctrl+C, pnpm db:sandbox down retire aussi la passerelle de l'essai ;
vérifiez ensuite que rien n'écoute plus sur le port 5193 (ss -ltn | grep 5193).