Files
faunosteo/docs/development/V1-2-6_OWNER_TRIAL.md
T
bchanot 4e2bdb5ebb docs(docs): U2 final gate results and measures on 15b23f8
UX_TESTS: gates at 15b23f8 (check:all passed; shell suite 311 passed, 14 failed, red; test 105 passed; test-db FAIL 014/021 as before U2), measures rerun, keyboard map row (Backspace only while tracing). Plan Tasks 8 and 10 and OWNER_TRIAL Mesures carry the new figures.
2026-11-18 14:54:24 +01:00

1040 lines
90 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
cinq onglets (Général, Annotations, Constats, Références, 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 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 « 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 `<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 « Annotations », carte « Catégories », « Modifier les catégories » (section « Catégories »), bloc
« Nouvelle catégorie » : renseignez les noms, puis « Ajouter la catégorie », puis « Retour au dessin ». Sans
catégorie, la création d'une annotation le signale : « Créez d'abord une catégorie d'annotation (Annotations,
section Catégories). »
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 « Annotations », « Gérer les vues », formulaire « Nouvelle vue de détail »,
bouton « Ajouter la vue » ; le recadrage est facultatif ; puis « Retour au dessin »), 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. « Défaire » et « Refaire » (à droite de la rangée d'onglets, sur chaque onglet ; noms accessibles « Défaire la
dernière modification » et « Refaire la dernière modification défaite ») défont et refont chaque création. Ne les confondez pas avec « Abandonner les
modifications » (en-tête), qui abandonne tout ce qui n'est pas enregistré et reprend la dernière révision
du serveur, après confirmation.
### 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 « Gérer les vues » (onglet Annotations) avec un recadrage, puis « Choisir une illustration » avec
`valide.svg`. Placez une annotation sur cette vue (« Retour au dessin »).
1. Retour dans « Gérer les vues », 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 peut se défaire (« Défaire »), 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. « Défaire » (à droite de la rangée d'onglets), depuis n'importe quel onglet, 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. « Ajouter une catégorie », quel que soit l'élément sélectionné (même aucun). Le formulaire demande la
« Zone » ; elle n'est présélectionnée que s'il n'existe qu'une zone. Attendu : le titre devient « Nouvelle
catégorie dans la zone « … » » avec la zone choisie, et la catégorie est créée directement sous cette zone.
Tant qu'aucune zone n'existe, le bouton est grisé avec « Créez d'abord une zone pour ajouter une catégorie. »
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
brouillon ne change qu'après « Utiliser cette position ». Sur un petit dessin (quelques centaines d'unités,
comme l'export Inkscape de 200 × 150), le cœur accepte souvent un point réduit tout près du bord et la
correction n'apparaît pas : faites cet essai sur un dessin d'au moins 1 000 unités de large.
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, 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
copie locale appartient à l'onglet et disparaît avec lui. Seul « Enregistrer » met le travail sur le serveur. Au toucher, tant qu'une
annotation déplaçable est sélectionnée, le dessin ne défile plus sous le doigt.
### 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 : une boîte intitulée « Une autre session a enregistré la
révision N » (« Conflit d'enregistrement » n'apparaît que le temps de la lecture du brouillon du serveur) et
indiquant qu'elle vient d'une autre session de votre compte.
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, 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.
### 4.9 Démonstration U1 : la nouvelle coque de l'éditeur
À dérouler sur la fiche non équine de 4.1, après les étapes 4.2 et 4.3 (il faut au moins une annotation et un
constat avec une référence). La fiche de démonstration n'est pas créée par la commande d'essai : c'est celle que
vous avez créée dans l'interface.
1. Les onglets (cinq depuis R2, voir 4.10 ; « Références » s'insère avant « Vérification ») : « Général »,
« Annotations », « Constats », « Références », « Vérification ». Passez de l'un à l'autre à
la souris, puis au clavier (flèches gauche et droite dans la rangée d'onglets). Revenez sur un onglet : ce que
vous y aviez saisi et sélectionné est resté.
2. Dans « Général », modifiez un nom sans enregistrer. Passez sur « Annotations » et cliquez « Défaire » à droite
de la rangée d'onglets. Attendu : le nom d'origine revient dans « Général » ; « Refaire » le remet. Un champ en
cours de saisie est validé avant « Défaire », donc sa saisie est la dernière modification défaite.
3. Désélection : dans « Annotations », sélectionnez une annotation (le panneau de ses propriétés s'ouvre).
« Désélectionner » (à côté de « Supprimer ») la désélectionne, de même qu'Échap, et le message « Aucune
annotation sélectionnée. » est annoncé. Sélectionnez-la de nouveau, puis cliquez sur un os du dessin, sur un
espace vide du dessin ou sur la marge de la boîte : la sélection est levée, rien n'est ajouté à l'historique.
Un clic sur une autre annotation la sélectionne ; un glisser, un panoramique ou un zoom ne désélectionne pas.
Sur un écran tactile, un appui bref fait de même, un glisser ou un pincement non. Échap depuis le menu latéral
ou l'en-tête de l'application ne fait rien. iOS Safari : à vérifier à la main, non couvert par les tests.
À chaque sélection et désélection, le dessin reste à sa place : aucune étiquette « Sélection : … » ne s'affiche
au-dessus.
4. Références : remplacé par 4.10. Le bouton « Références » de l'en-tête n'existe plus ; les références ont leur
onglet, et le panneau latéral s'ouvre depuis un constat seulement (depuis le 2026-11-15 c'est un dialogue des
références : voir 4.13).
5. Dans « Annotations », la carte « Vues » propose « Gérer les vues », la carte « Catégories » « Modifier les
catégories », et une entrée « Régions vertébrales (n régions) » est toujours là. Chacun ouvre sa section pleine largeur avec
« Retour au dessin » en tête. Une saisie commencée dans une section reste là quand vous revenez au dessin puis
rouvrez la section.
6. Redimensionnez la fenêtre à 1 180 px de large. Attendu : le menu latéral de l'application disparaît dans
l'éditeur (il revient dès 1 280 px) et s'ouvre en un geste par « Ouvrir le menu » ; le dessin gagne la place
libérée. Sous 1 024 px l'éditeur passe en lecture seule (voir les limites) ; en dessous de 640 px, « Général » et
« Annotations » restent visibles et « Plus » ouvre les trois autres, dans l'ordre (depuis le 2026-11-15, voir 4.13).
### 4.10 Démonstration R2 : l'onglet Références
À dérouler sur la fiche de 4.9, qui porte au moins un constat citant une référence et une référence non citée
(ajoutez-la à l'étape 8 sinon). Libellés : `V1-2-6_R2_LABELS.md`. Rien dans ce parcours n'est lancé par Claude : la
pile d'essai et les vérifications sont les vôtres. Chaque étape donne l'action, puis l'attendu. Depuis le 2026-11-15, le
panneau latéral de ce parcours est un dialogue des références et « Plus » une liste verticale : 4.13 fait foi.
1. Onglets. Action : ouvrez la fiche à 1 280 px, puis réduisez la fenêtre sous 640 px. Attendu : cinq onglets
« Général », « Annotations », « Constats », « Références », « Vérification » ; sous 640 px « Général » et
« Annotations » restent visibles et « Plus » ouvre les autres, « Références » compris. Plus de bouton « Références » dans l'en-tête.
2. Tuiles. Action : ouvrez « Références ». Attendu : une tuile fermée montre la citation, son type et « Citée n
fois » (ou « Non citée »). Ouvrez-en une (clic, Entrée ou Espace sur l'en-tête) : DOI, URL, liste des citants
avec « Aller à », et pour un citant une pastille « famille » ou « ce constat ». « Modifier » passe la tuile en
modification (titre « Modifier la référence ») ; « Terminer » sort de la modification.
3. Citée ou non. Action : comparez une référence citée et une référence non citée, tuiles ouvertes. Attendu : la
citée n'a pas de « Supprimer » mais l'aide « Pour supprimer cette référence, retirez d'abord chacune de ses
citations… » ; la non citée offre « Supprimer ».
4. Recherche. Action : tapez un mot de la citation, puis un bout de DOI ou d'URL, puis un texte absent, puis
cliquez ✕ (« Effacer la recherche »). Attendu : le décompte devient « n références sur N » ; sans résultat,
« Aucune référence ne contient « … » » et « La recherche porte sur la citation, le DOI et l'URL. » avec le
bouton d'effacement ; ✕ vide le champ et rend le focus au champ.
5. Tris. Action : « Trier par » puis chacun de « Ordre de la fiche », « Citation (A → Z) », « Nombre de
citations », « Type ». Attendu : l'ordre des tuiles change à chaque choix, sans effet sur la fiche : si rien d'autre n'a changé,
« Enregistrer » reste inactif (le tri n'écrit pas dans le document), et revenir à « Ordre de la fiche » rend
l'ordre d'origine. Enregistrer après un tri, avec une autre modification, ne change pas l'ordre des références
côté serveur. « Monter » et « Descendre » n'existent que dans
« Ordre de la fiche » sans recherche ; sinon la ligne « Pour réorganiser, affichez l'ordre de la fiche sans
recherche. » les remplace.
6. Une tuile en modification pendant un tri ou une recherche. Action : modifiez une tuile, puis changez le tri
ou la recherche sans « Terminer ». Attendu : la tuile reste à sa place et ne disparaît pas de la liste.
7. Constat. Action : dans « Constats », sélectionnez un constat qui cite des références. Attendu : un bouton « n
référence(s) » apparaît ; une famille n'en a pas (elle garde sa liste en ligne et « Retirer »).
8. Ajouter. Action : « Ajouter une référence ». Attendu : une tuile d'ajout s'ouvre, le focus sur le champ
Citation ; type et citation sont obligatoires (« Type et citation obligatoires. »). Ajoutée, la référence se
place en fin d'ordre de la fiche, recherche et tri remis à zéro, la tuile ouverte. Point en
attente : voir l'étape 16 pour « Annuler l'ajout ».
9. Panneau. Action : cliquez « n référence(s) » du constat. Attendu : un panneau glisse depuis la droite (34 rem
au plus), le reste de la page est voilé et inerte, le focus va sur « Références citées ». Il liste les
références de ce constat dans l'ordre du constat, avec « Modifier », « Retirer de ce constat » et « Aller à »,
et la ligne « n références citées par ce constat ».
10. Retirer puis défaire. Action : « Retirer de ce constat » sur une tuile, puis « Défaire » (en haut, à droite de
la rangée d'onglets). Attendu : après le retrait, la citation quitte le panneau (la référence reste dans
l'onglet « Références »), le constat passe à « À confirmer » ; un seul « Défaire » rend la citation et le
statut ensemble. Retirez la dernière citation : le panneau reste ouvert avec « Ce constat ne cite plus aucune
référence. ».
11. « Tout afficher ». Action : « Tout afficher dans l'onglet Références ». Attendu : le panneau se ferme, l'onglet
« Références » s'ouvre, recherche et tri remis à zéro, les tuiles ouvertes restées ouvertes, le focus sur le
titre de l'onglet.
12. Fermetures. Action : rouvrez le panneau, puis fermez-le par Échap, par ✕ (« Fermer les références »), par un
clic sur le voile, par un clic sur un onglet. Attendu : Échap, ✕ et le voile rendent le focus au bouton « n
référence(s) » qui l'a ouvert ; un clic sur un onglet ouvre cet onglet, focus sur son bouton. Échap dans un
champ d'une tuile du panneau ne ferme pas le panneau ; ✕ valide alors la saisie. Une saisie refusée annule la
fermeture demandée : le panneau reste, le champ garde le focus et le message s'affiche.
13. Mouvement réduit. Action : activez la réduction des animations dans le système, rouvrez et fermez le panneau.
Attendu : plus de glissement, le panneau apparaît et disparaît d'un coup ; le focus se comporte pareil.
14. Téléphone. Action : fenêtre à 375 px (lecture seule sous 1 024 px). Attendu : « Plus » mène à « Références » ;
les tuiles gardent DOI, URL et « Aller à », sans « Modifier », « Supprimer », « Monter » ni « Descendre » ;
le panneau prend toute la largeur, sans dépasser l'écran. Passer sous 1 024 px avec le panneau ouvert le
laisse ouvert, en lecture.
15. Vérification. Action : dans « Vérification », cliquez « Aller à Références » sur une anomalie de référence.
Attendu : l'onglet « Références » s'ouvre sur la tuile, ouverte et focalisée. Aucun parcours de l'interface
connu ne fabrique cette anomalie (non vérifié) : ce cas n'est couvert que par les tests automatiques, passez
cette étape si Vérification n'en liste aucune.
16. Annuler l'ajout. Action : « Ajouter une référence », puis cliquez « Annuler l'ajout » sur la tuile d'ajout ;
recommencez, puis appuyez sur Échap depuis la tuile (un champ vierge, ou un bouton). Attendu : la tuile
disparaît, aucune référence n'est ajoutée, « Défaire » n'a pas changé d'état, le focus revient à « Ajouter une
référence ». Dans un champ déjà rempli, Échap n'annule pas l'ajout.
17. Passage en lecture seule avec une saisie refusée. Action : en modification d'une tuile, tapez une URL invalide
sans quitter le champ, puis réduisez la fenêtre sous 1 024 px. Attendu : la tuile reste affichée, une note dit
que la saisie n'a pas été conservée, rien n'est enregistré et « Défaire » n'a pas changé d'état.
18. Tuile hors recherche. Action : cherchez un mot, modifiez la tuile correspondante pour qu'elle ne le contienne
plus, puis « Terminer ». Attendu : la tuile reste, avec « Ne correspond pas à la recherche » sous son en-tête,
et sans « Aucun résultat ». Changez la recherche : la tuile disparaît de la liste.
19. Téléphone en paysage, au toucher. Action : appareil tenu en paysage (classe 667 × 375), faites défiler la page vers
le bas au doigt jusqu'à « Références citées » sous le constat, puis touchez ce bouton. Attendu : le panneau s'ouvre, son titre et ✕
sont visibles et touchables, sans que la page ait bougé.
### 4.11 Finition R2
À dérouler sur la fiche de 4.9 et 4.10, qui porte un constat A citant au moins deux références. Cette finition
remplace l'édition en ligne des tuiles et le panneau de 4.10 : là où 4.10 et 4.11 diffèrent, 4.11 fait foi (les étapes
9 et 10 de 4.10 ne tiennent plus : le volet ne retire plus de citation, voir les étapes 1 et 3 ci-dessous ; depuis le
2026-11-15 le volet est un dialogue des références, 4.13 fait foi là où il diffère). Libellés :
`V1-2-6_R2_LABELS.md` §5 à §7. Rien dans ce parcours n'est lancé par Claude. Chaque étape donne l'action, puis
l'attendu. Les étapes 1 à 11 se font à 1 280 px, les étapes 12 à 14 sur téléphone, sauf 14a (bureau ou tablette à 1 024 px ou plus).
1. Le parcours en huit temps. Action : onglet « Constats » ; ouvrez le constat A ; cliquez « 2 références » ; dans le
dialogue des références, cliquez « Tout afficher dans l'onglet Références » ; regardez l'onglet ; appuyez sur
Précédent du navigateur. Attendu : le dialogue des références s'ouvre au-dessus du constat ; l'onglet « Références » n'affiche que les deux
références du constat A, sous la pastille « Références du constat : A » avec son « × » ; Précédent ramène au constat
A, dialogue des références ouvert, dans l'état où vous l'aviez quitté. Un second Précédent ferme ce dialogue, un
troisième ferme le constat, sans quitter l'éditeur. Suivant refait le chemin. Le dialogue lit les références :
« Aller à » sur les tuiles, son propre « Modifier » (voir 4.13), pas de « Retirer de ce constat » ; la fiche du
constat n'offre ni « Citer » ni « Retirer ».
2. Ajouter un constat. Action : « Constats », bouton d'ajout, remplissez les noms, « Créer ». Attendu : la fiche du
nouvel élément s'ouvre en lecture dans la boîte de dialogue ; Précédent revient à l'arbre.
3. Modifier un constat. Action : ouvrez un constat, « Modifier », changez un nom et une description. Attendu : le
formulaire ne montre que « Références citées » et « X références », sans liste, sans « Citer » ni « Retirer » (les
citations se modifient dans le dialogue des références, voir 4.13) ; rien n'est écrit tant que vous n'avez pas
cliqué « Enregistrer » ; « Défaire » (en haut) est hors d'atteinte pendant que la boîte est ouverte.
4. Annuler avec une modification. Action : même formulaire, changez un champ, cliquez « Annuler » (puis refaites avec
Échap, puis avec Précédent). Attendu : « Abandonner les modifications ? » avec « Continuer la saisie » (focalisé)
et « Abandonner » ; « Continuer la saisie » garde votre texte ; « Abandonner » revient à la lecture sans rien
écrire. Sans modification, « Annuler » revient directement.
5. Enregistrer puis défaire. Action : changez deux champs, « Enregistrer », fermez la boîte, cliquez « Défaire ».
Attendu : « Modifications enregistrées » après l'enregistrement ; un seul « Défaire » rend les deux champs
ensemble (une opération par enregistrement ; celui du constat ne touche pas aux citations) ; « Refaire » les remet.
6. Ajouter une référence. Action : onglet « Références », « Ajouter une référence », type et citation, « Ajouter la
référence ». Attendu : une boîte de dialogue ; un champ obligatoire vide est refusé sur le champ ; une adresse hors
http(s) aussi ; la liste ne bouge pas, recherche et tri restent tels quels ; la ligne « Référence ajoutée : … »
apparaît avec « Afficher », qui efface la recherche, ouvre la nouvelle tuile et y place le focus.
7. Modifier une référence. Action : ouvrez une tuile, « Modifier », changez la citation, « Enregistrer ». Attendu :
les tuiles sont en lecture seule (disclosure, « Modifier », « Supprimer » ou l'aide d'une référence citée) ; après
l'enregistrement la tuile garde sa place dans la liste, avec recherche, tri et tuiles ouvertes inchangés.
8. Le filtre. Action : refaites le chemin de l'étape 1 jusqu'à l'onglet filtré, tapez dans la recherche, changez le
tri, cliquez le « × » de la pastille. Attendu : recherche et tri restent utilisables dans le filtre ; « × » rend
toutes les références ; « Revenir au constat » rouvre le constat A tant que le filtre est posé.
9. Recharger. Action : sur l'onglet filtré, rechargez la page (F5). Attendu : l'onglet et la pastille sont gardés ; ni
formulaire ouvert ni texte de recherche ; Précédent ramène alors au dialogue des références.
10. Historique et comptes. Action : ouvrez le constat A, changez de fiche (ou déconnectez-vous puis connectez un autre
compte), puis appuyez sur Précédent. Attendu : aucune boîte ni aucun filtre d'une autre fiche ou d'un autre
compte ne revient : l'historique repart de zéro. L'historique ne porte plus l'identifiant du compte, seulement une
étiquette de session aléatoire.
11. Menu latéral. Action : à 1 280 px, défilez une page longue (Constats avec beaucoup de lignes). Attendu : le menu de
gauche reste en place ; fenêtre basse (500 px), il défile seul sans dépasser.
12. « Plus » sur téléphone. Action : sous 640 px, touchez « Plus ». Attendu : une liste verticale (Constats,
Références, Vérification, voir 4.13) se déroule sous la rangée d'onglets sur toute la largeur, sans rien décaler,
avec un fondu léger ; choisir une entrée la ferme, ouvre
l'onglet et met le focus sur le panneau de cet onglet (au clavier comme au toucher).
13. Fermer « Plus ». Action : ouvrez « Plus », puis (a) touchez hors du menu, (b) rouvrez et utilisez le geste ou le
bouton Retour d'Android. Attendu : (a) le menu se ferme et la page ne reçoit pas ce toucher ; (b) Retour ferme le
menu d'abord, sans changer de page ; un second Retour agit comme d'habitude. Point non prouvé sur appareil : voir
les limites.
14. Suppression sur bureau ou tablette, limites sur téléphone. Action : (a) suppression, sur un bureau ou une tablette
d'au moins 1 024 px (l'édition ne s'ouvre pas en dessous) : supprimez un constat depuis son dialogue, puis
appuyez une fois sur Retour ; sur un autre constat supprimé, cliquez « Défaire » ; (b) limite 5 : avec « Plus » ouvert, si Retour ne le ferme pas, notez le navigateur et sa version ;
(c) limite 4 : « Plus » ouvert, touchez un bouton de la page. Attendu : (a) Retour agit dès la première fois (plus de Retour sans effet) ;
« Défaire » rend le constat d'un coup : « Constats » s'ouvre, la ligne est sélectionnée et focalisée ; (b) un navigateur sans `CloseWatcher` laisse Retour naviguer, Échap et le toucher
extérieur ferment quand même ; (c) le toucher ne ferme que le menu, il faut le renouveler pour agir sur le
bouton. Dites si l'un de ces trois comportements vous gêne.
### 4.12 Vérifications manuelles finales R2
À faire une fois, sur la pile d'essai, avant de clore R2. Ces points échappent aux tests automatiques. Chaque
vérification donne l'action, puis l'attendu.
1. Retour d'Android avec « Plus » ouvert. Action : sur un vrai téléphone Android (Chrome), ouvrez l'éditeur, touchez
« Plus », puis le geste ou le bouton Retour. Attendu : le menu se ferme, la page reste ; un second Retour agit comme
d'habitude. Si le menu ne se ferme pas, notez le navigateur et sa version.
2. Confirmation de départ sur ordinateur. Action : sur le constat A, « Modifier », tapez dans un champ sans
enregistrer, puis quittez l'éditeur par un appui long sur Retour (menu de l'historique) et un saut de plusieurs
entrées vers la fiche ou la liste ; faites-le sur Chrome ou Edge de bureau (l'édition demande 1 024 px, un
téléphone n'a pas ce menu). Attendu : le saut est annulé, la
question « Abandonner les modifications ? » s'affiche ; « Continuer la saisie » garde le texte et la page ;
« Abandonner » quitte la page et, au retour sur la fiche, aucun avis ne s'affiche. Avec une référence modifiée
au-dessus d'un constat modifié, deux questions se suivent.
3. Même saut dans tout autre navigateur de bureau que vous utilisez (Firefox, Safari). Attendu : soit la question de la vérification 2 (le
navigateur sait annuler le saut), soit un départ sans question puis, au retour sur la fiche, l'avis « Une saisie
non enregistrée a été abandonnée en quittant l'éditeur » une fois. Jamais une perte sans l'un ou l'autre. Dites
lequel vous observez : ces navigateurs ne sont pas vérifiés.
4. Citer et retirer en modification. Action : sur le constat A, « X références », « Modifier » du dialogue, retirez
une référence et citez-en une autre, « Enregistrer », fermez, puis un seul « Défaire ». Attendu : après
« Défaire », les citations d'avant reviennent ensemble ; en lecture, rien ne permet de citer ni de retirer ; la
fiche du constat ne porte aucun contrôle de citation (voir 4.13).
5. Suppression puis « Défaire ». Action : supprimez un constat depuis son dialogue, puis un seul « Défaire ». Attendu :
« Constats » s'ouvre avec le constat rendu, sa ligne sélectionnée et focalisée.
6. « Plus » au clavier sur tablette ou sur bureau à largeur étroite. Action : sous 640 px, Tab jusqu'à « Plus »,
Entrée, Tab jusqu'à « Références », Entrée. Attendu : l'onglet s'ouvre et le focus est sur son panneau, avec un
anneau visible ; Échap depuis la liste rend le focus à « Plus ».
7. Autre compte dans le même onglet. Action : sur le constat A, déconnectez-vous, connectez un autre compte, ouvrez
la même fiche, puis Précédent plusieurs fois. Attendu : rien du premier compte ne revient (ni boîte, ni filtre, ni
avis de saisie abandonnée).
8. Rechargement sur l'adresse du réseau local. Action : ouvert depuis l'adresse http du réseau local, ouvrez l'onglet
« Références » avec un filtre de constat, puis rechargez (F5). Attendu : l'onglet et le filtre sont gardés.
9. Déconnexion avec une saisie ouverte. Action : sur le constat A, « Modifier », tapez sans enregistrer, puis
déconnectez-vous depuis un autre onglet (ou attendez la fin de session). Reconnectez le même compte dans cet
onglet et rouvrez la fiche. Attendu : l'avis « Une saisie non enregistrée a été abandonnée en quittant l'éditeur »
une fois, jamais le texte tapé ; rouvrir encore la fiche ne le montre plus.
### 4.13 Vérification des deux ajustements (2026-11-15)
À faire sur la pile d'essai (`db:trial`), sur la fiche de 4.11 : un constat A qui cite au moins deux références, une
famille (catégorie) de « Constats ». Libellés : `V1-2-6_R2_LABELS.md` §10. Les étapes 1 à 8 se font à 1 280 px (la
modification demande 1 024 px), l'étape 9 sur téléphone ou fenêtre sous 640 px. Rien dans ce parcours n'est lancé par
Claude. Chaque étape donne l'action, puis l'attendu.
1. Dialogue en lecture. Action : ouvrez le constat A, cliquez « 2 références ». Attendu : un dialogue « Références du
constat » s'ouvre au-dessus du constat (plus de volet à droite) ; les références se lisent en tuiles, avec
« Aller à », « Tout afficher dans l'onglet Références » et son propre « Modifier » ; aucun « Retirer ».
2. Fermer. Action : fermez par ✕, puis rouvrez et fermez par Échap. Attendu : retour au constat A, focus sur
« 2 références ».
3. « Modifier » du constat. Action : « Modifier » dans le constat A. Attendu : le formulaire ne montre que « Références
citées » et « X références », sans liste de références, sans « Citer » ni « Retirer » ; « Enregistrer » n'y change
pas les citations.
4. Modifier les références. Action : « 2 références », puis « Modifier » du dialogue ; choisissez une référence
existante dans la liste, cliquez « Citer » (le choix seul ne cite rien), retirez-en une (« Retirer »),
« Enregistrer ». Attendu : retour en lecture avec
« Modifications enregistrées » et le focus sur « Modifier » ; après avoir fermé les dialogues, un seul « Défaire »
rend les citations d'avant ; « Refaire » les remet.
5. « Nouvelle référence » et « Modifier la référence ». Action : « Modifier », « Nouvelle référence », renseignez,
« Ajouter la référence » ; puis « Modifier la référence » sur une rangée, changez la citation, « Enregistrer » dans ce dialogue.
Attendu : la référence créée est citée dans le brouillon, rien n'est écrit dans le document tant que vous n'avez
pas cliqué « Enregistrer » du dialogue des références ; le dialogue de la référence s'ouvre au-dessus, et une fois
fermé le brouillon est là. Si vous abandonnez après avoir créé une référence, la bibliothèque est inchangée : rien
dans l'onglet Références, rien à défaire (limite 13 de §5, vérifiée au §4.14).
6. Annuler. Action : dans la modification, changez une citation, « Annuler » (puis refaites avec ✕ et Échap).
Attendu : « Abandonner les modifications ? » avec « Continuer la saisie » (focalisé) ; « Abandonner » n'écrit
rien. Sans modification, « Annuler » revient directement à la lecture.
7. Précédent. Action : avec une citation modifiée et non enregistrée, appuyez sur Précédent du navigateur. Attendu :
la même question ; « Continuer la saisie » garde le brouillon.
8. Une famille. Action : dans « Constats », ouvrez une famille, cliquez « X références » (même à 0), refaites les
étapes 1 à 7. Attendu : le même dialogue, les mêmes comportements ; une famille sans référence ouvre le dialogue
avec « Cette famille ne cite aucune référence. » (titres et libellés en « famille », voir 4.14).
9. Téléphone (ou fenêtre sous 640 px). Action : ouvrez l'éditeur, regardez la rangée d'onglets, touchez « Plus ».
Attendu : « Général » et « Annotations » sont visibles, puis « Plus » ; la liste est verticale, dans l'ordre
Constats, Références, Vérification, chaque rangée d'au moins 48 px, l'entrée active teintée avec une coche ; tant
que Vérification est dans « Plus », le nombre d'erreurs bloquantes s'affiche sur « Plus » ; choisir une entrée ferme
la liste et ouvre l'onglet ; le Retour d'Android (ou Échap, ou un toucher hors de la liste) la ferme. Sous 1 024 px
le dialogue des références reste en lecture, sans « Modifier ».
### 4.14 Vérifications avant clôture (2026-11-15)
À faire sur la fiche de 4.13, à 1 280 px sauf la dernière. Libellés : `V1-2-6_R2_LABELS.md` §11. Chaque vérification
donne l'action, puis l'attendu.
1. Flèches sur la liste. Action : constat A, « 2 références », « Modifier » ; sur la liste des références, appuyez
sur la flèche bas, puis fermez par ✕. Attendu : la flèche choisit seulement ; ✕ ferme sans rien demander. « Citer »
ajoute la référence choisie à la liste.
2. Choix non cité. Action : choisissez une référence sans cliquer « Citer », puis « Enregistrer ». Attendu : refus, le
formulaire reste ouvert, une ligne « Référence choisie mais pas encore citée… » sous la liste, le focus sur « Citer ».
3. Création abandonnée. Action : « Nouvelle référence », renseignez, « Ajouter la référence », puis « Annuler » et
« Abandonner ». Attendu : la référence n'est pas dans l'onglet Références, et le
dernier « Défaire » disponible porte sur ce que vous aviez fait avant.
4. Création enregistrée. Action : même création, puis « Enregistrer ». Attendu : la référence et la citation
existent ; un seul « Défaire » retire les deux.
5. Une famille. Action : ouvrez une famille, « X références ». Attendu : « Références de la famille », et
« Cette famille ne cite aucune référence. » à zéro ; avec « Tout afficher », la pastille « Références de la famille ».
6. Le ✕. Action : sur un téléphone, ouvrez un dialogue au titre long (constat à long nom) et touchez ✕. Attendu : ✕
se touche sans viser, il reste dans l'écran. Passez l'application en anglais si vous voulez relire les libellés
(« Cite », « References of the family »).
**Résultat (2026-11-15)** : vérifications 4.13 et 4.14 faites par le propriétaire sur `db:trial`, toutes conformes.
R2 est validé (fonctionnel et graphique) et clos. Les deux choix proposés sont ratifiés : « Modifier la référence »
sur une référence enregistrée garde son propre « Défaire », et une référence nouvelle non enregistrée est perdue si
le navigateur est fermé brutalement, comme tout formulaire non enregistré (limites 13 et 14 ci-dessous).
### 4.15 Démonstration R3 : la liste des fiches officielles et l'accueil Administration
À faire sur la pile d'essai (`db:trial`), dans l'application d'essai `http://<host>:5194`, avec le compte praticien
d'essai (rôle `admin` et habilitation `sheet_editor`), double authentification faite. Libellés :
`docs/design/v1-2-6-r0/REVUE.md:82-84`. Les étapes 1 à 9 se font à 1 280 px, les étapes 10 et 11 sur un téléphone ou dans une
fenêtre de 375 px. Chaque étape donne l'action, puis l'attendu.
La pile d'essai contient aujourd'hui deux fiches officielles : la fiche historique `faunosteo-cheval` (badge
« Fiche historique ») et sa copie de travail (badge « Copie de travail »). Les étapes 1 à 8 se font avec ces deux
fiches. L'étape 9 demande d'autres fiches, que vous créez par « Nouvelle fiche » (comme en 4.1). Ces fiches restent
ensuite sur la pile d'essai : c'est à vous de décider si vous les créez.
1. La liste. Action : Administration, puis le lien en bas de la carte « Fiches officielles ». Attendu : la page
« Fiches officielles » montre le champ « Rechercher une fiche par son nom », sans loupe, et « Trier par » réglé
sur « Dernière modification » ; puis les quatre filtres habituels, la ligne « 2 fiches » et les deux rangées.
Chaque rangée donne le nom, les badges, la ligne de détail (espèce, état, version publiée ou « aucune version
publiée », brouillon) et, à droite, « Modifiée le … » au format « 9 nov. 2026, 12:06 », en heure de Paris. Notez
l'ordre des deux fiches et leurs dates.
2. Recherche. Action : tapez une partie du nom d'une fiche en minuscules et sans accent, puis une partie de son nom
anglais. Attendu : la liste suit chaque frappe, sans bouton à valider ; le nom français et le nom anglais trouvent
tous deux la fiche, accents et majuscules ignorés. Le décompte devient « 1 fiche sur 2 » si une seule fiche
correspond, et reste « 2 fiches » si les deux correspondent. À sa création, la copie de travail reprend le nom de
la fiche historique : si leurs noms sont encore identiques, la recherche les garde toutes les deux.
3. Effacer. Action : avec du texte dans le champ, cliquez ✕ (« Effacer la recherche »). Retapez un texte et appuyez
sur Échap. Appuyez encore une fois sur Échap, le champ vide. Attendu : ✕ n'apparaît que lorsque le champ contient
du texte. ✕ et Échap vident le champ, rendent « 2 fiches » et laissent le focus dans le champ. Échap sur un champ
vide ne fait rien.
4. Les deux tris. Action : « Trier par », choisissez « Nom », puis revenez à « Dernière modification ». Attendu :
« Nom » range les fiches dans l'ordre alphabétique du nom affiché, en français dans l'interface française. Deux
noms identiques gardent le même ordre d'un affichage à l'autre. « Dernière modification » met en haut la fiche
modifiée le plus récemment. Trier ne modifie aucune fiche : les dates ne bougent pas.
5. Un brouillon enregistré date sa fiche. Action : dans la liste, cliquez la rangée de la copie de travail. Sur la
page de la fiche, cliquez « Ouvrir le brouillon ». Faites une petite modification (par exemple dans l'onglet
« Général ») et cliquez « Enregistrer ». Revenez à la liste, triée par « Dernière modification ». Attendu : la
copie de travail est en première position. Sa date « Modifiée le … » est l'heure de votre enregistrement, en
heure de Paris.
6. Recherche sans résultat. Action : sans filtre, tapez un texte qu'aucun nom ne contient, par exemple « zzz ».
Puis collez un long texte sans espace : le champ s'arrête à 100 caractères. Cliquez enfin « Effacer la
recherche » sous la phrase. Attendu : la ligne « 0 fiche sur 2 », puis un bloc « Aucune fiche ne contient « zzz »
dans son nom. » avec le bouton « Effacer la recherche ». Le texte s'affiche sans ses espaces de début et de
fin. Un texte long passe à la ligne, sans défilement horizontal. Le bouton vide le champ, rend « 2 fiches » et
le focus au champ. La planche 28 dessine une icône d'information dans ce bloc ; elle n'y est pas (écart à
confirmer, voir `docs/design/README.md`).
7. Recherche et filtre. Action : tapez une partie d'un nom présent, puis choisissez « État de la fiche » :
« Archivée ». Remettez « Tous », puis choisissez « Statut de version » : « Brouillon ». Attendu : les filtres
s'ajoutent à la recherche. Si aucune fiche trouvée n'est archivée, « Archivée » affiche « Aucune fiche ne
correspond à ces filtres. » et la ligne « 0 fiche sur 2 », sans le bloc de l'étape 6. Avec « Brouillon », il reste
les fiches qui portent un brouillon et dont le nom contient le texte, et le décompte suit. Remettez « Tous » à la
fin.
8. La carte de l'accueil. Action : ouvrez Administration. Attendu : la carte « Fiches officielles » montre
« Brouillons, revues, versions. », le sous-titre « Dernières modifications », puis les deux fiches dans l'ordre de
la liste triée par « Dernière modification », chacune avec son nom en lien, ses badges, sa ligne de détail et sa
date. Le nom ouvre la page de la fiche. En bas, « Voir les 2 fiches » ouvre la liste. Tant qu'elle figure dans la
carte, la fiche historique garde sous sa ligne l'action « Créer une copie de travail ». Sa copie existe déjà : le
bouton est donc inactif, avec la phrase « Une copie de travail active existe déjà (une seule à la fois). ».
9. Avec plus de fiches (facultatif, crée des données sur la pile d'essai). Action : créez quatre fiches par « Nouvelle
fiche » (espèce, « Nom (français) », « Nom (anglais) », identifiant, comme en 4.1), avec des noms qui commencent
par des lettres différentes. La création ouvre le brouillon : revenez ensuite à Administration. Attendu : six
fiches en tout. La carte n'en montre que cinq, les plus récemment modifiées, et son lien devient « Voir les 6
fiches ». Dans la liste, « Nom » range les six par ordre alphabétique, et la recherche d'une seule d'entre elles
donne « 1 fiche sur 6 ». Si la fiche historique est la plus ancienne des six (c'est le cas si vous ne l'avez pas
modifiée pendant cet essai), elle sort des cinq : son action « Créer une copie de travail » n'est plus sur la
carte et reste sur la page de la fiche historique, que vous ouvrez depuis la liste. C'est le comportement validé
(planche 29, arbitrage A9). Le libellé « Toutes les fiches officielles », prévu pour zéro ou une fiche, ne se voit
pas sur cette pile, qui en compte au moins deux. Dernière action : dans la liste triée par « Dernière
modification », les quatre fiches créées sont au-dessus de la copie de travail. Ouvrez de nouveau son brouillon
(sa rangée, puis « Ouvrir le brouillon »), faites une autre petite modification et cliquez « Enregistrer ».
Revenez à la liste. Attendu : la copie de travail repasse en première position, devant les quatre fiches
créées.
10. Téléphone (375 px). Action : sur un téléphone, ou dans une fenêtre de 375 px, reprenez les étapes 1 à 4, 6 et
8. Attendu : le champ de recherche et « Trier par » sont empilés sur toute la largeur, puis le bouton « Filtres »
(les quatre filtres sont repliés, étape 11), et chaque contrôle fait au moins 44 px de haut. La date passe sur
sa propre ligne, sous la ligne de détail. Aucun défilement horizontal, même avec le long texte de l'étape 6. La
carte de l'accueil se lit en entier. L'étape 5 se fait sur ordinateur : la modification d'un brouillon demande
1 024 px.
11. Filtres repliables (375 px). Action : sur un téléphone, ou dans une fenêtre de 375 px, ouvrez la liste des
fiches. Attendu : seuls le champ de recherche, « Trier par » et le bouton « Filtres » sont visibles ; les quatre
filtres sont cachés. Touchez « Filtres » : le panneau s'ouvre en glissant et montre les quatre filtres l'un
sous l'autre. Choisissez « Statut de version » : « Brouillon », puis « État de la fiche » : « Active ». La liste
suit tout de suite et le bouton devient « Filtres (2) ». Touchez le bouton pour fermer : le panneau se replie,
le bouton garde « Filtres (2) » et la liste reste filtrée. Rouvrez : les deux choix sont toujours là. Touchez
« Réinitialiser les filtres » (visible seulement tant qu'un filtre est actif, dans le panneau) : les filtres
reviennent à « Tous », le bouton redevient « Filtres » et le focus est sur lui. La recherche tapée avant n'est
pas touchée. Panneau fermé, la touche Tab ne passe pas dans les filtres. Si votre téléphone réduit les
animations (réglage d'accessibilité), le panneau s'ouvre et se ferme sans mouvement. À 1 280 px, rien ne change :
les quatre filtres restent affichés, sans bouton « Filtres » ni « Réinitialiser les filtres ».
Passez l'application en anglais si vous voulez relire les libellés (« Search a sheet by name », « Sort by »,
« Modified on 9 Nov 2026, 12:06 », « See the 2 sheets »). En anglais, « Nom » range par le nom anglais.
Résultat du 16 novembre 2026 : essai fait par le propriétaire sur db:trial, panneau des filtres sur
téléphone compris. R3 est validé. « Réinitialiser les filtres » reste uniquement dans le panneau.
### 4.16 Démonstration R4 : les erreurs dans les cartes du catalogue
À faire sur la sandbox, avec `pnpm db:sandbox trial` (décision D3), pas sur `db:trial` : la pile d'essai n'a aucune
version publiée, son catalogue est vide. Planche 30 (`docs/design/v1-2-6-r0/30-catalogue-carte-integrite.png`),
libellé A10.
Préparation. La sandbox tourne déjà et garde les données des tests automatiques : ne lancez ni `up fresh` (refusé tant
qu'elle tourne) ni `down` (tout serait effacé). Créez votre compte comme à l'étape 2 si vous n'en avez pas sur cette
sandbox, puis donnez-lui le droit de lecture du catalogue :
```bash
pnpm db:sandbox trial-grant vous@example.com catalog_reader
```
Lancez l'application comme à l'étape 3 (`pnpm db:sandbox trial`, adresse en `:5193`) et connectez-vous. La double
authentification n'est pas nécessaire pour le catalogue. Ouvrez « Fiches anatomiques » dans le menu. La page est
lente à se remplir : la sandbox comptait 164 fiches au catalogue lors du relevé (172 à la clôture de R4, les
tests du catalogue en ajoutent à chaque passage) et chaque carte charge sa version et son illustration
au moment où elle s'affiche.
Ce qui vient des données, pas de R4. Un relevé en lecture seule du 17 novembre 2026 a passé les 164 fiches du
catalogue au contrôle d'intégrité du moteur, comme le fait la carte. 160 passent et dessinent leur vue principale
(80 « Cheval publié … » et 80 « Cheval refusé … », laissées par les tests du catalogue). Quatre échouent, toutes du
même genre : les quatre fiches nommées « Cheval sandbox » (deux en version 1, deux en version 2). Leur empreinte
enregistrée est une valeur fictive (`aaaa…`), écrite par des tests qui imitent le service de vérification : le
moteur recalcule l'empreinte, elle ne correspond pas, la version est refusée. C'est l'anomalie de test A. Elle existait
avant R4, elle est suivie à part, et R4 ne la corrige pas : R4 change seulement la façon dont l'échec s'affiche. Avant
R4, ces quatre cartes se taisaient (nom, version et « Consulter », sans compteurs ni explication). Aucune autre fiche
ne devrait échouer ; si une autre carte montre une ligne d'erreur, notez son nom et son message.
Ce qui est propre à R4 : la ligne dans la carte, ce qui reste autour d'elle, et « Réessayer ». Chaque étape donne
l'action, puis l'attendu. Étapes 1 à 5 à 1 280 px, étape 6 sur un téléphone ou dans une fenêtre de 375 px.
1. Avant de chercher, notez le nom d'une carte saine, une carte « Cheval publié … » qui montre ses compteurs (vues,
zones de constats) et une vignette. Elle sert à l'étape 4.
2. Ligne d'intégrité. Action : tapez « sandbox » dans « Rechercher une fiche ». Attendu : exactement quatre cartes
« Cheval sandbox ». Chacune garde l'espèce, « Publiée », son nom et « Version 1 » ou « Version 2 », sans date de
publication (la date vient avec les détails qui n'ont pas pu être lus). À la place des compteurs et de la
vignette, une ligne rouge avec un triangle d'alerte, en gras : « Contrôle d'intégrité échoué : cette version ne
peut pas être affichée. » Pas de « Réessayer » : relancer ne changerait rien à la version. « Consulter » reste
en bas de la carte et répond à la souris comme au clavier (Tab puis Entrée).
3. La page de la fiche, inchangée. Action : « Consulter » sur une des quatre cartes. Attendu : la page de la fiche,
telle qu'avant R4, avec son message détaillé « L'empreinte de cette version ne correspond pas à celle enregistrée à
sa publication. » et son propre bouton « Réessayer » (la page propose de réessayer pour toute erreur, R4 n'y
touche pas). Revenez au catalogue (la recherche n'est pas gardée au retour, comportement connu).
4. Ligne réseau et « Réessayer ». Une carte ne charge sa version qu'au moment où elle s'affiche : couper le réseau
après coup ne change rien aux cartes déjà là. Il faut donc la faire disparaître puis réapparaître hors ligne.
Action : tapez « sandbox » (la carte saine de l'étape 1 disparaît). Ouvrez les outils de développement (F12),
onglet « Network » (« Réseau »), réglez « No throttling » sur « Offline ». Remplacez « sandbox » par le nom noté
à l'étape 1. Attendez environ 7 secondes : la lecture de la date est retentée trois fois avant d'abandonner, et la
carte attend la fin de ces essais. Attendu : la carte saine montre une ligne ambrée avec l'icône « pas de réseau »
et « Connexion au serveur impossible. Vérifiez votre réseau. », puis « Réessayer » et « Consulter » côte à côte
(à 1 280 px aussi). Remettez
« No throttling » (en ligne), puis cliquez « Réessayer ». Attendu : pendant l'essai, la ligne et le bouton restent
en place, le bouton grisé ; puis la ligne disparaît, les compteurs et la vignette apparaissent, et le focus passe
sur « Consulter » de cette carte. Si vous cliquez « Réessayer » encore hors ligne, la ligne ne disparaît pas : rien
ne change pendant environ 7 secondes (le bouton est grisé), puis le bouton redevient normal et le focus reste sur
« Réessayer ».
5. Anglais. Action : passez l'interface en « EN » et refaites l'étape 2. Attendu : « Integrity check failed: this
version cannot be displayed. »
6. Téléphone (375 px). Action : refaites les étapes 2 et 4 à 375 px (sur un téléphone, l'étape 4 demande les outils
de développement d'un ordinateur : utilisez une fenêtre de 375 px ou le mode appareil des outils). Attendu : une
carte par ligne, la phrase passe à la ligne, « Réessayer » et « Consulter » font au moins 44 px de haut, aucun
défilement horizontal.
L'écart relevé par la revue graphique (à 1 280 px, la carte réseau empilait « Réessayer » au-dessus de
« Consulter ») est corrigé : les deux boutons sont côte à côte, comme sur la planche 30 (`docs/design/README.md`).
Limites connues de R4 :
- Si le moteur lui-même ne se charge pas, chaque carte affiche sa ligne « moteur » avec son propre « Réessayer » ; un
clic relance le moteur et recharge cette carte seulement, les autres attendent leur propre clic.
- Une date de publication qui n'a pas pu être lue manque sans message.
- Une version saine dont la vue principale ne peut pas être dessinée garde ses compteurs et affiche la phrase neutre
déjà utilisée par la page de la fiche (« Cette vue ne peut pas être affichée : … »). La sandbox n'a pas de cas de ce
genre aujourd'hui (relevé ci-dessus).
- Les fiches « R4 … » créées par le test automatique sont archivées à la fin de chaque passage : elles ne sont plus au
catalogue, mais restent dans la liste d'administration sous « Archivée ».
Résultat du 17 novembre 2026 : essai fait par le propriétaire sur la sandbox (`pnpm db:sandbox trial`), avec un
compte créé pour l'occasion et le seul droit `catalog_reader`. Toutes les étapes fonctionnent. R4 est validé.
L'archivage des fiches de test est confirmé, et les règles sur les fiches ayant eu une version publiée ne changent pas.
### 4.17 Démonstration U2 : modifier les annotations directement sur le dessin
À faire sur la pile d'essai (`db:trial`), dans l'application d'essai `http://<host>:5194`, avec le compte praticien
d'essai (rôle `admin` et habilitation `sheet_editor`), double authentification faite. Planches :
`docs/design/v1-2-6-u2/` (arbitrages A1 à A15). U2 n'ajoute aucune migration : la pile garde ses données, l'application
sert le code de cette branche. Claude n'écrit rien sur la pile d'essai : vous lancez vous-même les commandes.
Préparation. Une commande à la fois, depuis la racine du worktree :
```bash
pnpm db:trial status
pnpm db:trial start
pnpm db:trial app
```
`status` ne modifie rien. Lisez deux lignes de sa sortie avant de continuer :
- sous « migrations », la ligne « applied files unchanged; new: … » doit finir par « none ». Si elle nomme un fichier,
lancez `pnpm db:trial migrate` (il fait d'abord une sauvegarde, puis applique les nouvelles migrations de la
branche) ;
- « drawings uploaded and confirmed: n/n » doit montrer deux nombres égaux. Sinon, lancez `pnpm db:trial assets`
(il envoie les dessins équins par la passerelle de la pile, puis les vérifie).
Si `status` dit « database stopped », `start` relance les mêmes conteneurs, données gardées. `app` affiche l'adresse
(« trial app: http://… ») ; Ctrl+C l'arrête, la pile continue de tourner.
La fiche. Ouvrez la copie de travail de la fiche équine (Administration, « Fiches officielles », sa rangée, puis
« Ouvrir le brouillon »), onglet « Annotations », vue principale. Chaque geste ci-dessous modifie le brouillon. Pour
garder la copie telle qu'elle est, défaites chaque geste comme demandé et ne cliquez pas, à la fin, le bouton
« Enregistrer » de l'éditeur (celui qui enregistre le brouillon) : quitter l'éditeur vous demandera alors
confirmation, c'est attendu. Le bouton « Enregistrer » de la boîte des propriétés (étape 8) ne fait que modifier le
brouillon ouvert, comme un geste sur le dessin.
Chaque étape donne l'action, puis l'attendu. Pendant tout l'essai, une règle vaut pour chaque étape : quand un
message apparaît ou disparaît sous le dessin, ni le dessin ni la bande au-dessus ne bougent, même d'un pixel. Notez
toute étape où quelque chose saute.
Souris, à 1 280 px :
1. Déplacer un point. Action : dans la liste « Annotations de la vue », cliquez une rangée de type point, puis
glissez le point sur le dessin. Attendu : le point suit la souris et se pose au relâchement ; sous le dessin,
« Point déplacé · Défaire ». Cliquez « Défaire » dans ce message : le point revient. Refaites le déplacement par
« Déplacer le point » dans la bande : les flèches à l'écran (ou celles du clavier) le déplacent, l'ancienne place
reste en pointillé gris, « Valider la position » enregistre, « Annuler » rend la place d'origine. Défaites.
2. Changer sa taille. Action : le point toujours sélectionné, faites glisser le curseur « Taille » de la bande, puis
relâchez. Attendu : un seul message « Taille modifiée · Défaire » au relâchement, quel que soit le nombre de
crans parcourus. Défaites.
3. Sélectionner « Vertèbres thoraciques ». Action : cliquez sa rangée dans la liste. Attendu : la zone montre ses
sommets ; au zoom d'ajustement, la bande affiche « Zoomez pour ajouter un sommet sur les segments courts. » et
certains « + » manquent. Zoomez (molette ou boutons de zoom) jusqu'à voir un « + » au milieu de chaque segment.
4. Glisser un sommet. Action : glissez un sommet de la zone. Attendu : « Sommet déplacé · Défaire », le sommet est
« choisi » (la bande dit « sommet n choisi »). Défaites.
5. Ajouter puis retirer un sommet. Action : cliquez un « + ». Attendu : « Sommet ajouté », le nouveau sommet est
choisi et un « − » apparaît à côté de lui. Cliquez ce « − ». Attendu : « Sommet retiré ». Défaites les deux
gestes, un par un.
6. Déplacer la zone. Action : glissez l'intérieur de la zone, puis refaites-le par « Déplacer la zone » dans la bande
(flèches, puis « Valider la position »). Attendu : la zone bouge d'un bloc, « Zone déplacée · Défaire ».
Défaites.
7. Redessiner puis annuler. Action : « Redessiner », posez trois ou quatre sommets sur le dessin, puis « Annuler le
tracé ». Attendu : la zone garde sa forme d'origine, rien n'entre dans l'historique (« Défaire » de l'en-tête ne
change rien de plus).
8. Les propriétés. Action : « Propriétés » dans la bande, ou un double clic sur la zone sélectionnée. Attendu : la
boîte s'ouvre au-dessus de la colonne de droite, jamais sur le dessin. Un clic sur le voile gris ne la ferme pas.
« Modifier », changez le nom anglais, « Enregistrer » en bas de la boîte. Attendu : « Modifications
enregistrées ». Fermez, puis
« Défaire » dans l'en-tête : l'ancien nom revient.
9. Créer un point et une zone. Action : outil « Point », cliquez dans le dessin. Attendu : « Point placé » et la boîte
de création ; « Replacer le point » vous rend la main sur le dessin. Remplissez les noms, « Créer » : « Point
créé ». Puis outil « Zone » : posez des sommets, fermez sur le premier sommet ou par « Fermer le tracé ». Attendu :
« Zone tracée, n sommets » et la boîte ; essayez « Reprendre le tracé » (voir les choix à juger), puis « Créer » :
« Zone créée ». Pendant la création, « Défaire » est caché du message et inactif dans l'en-tête.
10. Tout défaire. Action : « Défaire » dans l'en-tête, autant de fois que nécessaire. Attendu : chaque clic défait
un geste entier (un glisser, un « + », une création), dans l'ordre inverse, jusqu'à la fiche telle qu'ouverte.
11. Quitter un mode commencé. Action : « Déplacer la zone », un appui sur une flèche, puis cliquez l'onglet
« Constats ». Attendu : « Abandonner le déplacement ? » avec « Continuer » et « Abandonner ». Refaites avec le
bouton Retour du navigateur : même question. Puis « Redessiner », un sommet posé, onglet puis Retour : « Abandonner
le nouveau tracé ? ». Enfin, entrez dans « Déplacer la zone » ou « Redessiner » sans rien faire et changez
d'onglet : le mode se termine tout de suite, sans question.
Tablette en paysage (au moins 1 024 px de large ; en dessous, l'éditeur est en lecture seule) :
12. Les mêmes étapes 1 à 11 au doigt. Attendu en plus : un doigt sur un sommet ou sur le point le déplace, avec une
loupe qui montre ce qui est sous le doigt ; la loupe suit sans saccade. Les poignées sont assez grandes pour le
doigt.
13. Le message « deux doigts ». Action : glissez un doigt sur une partie vide du dessin. Attendu : rien ne bouge et le
message « Deux doigts pour déplacer ou zoomer le dessin » s'affiche une fois. À deux doigts, le dessin se
déplace et se zoome.
14. Rotation avec une boîte ouverte. Action : ouvrez « Propriétés », commencez une saisie, puis tournez la tablette en
portrait et revenez en paysage. Attendu : la saisie est gardée. En portrait sous 1 024 px, la fiche passe en
lecture seule et « Enregistrer » est désactivé ; de retour en paysage, il redevient actif.
#### Choix visibles à juger pendant l'essai
Ces points s'écartent des planches ou n'y figurent pas. Ils ont été tranchés pendant la construction ; dites pour
chacun s'il vous convient.
Interprétations et écarts par rapport aux planches :
- « Reprendre le tracé » rouvre la ligne de sommets : chaque clic ajoute un sommet, « Retirer le dernier sommet »
(bouton en plus des deux de la planche) retire le dernier, fermer sur le premier sommet ou « Revenir aux
propriétés » rouvre la boîte. La planche 04 C dessine le polygone fermé avec ses sommets et ses « + ».
- Pendant un nouveau tracé, Échap demande « Abandonner la création ? », alors que « Annuler le tracé » abandonne tout
de suite. La planche 04 A abandonne tout de suite dans les deux cas.
- « Aller à » pendant une création pose d'abord la question, au lieu de garder la demande pour plus tard.
- Le curseur « Taille » est caché tant que la boîte de création est ouverte, et revient quand vous replacez un point
(planche 02 : visible pendant « Nouveau point »).
- La bande commence par une partie de largeur fixe (256 px) pour le nom et l'état : les commandes ne sont jamais
coupées à 1 024 px et rien ne bouge quand l'état change. En contrepartie, le nom est tronqué tôt (environ 120 px en
français, 77 px en anglais à 1 280 px, à cause de « Inherited, not reviewed »).
- Retour pendant un mode commencé : la question s'affiche ; après « Abandonner », le retour n'est pas rejoué, il faut
appuyer une seconde fois sur Retour (comme pour une modification non enregistrée aujourd'hui).
- Avec un mode commencé et des modifications non enregistrées, quitter l'éditeur pose deux questions de suite :
celle du dessin, puis celle de la fiche.
- Une série de flèches au clavier sur une poignée ou sur le curseur « Taille » (hors des modes « Déplacer … ») est
enregistrée quand vous changez d'onglet, de vue ou d'outil, ou quand vous quittez l'éditeur : elle entre dans
l'historique au lieu d'être perdue.
- Une zone de plus de 40 sommets n'a ni poignées ni glisser de l'intérieur ; ses boutons restent.
- Un accès tracé en polygone a ses sommets et « Redessiner », mais pas de « Déplacer » ; un accès en cercle se glisse
au doigt comme un point, sans curseur de taille.
- « Défaire » pendant un mode ou un nouveau tracé annule seulement ce mode ; Échap annule un nouveau tracé depuis
n'importe où dans l'éditeur ; donner le focus clavier à un sommet le choisit ; une fermeture refusée laisse le
tracé ouvert.
- Un nouveau tracé garde la sélection précédente en dessous ; un point posé ou une zone fermée la lève. Une zone trop
étroite est refusée au moment de « Créer », pas à la fermeture.
- La question de garde dit « Continuer » (et non « Continuer la saisie » comme en R2). Le mode « Déplacer … » se
quitte par « Annuler » / « Cancel », nommé dans le texte de la revue mais absent de son tableau.
- Un double clic sur une annotation non sélectionnée la sélectionne puis ouvre ses propriétés, comme sur une
annotation déjà sélectionnée.
- « Modifier la forme » donne le focus à la première poignée (un « + » quand il y en a un).
- Sous 1 024 px, la lecture des propriétés a un bouton « Désélectionner » ; en lecture seule, « Annuler » devient
« Abandonner ». Le bouton de la bande s'appelle « Propriétés » (avant : « Propriétés de l'annotation »).
- En lecture seule sans sélection, la bande reprend « Cliquez sur une annotation pour la sélectionner », sans
détail. La lecture des propriétés affiche « Aucune » pour une zone sans constat et « — » pour un nom absent (un
accès sans nom). Les icônes « Propriétés », « Modifier », « Valider » et « Supprimer » sont dessinées pour l'éditeur.
- Au toucher, l'appui est jugé au moment où le doigt se lève, sur la cible appuyée : un appui près d'un repère est un
peu plus strict qu'avant.
- Le pincement à deux doigts zoome par rapport à son début, centré sur le point de départ entre les doigts. Le
message « deux doigts » s'affiche quand le doigt se lève, pas dès le début du glisser.
- Ctrl+Z défait maintenant aussi quand le focus est sur le curseur « Taille » ou une case à cocher ; seuls les champs
de texte gardent leur propre annulation.
- « Refaire » est grisé, sans explication, tant qu'un déplacement, un redessin ou des pas aux flèches ne sont pas
enregistrés (Ctrl+Maj+Z ne fait rien non plus) : le travail en cours est gardé, jamais perdu en silence.
Dites si un grisé sans message vous suffit.
- Claviers Mac : il n'y a pas de touche Inser, et la touche « effacer » envoie Retour arrière. Sur un sommet, Inser
ajoute et Suppr retire ; sur Mac, seul le « − » (Entrée) retire, et un « + » caché sur un segment court ne
s'atteint qu'en zoomant. À vous de choisir si Retour arrière agit comme Suppr sur un sommet, et quelle touche
remplace Inser.
- La ligne de message (« Point déplacé · Défaire ») reste affichée tant que la souris la survole, et aussi tant que le
focus clavier est dedans (règle WCAG 2.2.1 : « Défaire » ne doit pas disparaître sous le clavier). La maquette ne
parlait que de la souris.
- À observer : après un appui du doigt, ou un clic sous Safari, qui enregistre des pas aux flèches encore en
attente, le focus clavier revient sur la page et non sur le bouton appuyé. Notez-le si cela vous gêne au clavier.
- Les poignées d'une zone portent maintenant le nom de la zone, lu par les lecteurs d'écran : « Sommet 3 de
Vertèbres thoraciques », « Ajouter un sommet après le sommet 3 de … », « Retirer le sommet 3 de … », et leur groupe
s'appelle « Sommets de … » (liste complète ci-dessous).
Libellés inventés pendant la construction (français / anglais) :
- « Sommet {n} de {nom} » / « Vertex {n} of {name} » ; « Ajouter un sommet après le sommet {n} de {nom} » /
« Add a vertex after vertex {n} of {name} » ; « Retirer le sommet {n} de {nom} » / « Remove vertex {n} of {name} »
(noms des poignées, lus par les lecteurs d'écran ; {nom} est le nom de la zone dans la langue choisie, par exemple
« Sommet 3 de Vertèbres thoraciques ») ; « Sommets de {nom} » / « Vertices of {name} » (nom du groupe des
poignées).
- « Accès {nom} » / « Link {name} » (nom de la poignée d'un accès).
- « Sommet déplacé » / « Vertex moved ».
- « Taille refusée : {texte} » / « Size refused: {text} ».
- « Modification refusée : {texte} » / « Change refused: {text} » (un « + » ou un « − » refusé).
- « Accès déplacé » / « Link moved » ; « Accès redessiné » / « Link redrawn » ; « Point redessiné » / « Point
redrawn ».
- « Accès créé » / « Link created » ; « Accès tracé, {n} sommet(s) » / « Link traced, {n} vertex/vertices ».
- « Accès · {n} sommets » / « Link · {n} vertices » (bande) ; « {détail} · fiche en lecture seule » /
« {detail} · read-only sheet ».
- « Cliquez dans le dessin pour poser le premier sommet » / « Click in the drawing to place the first vertex » ;
« Cliquez sur une annotation pour la sélectionner » / « Click an annotation to select it » ; « {n} sommets posés »
(sans point final) / « {n} vertices placed ».
- « Cette annotation n'existe plus » / « This annotation no longer exists ».
- « À compléter : {champs}. » / « To complete: {fields}. », plusieurs champs séparés par des virgules.
- « Création abandonnée : la fiche a changé. » / « Creation discarded: the sheet changed. »
- Anglais seulement : « A zone keeps at least 3 vertices » (le français vient du tableau validé).
- Anglais des libellés du tableau : « Point placed », « Zone traced, {count} vertices », « Reposition the point »,
« Resume tracing », « Discard », « Back to properties », « Tracing resumed, input kept », « Point created »,
« Zone created ».
Limites connues :
- Planche 31, trois écarts restent dans la boîte des propriétés : pas de pastille de couleur dans la liste des
catégories, les boutons « Abandonner » passent à la ligne à 352 px, l'en-tête de la boîte défile avec son contenu.
- Tablette : quand le clavier à l'écran est ouvert dans la boîte des propriétés, « Enregistrer » peut se retrouver
sous le clavier. Fermez le clavier pour l'atteindre, et dites si cela gêne.
- Les courbes (tracés libres) ne se modifient pas : « Remplacer par un polygone » reste le seul changement possible.
#### Mesures
Deux mesures ont été faites sur un brouillon équin créé pour l'occasion sur la sandbox, jamais sur la copie de
travail ni sur la fiche historique, avec Chromium sur ordinateur et un processeur ralenti quatre fois :
- la fluidité de la loupe (2026-11-18, version de production) : le travail d'une image pendant un glisser au doigt
reste sous 4,5 ms dans 95 % des cas sur la version finale (p95 3,9 à 4,5 ms avec la loupe ; 3,6 à 4,2 ms sans, mesuré
avant), loin des 16 ms d'une image ;
- le délai d'enregistrement d'un geste (2026-11-18, version de production, souris) : du relâchement de la souris à
l'image où la nouvelle forme est affichée et où « Défaire » est disponible, trois essais par geste. Médiane et
maximum sur la version finale : glisser d'un sommet 175 et 202 ms, « + » 175 et 178 ms, « − » 170 et 182 ms, sous la
limite de 500 ms.
Ces chiffres viennent d'un navigateur piloté par ordinateur. Le vrai contrôle est votre essai sur la tablette : si un
glisser, un « + » ou un « − » vous paraît lent ou saccadé, notez le geste et la vue.
## 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`).
- Un appareil du réseau local ne reçoit pas de contexte sécurisé (HTTP) : l'essai n'en a pas besoin.
- 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`.
- Juste après un `down`, `up fresh` peut échouer sur `address already in use` (un port pas encore libéré par
Docker). Attendez quelques secondes, lancez `pnpm db:sandbox down` puis `pnpm db:sandbox up fresh`.
- 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 « Défaire » restaure tout. Un tracé libre n'est jamais modifié : s'il sort du nouveau
cadre, la boîte l'indique (« Ce tracé libre est conservé tel quel. … ») et « Attacher et appliquer » reste
désactivé ; « Annuler » laisse le document intact. Corriger ses points demandera une évolution du cœur
(proposée, pas développée). 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.
### Limites connues de U1
- Une décision en attente sur une vue (nettoyage de l'illustration, réparation des annotations, retour à
l'illustration parente) n'est pas perdue par un simple changement d'onglet ou de section : elle est retenue, signalée par une ligne « … attend votre décision » avec « Reprendre », et ne
se rouvre que par ce bouton. Elle est perdue quand sa vue disparaît (« Défaire », abandon des modifications,
rechargement, suppression de la vue), et « Refaire » ne la ramène pas.
- Une décision en attente au moment d'une soumission reste affichée comme ligne en attente, sans bouton d'action,
tant que le brouillon est gelé.
- Une offre de copie locale peut devenir en attente en cours de session (après une soumission suivie d'une
relecture, ou un changement de droits puis d'édition). Les parties d'édition déjà ouvertes restent montées et
masquées : rien n'est perdu, vous choisissez « Restaurer la copie » ou « Ignorer la copie », et les brouillons
conservés restent après l'un ou l'autre.
- Sous 1 024 px de large, l'éditeur est en lecture seule : les valeurs saisies sont conservées et l'édition revient
quand la fenêtre s'élargit de nouveau.
- Exception à la règle précédente : un champ qui passe sur place à sa valeur en lecture seule (hors des parties
d'édition conservées) perd une saisie que l'enregistrement de la modification a refusée ; le message d'erreur
disparaît avec le champ en lecture seule et revient si la fenêtre s'élargit de nouveau. Un champ placé dans une
partie conservée garde sa saisie.
- Une illustration en cours d'envoi quand la fenêtre passe sous 1 024 px est quand même rattachée à sa vue : c'est
une modification non enregistrée, comme au niveau 1.
- La fenêtre de réparation des annotations garde les géométries saisies au passage sous 1 024 px, mais pas le
message de refus d'une application ni une saisie illisible encore en cours dans un groupe de géométrie.
- Tant que le dialogue des références est ouvert (ou se ferme), la page est inerte sous le voile : on parcourt
d'abord le dialogue. Il ne s'ouvre que depuis un constat ou une famille, dans « Constats » (un panneau latéral
jusqu'au 2026-11-14 : voir 4.10, 4.13 et les limites de R2).
- « Gérer les vues », « Modifier les catégories » et « Régions vertébrales » ouvrent les éditeurs existants en
section pleine largeur ; U3, U4 et U6 les remplacent.
- Largeur du dessin (choix 2.6) : 538 px à 1 024 px et à 1 280 px (la barre latérale revient à 1 280 px), 694 px
à 1 180 px, 793 px à 1 279 px ; la largeur est la même avant l'ouverture du dialogue des références (panneau des citations jusqu'au 2026-11-14) et après sa fermeture.
- Le parcours automatique sur un second appareil du réseau local (`e2e/lan/trial-lan.spec.ts`) n'a pas été
exécuté : il demande cette pile d'essai. Votre essai depuis un autre appareil (section 3) en est la première
vérification.
- Suite de navigateur au dernier commit de U1 (da95b84) : 188 réussis, 90 ignorés, 4 échecs, tous dans le test
d'accessibilité des écrans d'administration (`admin.spec.ts:717`, fr et en, bureau et 375 px). Cause probable :
l'état de la pile jetable (la copie de travail unique de la fiche historique existait déjà après un passage
précédent), à confirmer par une reproduction non destructive ou un test isolé. Les 192 réussites sans échec
datent du commit 81fba46 sur une pile neuve, pas du dernier commit.
### Limites connues de R2
La finition du 2026-11-13 (§4.11) retire trois limites : le panneau ouvert en haut de page puis la rotation en
667 × 375 (le volet est maintenant modal, sur toute la hauteur), les deux saisies refusées annoncées comme une seule,
et la saisie en attente perdue par « Défaire » ou « Refaire » (plus de saisie en ligne : les formulaires sont des
boîtes de dialogue transactionnelles, hors d'atteinte de « Défaire » tant qu'elles sont ouvertes).
Votre essai du 2026-11-14 a validé les parcours principaux de R2 et demandé des retouches, construites : on ne cite
une référence qu'en modification d'un constat (le volet est en lecture seule ; remplacé le 2026-11-15 : les citations
se modifient dans le dialogue des références, §4.13), un seul « Défaire » après une
suppression rend le constat, un seul Retour après une suppression remonte l'historique, le choix d'une entrée de
« Plus » met le focus sur le panneau, l'historique porte une étiquette de session aléatoire et non l'identifiant du
compte, et un départ de plusieurs entrées avec un dialogue modifié est confirmé là où le navigateur peut l'annuler.
La revue finale du 2026-11-14 a ajouté trois corrections. Un Retour qui ne ferme que le volet des références (un dialogue depuis le 2026-11-15), ou un
dialogue de référence sans modification, le ferme sans rien demander, même au-dessus d'un constat modifié. Quand un
Retour ou un départ doit faire demander le constat, ce qui le couvre (le volet, un dialogue de référence sans
modification) se ferme d'abord : la question est visible et prend le focus (depuis le 2026-11-15 un brouillon de
citations non enregistré est demandé comme celui du constat). Une déconnexion, ou une fin de session,
pendant qu'un dialogue garde une saisie non enregistrée laisse un repère sans aucun texte : à la prochaine connexion
du même compte dans cet onglet, l'avis « Une saisie non enregistrée a été abandonnée en quittant l'éditeur »
s'affiche une fois sur la fiche ; un autre compte ne le voit jamais.
Limites acceptées par le propriétaire le 2026-11-14 :
1. Un geste fait dans le même instant qu'un Retour en cours peut être avalé (hors d'atteinte à vitesse humaine).
2. « Aller à » un constat ouvre son dialogue en lecture.
3. La recherche de l'onglet Références est gardée d'un onglet à l'autre (elle n'entre pas dans l'historique ;
« Tout afficher » l'efface ; Retour rend la vue filtrée).
4. Le premier toucher hors du menu « Plus » ouvert le ferme seulement : la page ne reçoit pas ce toucher.
Limites apparues pendant ces retouches, à confirmer par vous lors des vérifications finales (§4.12) :
5. Le Retour d'Android qui ferme « Plus » repose sur `CloseWatcher` (Chrome Android) : prouvé par un test à
doublure seulement. Sans `CloseWatcher`, Retour navigue comme avant ; Échap et le toucher extérieur ferment
toujours. À vérifier par vous sur un téléphone (§4.12).
6. Départ de plusieurs entrées avec deux dialogues modifiés : l'éditeur demande de haut en bas. « Continuer la
saisie » sur un dialogue du dessous garde ce brouillon ; un brouillon déjà abandonné au-dessus reste abandonné
(votre choix). Le dialogue des références (un volet jusqu'au 2026-11-15) et un dialogue de référence sans
modification ouverts au-dessus du constat se ferment avant sa question, pour qu'elle soit visible ; un Retour
rouvre ensuite le dialogue des références.
7. La confirmation avant ce départ est vérifiée sur Chromium de bureau seulement (saut dans l'historique par le
protocole de débogage, un dialogue puis deux empilés). Non vérifiée : Firefox, Safari, un clic
dans le vrai menu d'historique de la barre d'outils. Quand le navigateur ne peut pas annuler le saut, ou n'offre pas
l'API de navigation, l'ancien comportement reste : le brouillon est perdu et l'avis « Une saisie non enregistrée a
été abandonnée en quittant l'éditeur » s'affiche une fois au retour sur la fiche (le texte n'est pas gardé).
8. La restauration de l'historique après un rechargement sur l'adresse du réseau local (http, sans `crypto.subtle`) est
prouvée par un test unitaire seulement (§4.12).
9. BLK-015 : `admin.spec.ts` échoue encore sur la pile cumulée (accumulation d'attributions, la pagination est
RR-13). Il ne s'observe pas dans cet essai manuel.
Levées par ces retouches : le Retour sans effet après la suppression d'un constat, et le focus qui allait au corps de
la page après un choix dans « Plus ».
Retouches du 2026-11-15 (construites, à vérifier au §4.13) : le dialogue des références remplace le volet, avec sa
propre modification (citer, retirer, créer, ouvrir une référence, un seul « Défaire » par enregistrement) ; un seul
ordre d'onglets, « Plus » est une liste verticale. Limites de cette retouche, à confirmer par vous au §4.13 :
10. Levée le 2026-11-15 (retouches de pré-clôture, §4.14) : une référence créée depuis « Nouvelle référence » ne
reste plus dans la bibliothèque après un brouillon abandonné, elle fait partie du brouillon.
11. Dans « Plus », pas de flèches du clavier : Tab parcourt les entrées, sortir par Tab ferme la liste.
12. Résolue le 2026-11-15 : l'aide d'une référence citée nomme maintenant le chemin du dialogue des références
(« Aller à », puis « X références », « Modifier » et « Retirer » dans les références du constat ou de la
famille).
Retouches de pré-clôture du 2026-11-15 (construites, à vérifier au §4.14) : le bouton « Citer », la création d'une
référence dans le brouillon, les libellés « famille », un ✕ de 44 px. Elles lèvent la limite 10. Limites de cette
retouche :
13. Une référence nouvelle n'existe que dans le formulaire des références ouvert, jusqu'à « Enregistrer ». Les gardes de
sortie (✕, Échap, fond, Retour) et `beforeunload` la protègent, mais aucune copie de secours n'est gardée : un
rechargement ou un onglet fermé la perd.
14. « Modifier la référence » sur une référence existante s'enregistre par son propre dialogue : c'est un changement
de la bibliothèque, aussitôt écrit, avec son propre « Défaire ». « Annuler » du formulaire des références ne
l'annule pas.
Les essais complets de `e2e:shell` ne sont pas verts. Dernier passage complet (`52d5613`) : 273 réussis,
163 sautés, 6 échecs, tous dans `admin.spec.ts` (BLK-015). Le passage précédent (`ee79127`) avait aussi 3 échecs sous
la charge (deux plantages du navigateur dans `editor-shell-layout.spec.ts`, un délai dépassé dans `animals.spec.ts`),
réussis quand leurs fichiers tournent seuls.
Quitter l'éditeur par un Retour de plusieurs entrées ne peut pas toujours être refusé (BDR-078, voir 7 ci-dessus) et le
texte saisi n'est jamais gardé.
Limites de R2 qui subsistent :
- Un bouton placé sous un champ dont la saisie est refusée peut perdre son premier clic (la ligne d'erreur décale la
mise en page) : défaut des formulaires en ligne de l'éditeur, non corrigé.
- Passer en lecture seule (fenêtre sous 1 024 px) avec un dialogue ouvert garde la saisie, champs en lecture seule et
« Enregistrer » inactif, avec une note ; seul « Abandonner » reste.
- Un rechargement complet de la page sort de ce cadre : la page disparaît, la copie locale de secours s'applique.
## Repli facultatif : tunnel SSH
Le réseau local suffit normalement. Hors de ce réseau, ou si l'essai tourne en `FAUNOSTEO_TRIAL_HOST=127.0.0.1`,
ouvrez un tunnel depuis l'autre ordinateur :
```bash
ssh -N -L 5193:127.0.0.1:5193 <utilisateur>@<machine>
```
Puis ouvrez `http://127.0.0.1:5193` sur cet ordinateur. Laissez ce terminal ouvert ; Ctrl+C ferme le tunnel.
Ce repli ne marche que si l'essai écoute sur `127.0.0.1`.
## 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`).