feat(supabase): owner trial sandbox commands and the V1-2.6 trial guide
This commit is contained in:
1 parent
aa5c10d73c
commit
ac5fbfbc44
5 files changed
+297
-2
No files matched your search
@@ -170,3 +170,7 @@ comes with them), read every visible string from `@/i18n/{fr,en}`, use
|
||||
fictitious values only, and pass the values a test creates to
|
||||
`requests.forbid(...)`. A new backend origin goes into the suite's
|
||||
`allowedOrigins`, never into a wildcard.
|
||||
|
||||
## Owner trial (V1-2.6)
|
||||
|
||||
`pnpm db:sandbox trial` serves the app on `127.0.0.1:5193` (Vite config `apps/app/vite/trial.config.ts`, proxy to a trial gateway on `127.0.0.1:57801`) for manual testing in the owner's browser, not a test suite. Ports 5193 and 57801 must be free. Guide: `docs/development/V1-2-6_OWNER_TRIAL.md`.
|
||||
@@ -805,6 +805,7 @@ Docker.
|
||||
| `pnpm db:sandbox e2e-shell` (= `pnpm e2e:shell`) | the authenticated `/app` shell in Chromium (`apps/app/e2e/shell`, `docs/development/BROWSER_TESTS.md`): a loopback dev server whose Supabase calls are replayed on the sandbox, fictitious accounts per test |
|
||||
| `pnpm db:sandbox verify-e2e` | V1-2.3: a gateway (`nginx:1.31-alpine`, sandbox network only, no host port) and the real verification worker `faunosteo_worker:dev run --jobs sheet-verify` against the sandbox, then `packages/supabase/tests/sandbox/sheet-verification.sandbox.ts`; both containers removed at the end, the service key passed through a 600 file deleted at start |
|
||||
| `pnpm db:sandbox avatar-e2e` | V1-2.3: the same gateway, published on `127.0.0.1:57800` only and routing `/auth/v1/` too, the real worker `faunosteo_worker:dev run` (default mode: avatars and sweep, 5 s sweep, no quarantine grace, 512 MiB as the compose `worker`) against the sandbox, then `packages/supabase/tests/e2e/avatar-flow.e2e.ts` through that port; the suite's psql calls go to the sandbox database container, which it requires by name; its two accounts are made per run with random passwords and deleted after; both containers removed at the end |
|
||||
| `pnpm db:sandbox trial` / `trial-account <email>` / `trial-grant <email> <kind>` | V1-2.6 owner trial (`docs/development/V1-2-6_OWNER_TRIAL.md`): the app on `127.0.0.1:5193` behind a trial gateway on `127.0.0.1:57801` (refuses to start when `faunosteo_dbsandbox_trial_gateway` exists), a confirmed account (hidden password prompt), a catalogue right (email and kind checked, passed as psql variables; editor and publisher also get the admin role) |
|
||||
| `pnpm db:sandbox sql` / `down` | psql as postgres on stdin / remove the stack |
|
||||
|
||||
Every CLI call passes `--db-url` with `sslmode=disable` (the sandbox has no
|
||||
|
||||
@@ -0,0 +1,168 @@
|
||||
# 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
|
||||
|
||||
```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://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`).
|
||||
|
||||
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 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 :
|
||||
|
||||
```bash
|
||||
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
|
||||
```
|
||||
|
||||
1. 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.
|
||||
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 `<style>` est retiré. « Nettoyer et utiliser cette version » applique,
|
||||
« Annuler » n'ajoute rien.
|
||||
3. 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
|
||||
1. Onglet « Général » : créez une catégorie d'annotation (sans catégorie, l'onglet Annotations le signale).
|
||||
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 », « 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éé.
|
||||
5. « Annuler » et « Rétablir » défont et refont chaque création.
|
||||
|
||||
### 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
|
||||
brouillon ne change qu'après « Utiliser cette position ».
|
||||
2. 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
|
||||
1. Faites une modification, puis « Enregistrer ». Attendu : « Révision N » avance, plus de mention de
|
||||
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 : 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
|
||||
copie locale appartient à l'onglet et disparaît avec lui. Seul « Enregistrer » met le travail sur le serveur.
|
||||
|
||||
### 4.6 Concurrence entre deux onglets
|
||||
1. Ouvrez le même brouillon dans deux onglets (A et B). Dans A, modifiez et enregistrez.
|
||||
2. 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.
|
||||
3. « 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
|
||||
1. Onglet « Vérification » : les erreurs bloquantes sont listées ; « 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.
|
||||
|
||||
## 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.
|
||||
|
||||
## 6. Arrêt et nettoyage
|
||||
1. Dans le terminal de `trial` : Ctrl+C. Vite et la passerelle de l'essai s'arrêtent ensemble.
|
||||
2. Puis :
|
||||
|
||||
```bash
|
||||
pnpm db:sandbox down
|
||||
```
|
||||
|
||||
Attendu : `== sandbox removed`. Vérification :
|
||||
|
||||
```bash
|
||||
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`).
|
||||
Reference in new issue
Block a user