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

+2 -1
View File
@@ -680,7 +680,8 @@ Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheet
- [ ] V1-2.6 UX redesign technical preparation (owner brief 2026-11-05 « V1-2.6 — Validation UX définitive et préparation technique »: 16 boards + 11 choices validated; docs and static audits only, no app/Rust/SQL/worker code, no DEV, no merge, no V1-2.7; STOP at the technical checkpoint)
- [x] static audits (core model, rendering/PDF/N-1, geometry/wasm, SQL/worker, editor/tests) · [x] docs/development V1-2-6_UX_{PLAN,COMPATIBILITY,TESTS,RISKS,DECISIONS}.md (sub-steps U0-U9, decisions T1-T19) · [x] independent review (3 lenses: CONCERNS 5/9/6, no BLOCKER) + fixes integrated (plan §6) · [x] commit + push branch · [x] owner answers 2026-11-05 (brief « V1-2.6 UX — Ratification des décisions techniques », BDR-100): T11 approved, T16 conditional deferral (curves lot), T2/T3 conditional on proofs, T4 no residual gap, T5 history preserved, T9 three actions, T10 navigation type, T12 principle · [x] five docs updated (decisions, compatibility §0/§7/§8, tests, risks + blocking criteria, plan §7) · [x] LRN-118 (wasm measuring rule) · [x] independent reviews: correctness challenger CONCERNS(5 MAJOR, 7 MINOR) integrated; verifier ECARTS(2) fixed; targeted re-check ECARTS(2) (one U6 test assumed permissive save, deploy order said all rounds) fixed · [x] third independent check before commit (2026-11-05): ECARTS(2) on K10/K11 (R-3 mitigation, U6 objective on older T4 scope, write-lock test assumed stripping save, T16 count scope in two forms) fixed · [x] fresh targeted re-check: CONFORME 12/12 (G1-G4 closed; 7 observations kept for U0) · [x] commit + push · [x] owner answers 2026-11-05 (brief « Autorisation U0 uniquement », BDR-101): T4 both SQL checks approved (O22 amended), T5 defaults, T10 option B, T15, T16 count before activation, « Remplacer par un polygone » explicit · [x] T17 answered 2026-11-06 (BDR-102) · [ ] still open: T12 text (before U7), T6 (V1-2.8), T14 follow-up; T1 only if a measure exceeds · [x] owner authorisation to start U0 (2026-11-05)
- [ ] V1-2.6 UX U0, contract and decisions, docs only (contract `.claude/tasks/contracts/2026-11-05-v1-2-6-ux-u0.md`; no code, no SQL, no DEV, no U1): [x] V1-2 contract §6.2, §6.4, §6.7, §7.4, §8.2-§8.4, §12.2 + §17.1 (O22), §16.7, §16.12, §17.12 · [x] level-1 contract C3, C4, C5, C6, C7, C8, C11, C13, C16, C18, C20, C25, C28, C32, C33, C40, with the precedence rule of its header · [x] docs/design/README.md · [x] rules sheet-model.md, schemas.md · [x] five UX docs · [x] BDR-101 · [x] preconditions (r5:import-equine --check clean, seed 22/6/0 paths, wasm 592 143 B) · [x] independent verification: ECARTS x6 fixed, then CONFORME 12/12 (2026-11-06); open points for U2/U6 not in docs: point edge-size handle (boards 02/03), default laterality of the automatic access (U6), §15 replay text vs the category.fixed.* filter · [x] commit + push · [x] owner U0 checkpoint (approved for good in the brief « Autorisation de U1 uniquement », 2026-11-06)
- [ ] V1-2.6 UX U1, editor shell (brief « Autorisation de U1 uniquement » + « U1 — Validation de la conception interne », approach A; contract `.claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md`; plan `.claude/tasks/plans/2026-11-06-v1-2-6-ux-u1.md`, lots A, B1, B2, C-I; no Rust/SQL/worker/scripts, no DEV, no merge, no U2): [x] design approach A validated by the owner with 10 precisions · [x] owner choices 2026-11-06 (server save time, non-modal references panel, citation button in the finding's detail, board 01 annotation card) · [x] plan written + three-lens challenge (correctness CONCERNS 6, robustness CONCERNS 5, simplicity CONCERNS 2, no BLOCKER) integrated · [x] U1 design confirmed by the owner 2026-11-06 (BDR-104; no data deletion implicit in the plan approval, sandbox included) · [x] authorisation checkpoint page `docs/development/V1-2-6_UX_U1_CHECKPOINT.md` (18 choices, amendments 2.1-2.9, audits traced, sandbox reset scope, lot criteria; challenger reports archived `.claude/audits/2026-11-06-v1-2-6-u1-plan-challenges.md`; contract `.claude/tasks/contracts/2026-11-06-v1-2-6-u1-authorisation-checkpoint.md`, fresh verifiers ECARTS(3) → ECARTS(1) → last gap fixed, not re-verified) · [x] owner U1 authorisation 2026-11-06 (brief « Ratification finale U1 et autorisation conditionnelle d'implémentation », BDR-105): 18 choices, approach A, AC3/4/5/7/17 and 2.6-2.9 applied to the contract; precautions 2.8 (no silent loss on 1 024 px crossing or recovery decision) and AC7 (save time rights); per-operation sandbox go · [ ] precautions investigated and written in the contract · [ ] targeted counter-check (3 confirmation fixes + 2 precautions), blocking gaps fixed and re-checked · [ ] lots A-I (commit + push per lot) · [ ] gates, verifier, security · [ ] owner U1 checkpoint
- [ ] V1-2.6 UX U1, editor shell (brief « Autorisation de U1 uniquement » + « U1 — Validation de la conception interne », approach A; contract `.claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md`; plan `.claude/tasks/plans/2026-11-06-v1-2-6-ux-u1.md`, lots A, B1, B2, C-I; no Rust/SQL/worker/scripts, no DEV, no merge, no U2): [x] design approach A validated by the owner with 10 precisions · [x] owner choices 2026-11-06 (server save time, non-modal references panel, citation button in the finding's detail, board 01 annotation card) · [x] plan written + three-lens challenge (correctness CONCERNS 6, robustness CONCERNS 5, simplicity CONCERNS 2, no BLOCKER) integrated · [x] U1 design confirmed by the owner 2026-11-06 (BDR-104; no data deletion implicit in the plan approval, sandbox included) · [x] authorisation checkpoint page `docs/development/V1-2-6_UX_U1_CHECKPOINT.md` (18 choices, amendments 2.1-2.9, audits traced, sandbox reset scope, lot criteria; challenger reports archived `.claude/audits/2026-11-06-v1-2-6-u1-plan-challenges.md`; contract `.claude/tasks/contracts/2026-11-06-v1-2-6-u1-authorisation-checkpoint.md`, fresh verifiers ECARTS(3) → ECARTS(1) → last gap fixed, not re-verified) · [x] owner U1 authorisation 2026-11-06 (brief « Ratification finale U1 et autorisation conditionnelle d'implémentation », BDR-105): 18 choices, approach A, AC3/4/5/7/17 and 2.6-2.9 applied to the contract; precautions 2.8 (no silent loss on 1 024 px crossing or recovery decision) and AC7 (save time rights); per-operation sandbox go · [ ] precautions investigated and written in the contract · [ ] targeted counter-check (3 confirmation fixes + 2 precautions), blocking gaps fixed and re-checked · [x] lots A-H (A 95b1b7e; B1 bc2dba7..ca184da; B2a 6689827..9d89dae; B2b c57af64..51fd3db; C 6131225..cf9c300; D ab51ea7; E 99b669b..89da8d3; F 580ff28..925d843; G 23900f3..9c03cf2; H 0bb150f..606f7ba) · [ ] Lot I open (docs and pre-reset gates in part 1; part 2 waits for the owner's sandbox go) · [ ] gates, verifier, security · [ ] owner U1 checkpoint
- [ ] Rights screen lists every catalogue grant unbounded (list_catalog_grants, GrantList): 2 306 rows crash axe at 8 workers on a long-lived sandbox; needs SQL paging, outside U1 (no SQL); owner decision. Evidence: .superpowers investigation, admin.spec 9/9 crashes on 89da8d3, 580ff28, 606f7ba.
- [ ] V1-2.6 UX complement « annotations ↔ constats » (owner brief 2026-11-06 « Nouvelle exigence UX : navigation bidirectionnelle »; contract `.claude/tasks/contracts/2026-11-06-v1-2-6-findings-nav-design.md`; design only, U1 plan untouched, no code, no DEV): [x] relations audit (one link `finding_zone_id`, no new association, equine draft 1:1) · [x] boards 17-22 `docs/design/v1-2-6-constats/` · [x] study `docs/development/V1-2-6_UX_FINDINGS_NAV.md` (no U1 integration point needed, sub-step U2b proposed, risks, tests, decisions F1-F21) · [x] fresh design review APPROVE WITH FIXES (3 MUST-FIX, 16 SHOULD), fixes applied · [x] fresh verifier ECARTS(4) → ECARTS(2) → CONFORME 9/9 (round 3; 567da67 came after it, not covered) · [x] owner principle validation 2026-11-06 (brief « Validation de principe U2b et préparation des checkpoints », BDR-103): U2b retained after U2 and before U3, F1/F2/F6/F8/F22 approved, F7 for the term « Famille », F3/F4 in part · [x] decisions F1-F22 table (alternatives, consequences, state), F2 groups vs leaves, F3 field list, F4 view semantics, boards with their decisions in study §7.4, U2b entry in `V1-2-6_UX_PLAN.md` §3, LRN-119 (`<Activity>`), contract `.claude/tasks/contracts/2026-11-06-v1-2-6-findings-nav-decisions.md` · [x] fresh verifier on that contract: ECARTS(9) → fixed → CONFORME 11/11 (6 observations outside criteria kept for the owner) · [x] owner 2026-11-06 (brief « U1 / U2b — Derniers arbitrages avant implémentation », BDR-104): F2 leaves, F3, F4 model A, F8, F22 decided; study §6-§7 updated · [x] owner: F5, F9-F21 approved as recommended, precisions F3, F8, F11-F14, F22 (brief « Ratification finale U1 … », 2026-11-06, BDR-105); study header, §6 tests, §7 table, 7.2, 7.3, UX PLAN U2b entry, REVUE, DECISIONS pointer updated; no implementation · [ ] U2b authorisation (after U2, before U3)
- [ ] follow-up candidates (owner T14): multi-tab notice; RR item for the rollback limit of the category model (new id, reconcile with develop)
- [ ] curves lot (ex-U9, owner T16 2026-11-05): curve handle editing, curved zone move, path remap, path point correction; spec `V1-2-6_UX_PLAN.md` §2 D, tests `V1-2-6_UX_TESTS.md` « Curves lot ». Rule: no feature that lets a path enter a document (package import, zones from the drawing's shapes, a curve drawing tool) ships before or without it. Before the new model is activated on an environment, and before U6 or U8 reaches any environment beyond the throwaway sandbox: read-only count of path geometries in its drafts and published versions (sandbox by U6 itself; DEV and shared environments by the owner or under explicit authorisation; non-zero reopens T16)
@@ -441,11 +441,11 @@ answers, executor's:
`docs/design/v1-2-6/`; nothing staged from the untracked review file.
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 846994b..HEAD -- crates supabase scripts packages/core-wasm/src packages/supabase/src docs/design/v1-2-6 && git diff --quiet -- crates supabase scripts packages/core-wasm/src packages/supabase/src docs/design/v1-2-6 && ! git ls-files --error-unmatch faunosteo-v1-2-6-revue-ux-chatgpt.md >/dev/null 2>&1 && echo U1_SCOPE_OK
EXPECT: U1_SCOPE_OK
EVIDENCE: pending
EVIDENCE: 2026-11-08, HEAD 606f7ba: U1_SCOPE_OK
20. FR/EN dictionaries hold the same keys.
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && node -e "const fs=require('fs');const k=f=>new Set([...fs.readFileSync(f,'utf8').matchAll(/^\s*'([a-z0-9_.]+)':/gm)].map(m=>m[1]));const a=k('apps/app/src/i18n/fr.ts'),b=k('apps/app/src/i18n/en.ts');const d=[...a].filter(x=>!b.has(x)).concat([...b].filter(x=>!a.has(x)));if(d.length||a.size<100){console.error(d);process.exit(1)}console.log('I18N_PARITY_OK',a.size)"
EXPECT: I18N_PARITY_OK
EVIDENCE: pending
EVIDENCE: 2026-11-08, HEAD 606f7ba: I18N_PARITY_OK 1458
21. [added 2026-11-06, owner precaution 2.8] No silent loss of typed input on a 1 024 px crossing or a recovery
decision, as resolved in CLARIFICATIONS « Unmounted forms »: the listed edit-only parts kept and hidden while
read-only with their values back on widening (drawing actions included, their dialogs closed while read-only),
+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 |