# 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 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).
> **Pile d'essai dédiée (`pnpm db:trial`).** Une pile persistante, séparée de la sandbox et de DEV, est préparée
> (scripts et contrôles, `docs/development/SUPABASE.md` §5.2). Elle n'est pas encore créée : sa création attend
> l'accord du propriétaire. Ce guide décrit l'essai sur la sandbox (`pnpm db:sandbox trial`), qui reste disponible.
> Sur la pile dédiée, le compte praticien d'essai reçoit le rôle technique `admin`, puis l'habilitation
> `sheet_editor` (refusée tant que `admin` manque) : ce n'est pas le profil d'un praticien de production.
## 1. Démarrer la pile jetable
```bash
pnpm db:sandbox up fresh
```
Attendu : une dizaine de secondes, puis `== sandbox up (fresh): …`.
## 2. Créer votre compte et ses droits
```bash
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.
```bash
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 :
```bash
pnpm db:sandbox trial
```
Attendu : `== trial: http://192.168.1.100:5193`, puis les lignes de Vite. L'adresse d'essai est celle de cette
machine sur le réseau local, déduite comme pour DEV (`FAUNOSTEO_DEV_HOST`). Si la ligne affiche une autre
adresse (par exemple celle d'un pont Docker), arrêtez avec Ctrl+C et relancez avec
`FAUNOSTEO_TRIAL_HOST=192.168.1.100 pnpm db:sandbox trial`. Pour un essai limité à cette machine :
```bash
FAUNOSTEO_TRIAL_HOST=127.0.0.1 pnpm db:sandbox trial
```
Seules sont acceptées l'adresse de bouclage ou une adresse privée (`10/8`, `172.16/12`, `192.168/16`) portée par
une interface de cette machine ; `0.0.0.0`, un nom et une adresse publique sont refusés avec un message.
Un seul port est ouvert au réseau local : **5193**, sur cette adresse uniquement (pas sur `0.0.0.0`). Vite relaie
`/auth/v1`, `/rest/v1` et `/storage/v1` vers une passerelle de l'essai publiée sur `127.0.0.1:57801` ; tous les
services de la pile jetable restent sur `127.0.0.1`. Le serveur d'essai refuse toute requête HTTP dont l'en-tête
`Host` n'est pas l'adresse d'essai, y compris une autre adresse IP ou `localhost` (réponse 403), et la route
`/__open-in-editor` de Vite est fermée (404 avec l'adresse d'essai). Il ferme toute connexion websocket (pas de rechargement automatique : après une modification du code, rechargez la page à la
main). Vite n'ajoute aucun en-tête CORS ; les routes Supabase relayées gardent ceux de la pile jetable, sans
effet sur la session, qui reste dans le navigateur de l'essai et n'est jamais un cookie.
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://192.168.1.100:5193/login`, depuis cette machine ou depuis un appareil du réseau local (téléphone
compris), et connectez-vous avec le compte de l'étape 2. Si `192.168.1.100:5193` ne répond pas depuis un autre
appareil, un pare-feu de la machine peut demander une règle pour ce port depuis le réseau local ; la commande
est la vôtre, elle n'est jamais lancée par les outils :
```bash
sudo ufw allow from 192.168.1.0/24 to any port 5193 proto tcp
```
Protections : réseau local de confiance uniquement (jamais d'exposition publique), compte à mot de passe et
double authentification pour l'administration, RLS sur toutes les tables, pile jetable. DEV (`supabase_*_faunosteo`)
n'est ni lu ni arrêté. Le site est servi en HTTP simple : sur le réseau, le mot de passe, la clé
d'enrôlement TOTP (le QR code), les codes TOTP et la session de l'essai circulent en clair. Quelqu'un qui
écoute le réseau pourrait donc copier le facteur : la double authentification ne protège pas contre lui.
Supprimez de votre application d'authentification l'entrée créée pour l'essai, une fois celui-ci terminé. N'utilisez donc qu'un réseau de confiance (pas un Wi-Fi public ou partagé),
et jamais un mot de passe qui compte. Seuls les fichiers de l'application sont servis (pas les notes du dépôt, ni
le seed, ni les secrets de la pile). Sur un réseau douteux, préférez `FAUNOSTEO_TRIAL_HOST=127.0.0.1` et le
tunnel SSH.
### Double authentification (TOTP)
L'administration exige une session renforcée (`aal2`).
1. Menu « Mon compte », section « Sécurité », bouton « Ajouter un facteur ».
2. Nom du facteur (par exemple « Essai »), « Continuer ».
3. 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é. »
4. 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
1. 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 ».
2. Attendu : la création ouvre directement le brouillon vide dans l'éditeur, sans page intermédiaire, avec
quatre onglets (Général, Annotations, Constats, 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 :
```bash
mkdir -p ~/essai-svg
cat > ~/essai-svg/valide.svg <<'SVG'
SVG
cat > ~/essai-svg/nettoyable.svg <<'SVG'
SVG
cat > ~/essai-svg/hostile.svg <<'SVG'
SVG
```
1. Onglet « Annotations », carte « Vues », « Gérer les vues » (section « Vues », avec « Retour au dessin » en
tête), vue principale, « Choisir une illustration », fichier `valide.svg`.
Attendu : « L'illustration est ajoutée à la vue. » et le dessin s'affiche (visible après « Retour au dessin »).
2. 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 `