diff --git a/apps/app/vite/trial.config.ts b/apps/app/vite/trial.config.ts new file mode 100644 index 00000000..69a77a62 --- /dev/null +++ b/apps/app/vite/trial.config.ts @@ -0,0 +1,23 @@ +import { defineConfig, mergeConfig } from 'vite' +import base from '../vite.config' + +/** + * Dev server of `pnpm db:sandbox trial` (docs/development/V1-2-6_OWNER_TRIAL.md). + * The browser talks to this origin only: the three Supabase routes are + * forwarded to the trial gateway on loopback, so no CORS rule is involved. + */ +const target = process.env.FAUNOSTEO_TRIAL_GATEWAY +if (!target || new URL(target).hostname !== '127.0.0.1') + throw new Error('FAUNOSTEO_TRIAL_GATEWAY must be an http://127.0.0.1: URL') + +const SUPABASE_ROUTES = ['/auth/v1', '/rest/v1', '/storage/v1'] + +export default defineConfig((env) => + mergeConfig(base(env), { + server: { + proxy: Object.fromEntries( + SUPABASE_ROUTES.map((route) => [route, { target }]), + ), + }, + }), +) diff --git a/docs/development/BROWSER_TESTS.md b/docs/development/BROWSER_TESTS.md index 19753dfe..479d4de5 100644 --- a/docs/development/BROWSER_TESTS.md +++ b/docs/development/BROWSER_TESTS.md @@ -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`. diff --git a/docs/development/SUPABASE.md b/docs/development/SUPABASE.md index befb6454..8088b0b6 100644 --- a/docs/development/SUPABASE.md +++ b/docs/development/SUPABASE.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 ` / `trial-grant ` | 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 diff --git a/docs/development/V1-2-6_OWNER_TRIAL.md b/docs/development/V1-2-6_OWNER_TRIAL.md new file mode 100644 index 00000000..2a521df9 --- /dev/null +++ b/docs/development/V1-2-6_OWNER_TRIAL.md @@ -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 +cat > ~/essai-svg/nettoyable.svg <<'SVG' + +SVG +cat > ~/essai-svg/hostile.svg <<'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 `