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

+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) |