docs(app): U1 owner trial, plan and tests pointers

U1 demo and known limits in the owner trial guide, tooling moved to U6 in
the plan and tests, TODO lots A-H, AC19 and AC20 evidence.
This commit is contained in:
bchanot committed 2026-11-08 21:42:27 +01:00
1 parent 606f7ba268
commit 81fba4631a
5 files changed
+86 -34

No files matched your search

+62 -15
View File
@@ -110,8 +110,8 @@ Chaque étape donne l'action et le résultat attendu. Notez tout écart avec la
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 (onglets Général, Vues et
illustrations, Annotations, Constats, Références, Vertèbres, Vérification). Une fiche neuve et vide s'ouvre
2. Attendu : la création ouvre directement le brouillon vide dans l'éditeur, sans page intermédiaire, avec
quatre onglets (Général, Annotations, Constats, Vérification). Une fiche neuve et vide s'ouvre
sur l'onglet « Général ».
3. Dans « Général », tapez des espaces autour d'un nom (par exemple ` Essai `) et validez. Attendu : les espaces
du début et de la fin sont retirés des noms et des libellés courts de l'éditeur ; les descriptions, notes,
@@ -133,8 +133,9 @@ 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.
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.
@@ -142,30 +143,34 @@ SVG
aucune boîte de nettoyage, aucune illustration ajoutée.
### 4.3 Créer des annotations
1. Onglet « Général », bloc « Nouvelle catégorie » : renseignez les noms, puis « Ajouter la catégorie ». Sans
catégorie, l'onglet Annotations le signale quand vous y passez : « Créez d'abord une catégorie d'annotation
(onglet Général). »
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 « Vues et illustrations », formulaire « Nouvelle vue de détail », bouton
« Ajouter la vue » ; le recadrage est facultatif), puis l'outil « Accès à
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. « Annuler » et « Rétablir » (barre d'outils de l'onglet Annotations) défont et refont chaque création. Ne les confondez pas avec
« Annuler les modifications » (en-tête), qui abandonne tout ce qui n'est pas enregistré.
5. « Annuler » et « Rétablir » (à droite de la rangée d'onglets, sur chaque onglet ; nom accessible « Annuler la
dernière modification ») 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 « Vues et illustrations » avec un recadrage, puis « Choisir une illustration » avec `valide.svg`. Placez
une annotation sur cette vue (onglet Annotations).
1. Retour dans « Vues et illustrations », sur cette vue : « Utiliser l'illustration de la vue parente ».
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 s'annule, 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. Dans l'onglet Annotations, « Annuler » (barre d'outils) restaure l'illustration propre de la vue.
3. « Annuler » (à 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 ».
@@ -228,6 +233,29 @@ une annotation sur cette vue (onglet Annotations).
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 quatre onglets : « Général », « Annotations », « Constats », « 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 « Annuler » à droite
de la rangée d'onglets. Attendu : le nom d'origine revient dans « Général » ; « Rétablir » le remet. Un champ en
cours de saisie est validé avant l'annulation, donc sa saisie est la dernière modification annulée.
3. Références : le bouton « Références » de l'en-tête ouvre un panneau latéral (non modal) avec un filtre par nom.
Dans « Constats », sélectionnez un constat qui cite une référence : le bouton « n référence(s) » ouvre le même
panneau limité à « Citées par « … » (n) », avec « Tout afficher (n) » pour revenir à la liste entière.
« Fermer les références » ou Échap ferme le panneau et rend le focus au bouton qui l'a ouvert.
4. 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.
5. 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, deux
onglets restent visibles et « Plus » ouvre les deux autres.
## 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).
@@ -247,6 +275,25 @@ une annotation sur cette vue (onglet Annotations).
(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, de section ou l'ouverture du panneau
des références : 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 (annulation, abandon des modifications,
rechargement, suppression de la vue), et « Rétablir » 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.
- Tant que le panneau des références est ouvert, le contenu des onglets n'est pas atteignable au clavier (il est
inerte sous le voile) : on parcourt d'abord le panneau, le contenu après sa fermeture.
- « 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.
## 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 :
+16 -13
View File
@@ -260,7 +260,7 @@ Node `gzipSync(bytes, { level: 9 })` on the `pkg` build, re-measured on 2026-11-
`apps/app/tests/unit/n-1.reader.test.ts:178-196` (envelope success, archive kept, no `snapshotRejected`); the seed
path stays as it is. `contracts.types.test.ts:53-61` checks assignability: `ts(optional)` on both keys is
necessary and sufficient; it says nothing about runtime stripping, which the fixture test proves.
- Worker: the image is rebuilt from the same commit, checked against `git rev-parse HEAD` before the run (U1 adds
- Worker: the image is rebuilt from the same commit, checked against `git rev-parse HEAD` before the run (U6 adds
that guard), and `verify-e2e` runs a New-absent and a New-present draft.
- Old drafts and recovery copies are plain document texts read by the same strict reader.
- The readers of user data widen (`assert_snapshot`, used by `archive/read.rs`, accepts the keys): the owner agreed to
@@ -453,25 +453,25 @@ Common rules for every sub-step that touches code:
- Owner demo: read the amended sections. Rollback: revert.
- Checkpoint: owner approves the amended contract.
### U1 · Shell: four tabs, header undo, references panel, tablet layout, sandbox guard
### U1 · Shell: four tabs, header undo, references panel, tablet layout
Status: implemented on `feature/v1-2-anatomical-sheets` (lots A to H; Lot I, gates and checkpoint, in progress); contract
`.claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md`. The tooling below moved to U6 (owner, contract CLARIFICATIONS).
- Objective: General, Annotations, Findings, Verification; views, drawings, vertebral regions and categories in
Annotations; References as a side panel from the header or a finding; Undo and Redo in the header on every tab;
sidebar hidden in the editor below 1 280 px with the menu one tap away; « Aller à » retargeted. Tooling: the
sandbox `verify-e2e` refuses an image whose commit label differs from `HEAD`; the trial command provisions the
demo sheet.
sidebar hidden in the editor below 1 280 px with the menu one tap away; « Aller à » retargeted.
- Files: `app/editor/tabs.ts`, `EditorTabs.tsx`, `EditorTabBody.tsx`, `DraftHeader.tsx`, `components/editor/tabs/*`,
`app/editor/verification.ts:64-131`, `PropertiesPanel.tsx:169`, `components/shell/AppLayout.tsx:72-123`,
`ToolColumn.tsx`, i18n; `scripts/db-sandbox.sh` (image check, demo sheet), `crates/worker/Dockerfile` (commit
label).
`ToolColumn.tsx`, i18n.
- Dependencies: U0, T11 (ratified: level-1 trial stopped, level 1 not declared validated, residuals tracked), T15
(ratified: header undo named « Annuler la dernière modification », C11 relabelled « Abandonner les
modifications »).
- Rust ops: none.
- Tests: `V1-2-6_UX_TESTS.md` U1.
- Acceptance: four tabs at 1 024 px and wider; every existing editor journey green on the new shell; narrow-width
read-only unchanged; undo from any tab reverts the last accepted change; a stale worker image is refused.
- Owner demo: on the demo sheet, switch tabs, undo a General change from Annotations, open References from a
read-only unchanged; undo from any tab reverts the last accepted change.
- Owner demo: on a non-equine sheet created in the UI (`V1-2-6_OWNER_TRIAL.md` 4.9), switch tabs, undo a General change from Annotations, open References from a
finding, resize to 1 180 px.
- Risk: broad test rewrite (each removed assertion mapped to its replacement). Rollback: revert, no data change.
- Checkpoint: owner validates the shell.
@@ -584,14 +584,17 @@ Common rules for every sub-step that touches code:
list and created only when it is empty; board 09: regions open from the
vertebra-role category, the region picker of a zone filtered to the vertebra-role category's annotations (page
filter, no rule), staged « Appliquer » with the error count; fallback « Régions vertébrales » entry per T17 (ratified 2026-11-06) when no category has the role (the
equine copy before V1-2.8). `docs/ANNOTATION-RENDERING.md` amended first.
equine copy before V1-2.8). `docs/ANNOTATION-RENDERING.md` amended first. Tooling moved from U1 (owner, U1 contract
CLARIFICATIONS): the sandbox `verify-e2e` refuses a worker image whose commit label differs from `HEAD`, and the trial
command provisions the demo sheet.
- Files: core `domain/sheet/schema.rs`, `create.rs`, `edit.rs`, `report.rs`, `verdict.rs` (gate marker in
`verified_with`), `anatomy/layer.rs` (`layer()` 85-102, `Context::point` 242, `zone_visual` 297-304),
`domain/archive/snapshot_rules.rs:141-165`, `pdf/write/input.rs:174-181`, `export.rs:27-37`, types; app
`refusal.ts`, the category panel, the repair action, the regions dialog (`components/editor/vertebrae/*`),
`DetailViewForm.tsx` (automatic access), i18n; SQL `supabase/migrations/<timestamp>_sheet_rounds_withdraw_v1_2_6.sql`
(name provisional: round withdrawal, core gate, rules epoch, publication check, save check); docs `ANNOTATION-RENDERING.md`, `ANATOMICAL_SHEET_MODEL.md`
(spec table), `RUST.md`, `DEPLOY.md` (order, write lock).
(spec table), `RUST.md`, `DEPLOY.md` (order, write lock); `scripts/db-sandbox.sh` (image check, demo sheet),
`crates/worker/Dockerfile` (commit label), both moved from U1.
- Dependencies: U3, U5 (U5 brings `annotations_in_rect`, the overlap list the automatic access needs, after U4's
rectangle); T2 and T3 (ratified with conditions), T4 (ratified with both SQL checks), T5 (ratified), T10 option B
(ratified), T17 (ratified 2026-11-06, BDR-102).
@@ -602,7 +605,7 @@ Common rules for every sub-step that touches code:
- Acceptance: compatibility matrix proven row by row and §8 green; oracles, goldens and seed unchanged; N-1 reads
New-present PDFs; worker verdict on the three kinds of draft (role-less fails, repaired passes, New-present
passes); the contract §16.7 journey on a non-equine sheet with the new UX reaches `open` after the worker verdict;
a role-stripped draft never reaches a round.
a role-stripped draft never reaches a round; a stale worker image is refused (moved from U1).
- Owner demo: new species sheet with its three categories, custom opacity, regions from Vertèbres, automatic access,
PDF exported and reopened; a role-stripped direct save refused at save.
- Deploy order, write lock and rollback: `V1-2-6_UX_COMPATIBILITY.md` §7. Returning to the old application is
@@ -661,7 +664,7 @@ Common rules for every sub-step that touches code:
| Sub-step | App | Rust core | Schema | SQL | Worker image |
|---|---|---|---|---|---|
| U0 | no | no | no | no | no |
| U1 | yes | no | no | no | label only |
| U1 | yes | no | no | no | no (the label moved to U6) |
| U2 | yes | one read-only value | no | no | no |
| U3, U4 | yes | no | no | no | no |
| U5 | yes | two queries | no | no | no (the worker calls neither) |
+4 -3
View File
@@ -15,7 +15,7 @@ forbidden commands). No test is written before the owner authorises the sub-step
| Frozen references | no change under `crates/core/tests/oracles/`, `apps/app/tests/fixtures/goldens/`, `supabase/seed/` (`git diff --stat` on those paths is empty) | always |
| Browser, no backend | `pnpm e2e:ui` | always |
| Sandbox | `pnpm db:sandbox up fresh`, then `test-db → e2e-shell → test` (LRN-113) | always |
| Worker | `pnpm worker:image`, then `pnpm db:sandbox verify-e2e` (refuses an image not built from `HEAD` after U1) | U1, U6, U8 |
| Worker | `pnpm worker:image`, then `pnpm db:sandbox verify-e2e` (refuses an image not built from `HEAD` after U6) | U6, U8 |
| Pre-checkpoint | `pnpm check:all` | every code sub-step |
| Reviews | fresh verifier on the sub-step contract; fresh security review on the diff | every sub-step |
@@ -39,11 +39,12 @@ every path's `d` text byte for byte through the sub-step's journeys, save and re
## U1 · Shell
Implemented (contract `.claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md`). The former « Tooling » row moved to U6 (the `verify-e2e` image check and the demo sheet provisioned by the trial command).
| Kind | Tests |
|---|---|
| Unit | four-tab model, initial tab, width tiers (replaces `editor-route.test.tsx:66`, `128-170`, `editor-mode.test.ts:99-110`); header undo and redo states; undo from each tab reverts the last commit made on another tab; a typed field is flushed before the header undo (behaviour pinned); header undo accessible name and tooltip « Annuler la dernière modification » (T15); « Abandonner les modifications » for the return to the saved revision (C11 as amended); references panel open, close, return focus; « Aller à » target for every issue kind (`verification.ts:64-131`) |
| E2E shell | helpers rewritten (`e2e/support/editor.ts:326-330`, `warm-up.ts:43-45`, `editor-access.spec.ts:34-42`); every existing editor journey green on the new shell; sidebar hidden in the editor at 1 024, 1 180, 1 279 px, shown at 1 280 px, menu reachable in one tap; narrow-width read-only unchanged |
| Tooling | `verify-e2e` refuses an image whose commit label differs from `HEAD`; the trial command provisions the demo sheet through the application upload path |
| Accessibility | axe on the four tabs and on the open references panel; Tab order header → tabs → panel → canvas |
| Regression | recovery and conflict specs unchanged; level-1 criteria C13, C14, C16, C34, C41 re-run (T11); each removed assertion mapped to its replacement in the commit message |
@@ -105,7 +106,7 @@ every path's `d` text byte for byte through the sub-step's journeys, save and re
| Equine history (T5) | conversion of an in-memory copy of the seed draft (roles on the T6 categories): seed bytes, fingerprint, alias and every review digest equal before and after; the copy differs only in the converted categories; `pnpm r5:import-equine --check` clean |
| App and N-1 | New-present sheet fixture and harness: exported PDFs pass the assertions of `n-1.reader.test.ts:178-196`; `contracts.types.test.ts` green with `ts(optional)`; `measure.test.ts` green; PDF goldens unchanged |
| SQL | the U6 migration: pgTAP with rounds of draft versions in `verifying`, `open`, `approved` before it and withdrawn after with the reason; core gate: a passed verdict with an older `verified_with` refused, the U6 marker accepted; `save_sheet_draft` accepts a draft without roles over a stored draft without roles; the approved declared check refuses a save where a role is carried by two categories, a role-bearing category lacks its fixed FR or EN name, or a role of the stored draft is lost, and accepts each repair save; `private.sheet_fixed_categories_ok` refuses approval and publication outside the fixed model; the rules epoch RPC answers; draft rounds withdrawn while the approved round of each published version stays approved; approval and publication refused without a current passed verdict; `pnpm db:sandbox up upgrade` from the current migration set; `types --check` |
| Worker | image rebuilt from `HEAD`; `verify-e2e` with a New-absent draft (fails on `verification.validation.rules`), the same draft repaired, which then carries roles (passes), and a sheet created by the U6 `sheet.empty` (passes) |
| Worker | image rebuilt from `HEAD`; `verify-e2e` refuses an image whose commit label differs from `HEAD` (moved from U1) and the trial command provisions the demo sheet through the application upload path (moved from U1); `verify-e2e` with a New-absent draft (fails on `verification.validation.rules`), the same draft repaired, which then carries roles (passes), and a sheet created by the U6 `sheet.empty` (passes) |
| Write lock (T4) | on a sandbox with the old worker image and the U6 SQL: a role-less draft's round never opens (gate); a save stripping the roles of a role-bearing draft refused (save check); the U6 app on a stack without the rules epoch writes no key and creates no new-model sheet; publication and approval refused outside the fixed model even with a forged passed verdict (pgTAP) |
| Flipped suites | `sheet_verdict.rs:39-52`, `80-90`, `sheet-verification.sandbox.ts:27`, `209-211`, `373`, worker fixtures and `tests/verify_loop.rs` moved to converted in-memory copies, each change mapped in the commit message; seed unchanged |
| Navigation access (T10 option B, ratified) | `cat-access` with role `navigation` created on demand in the same core-built batch as the view and its access, only when the overlap list is empty; an edit that gives, changes or clears `navigation` refused; a second `cat-access` insertion refused; absent from the category panel and the pickers; an observable annotation in it and a second navigation category refused (edit) and reported (verdict); its role stripped from snapshots, N-1 reads the category |