Files
faunosteo/docs/development/V1-2-6_UX_TESTS.md
T
bchanot 81fba4631a 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.
2026-11-08 21:42:27 +01:00

20 KiB
Raw Blame History

V1-2.6 UX redesign: test matrix per sub-step

Status: PROPOSAL, 2026-11-05, revised after the independent review and after the owner's answers of 2026-11-05. Companion of V1-2-6_UX_PLAN.md (the common rules of §3 apply: absolute paths, sandbox-only database commands, forbidden commands). No test is written before the owner authorises the sub-step that carries it.

Common gates

Gate Command When
Core pnpm rust:check then pnpm wasm:build any change under crates/
App and packages pnpm typecheck, pnpm test:run, pnpm lint, pnpm build always
Size packages/core-wasm/tests/size.test.ts: Node gzipSync(bytes, { level: 9 }) on packages/core-wasm/pkg/faunosteo_wasm_bg.wasm, at most 600 000 B; the figure printed by that test recorded in RUST.md; never a system gzip figure; the budget never raised silently (T1, LRN-118) any change under crates/core or crates/wasm
Seed and pipeline pnpm r5:import-equine --check with no difference always
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 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

Property tests: seeded generators inside Rust tests (fixed-seed linear congruential sequence, a few thousand cases per property, a failing seed kept as a regression case); no new dependency. TypeScript arithmetic is covered by table tests.

Accessibility: axe with zero serious or critical violations per state (docs/development/BROWSER_TESTS.md:73-91), keyboard-only journeys, a text next to every colour, visible focus on every handle. Chromium only until V1-5; WebKit and real tablets are owner trials.

Path guarantee (T16), every sub-step that touches geometry: a fixture sheet holding paths (never the seed) keeps every path's d text byte for byte through the sub-step's journeys, save and reload.

U0 · Contract and decisions

Kind Test
Review fresh verifier on the U0 contract (.claude/tasks/contracts/2026-11-05-v1-2-6-ux-u0.md): each owner answer of 2026-11-05 recorded once (DECISIONS, contract §17.12, BDR-100, BDR-101) and cited where it applies; no contradiction between contract §6.2, §6.4, §6.7, §7.4, §8.2-8.4, §12.2 (O22 amended), §16.7, §16.12, the level-1 criteria (C3, C4, C5, C6, C7, C8, C11, C13, C16, C18, C20, C25, C28, C32, C33, C40, with the precedence rule of its header), the rules files and the boards; the two SQL checks described at save and at approval and publication and stated as not built; no normative common text written (T12); every cross-reference resolves
Preconditions pnpm r5:import-equine --check clean; seed geometry counts (T16) re-run; wasm figure by the gate's call (LRN-118); git diff --stat empty under crates/, apps/, packages/, supabase/, scripts/

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

U2 · Points and polygons

Kind Tests
Unit (tables) slider stops = distinct radii of the view; snapping; red mark from the core value; midpoint insert after the segment start; « − » disabled at 3 vertices with its reason (board 12 B); zone translation; nearest-handle priority; keyboard map (arrows, Shift ×10, Insert or Backspace or Delete, Enter, Escape, roving focus); arrows pan only when the box is focused; handle cap fallback
Unit (state) pending preview cancelled and restored on undo, redo, document replacement, tab change, second pointer; toast dismissed on any commit, undo or redo; slider commits once on release (history depth after a keyboard walk)
Core the per-view minimum visible radius equals the marker_too_small threshold on the equine views and on edge frames
E2E mouse drag a vertex, « + », « − », zone drag on a selected zone, redraw accepted, redraw refused by interior_too_small restores the old shape, undo and redo of each, toast « Annuler » undoes the same entry as the header; header button and toast action carry the accessible name « Annuler la dernière modification » (T15)
E2E touch (hasTouch, 1 024, 1 180, 1 280 px) one-finger handle drag; explicit « Déplacer la zone » mode; finger 1 on a vertex handle then finger 2 elsewhere: the pinch zooms, the drag is cancelled, no commit (CDP Input.dispatchTouchEvent with two points); page scroll over the canvas with a selection and outside it
Keyboard create a zone, add and remove a vertex, move the zone, validate, without a pointer; Ctrl+Z on a focused handle after arrow moves restores the pre-move shape
Paths (T16) a path annotation gets no handle, no « + » or « − », no zone move in either mode, no keyboard move; its d is byte-identical after every gesture on its neighbours, a save and a reload; « Remplacer par un polygone » stays the only change: explicit, validated by the core, the path kept while tracing, on Escape and on a refusal; one undo entry restoring the exact d, redo restoring the polygon (owner, BDR-101)
Accessibility axe on selection, tracing and move states; handle names (« sommet 3 de Thoraciques »); live-region message after a move
Performance commit latency under the 500 ms budget (editor-equine.spec.ts:25-34) for drag, insert, remove

U3 · Category panel and own colour

Kind Tests
Unit own colour hidden when null; « Revenir à la couleur de la catégorie » sends one update with color: null; new annotations carry no colour; staged form: preview leaves history untouched, Apply commits one batch, Cancel restores the handle; « Réaffecter à… » commits one batch and one undo entry
E2E demo sheet with the equine own colours: atm shows #ff8800, revert, undo; recolour with preview, cancel, apply; reassign then delete a category
Accessibility every swatch has its name next to it; palette keyboard-operable; axe on states A to D

U4 · Detail view by rectangle (manual)

Kind Tests
Unit rectangle normalised from any drag direction and clamped to the parent frame; keyboard resize of its handles; toolbar without the access tool; view menu « Ajouter un accès » asks the editor for the category (no default category, T10 interim)
E2E create a detail view by mouse and by keyboard, view.unreachable until its access exists, place the access with an explicitly chosen category, open the view in the practitioner preview
Core regression compose.rs tests and canvas goldens unchanged
Accessibility axe on creation and placement states

U5 · Detail view assisted

Kind Tests
Rust annotations_in_rect circle, polygon, path, trigger; inside, partial, none; rect on an edge; empty view; unknown view; invalid rect
Rust replacement options (T9) offer call before upload reads V from the candidate text; keep offered iff V equals R; reposition offered iff V differs from R, same aspect ratio on the 0.01 grid; no viewBox → only cancel; a point pushed out of frame by rounding refuses the remap; no path, no descendant crop, numbers in range; different aspect refused remap.aspect; path refused remap.path; descendant crop refused remap.descendant_crop; no frame refused; reposition output = command batch; numbers on the 0.01 grid; triggers drawn in the view remapped; descendant view with its own drawing untouched
Properties (seeded) identity mapping returns the geometry exactly; mapping then inverse within 0.01 per number; inside ⇒ bounds within the rect; a rect equal to the frame ⇒ every annotation of the view inside
Hostile (op level) non-finite and out-of-range rect, unknown ids, oversized command output bounded; no panic
Wasm core-wasm proofs through the preview handle; size gate after each op, figure printed
Unit app name formatting FR and EN (one, two, three, more with « … », none → « Vue détaillée n »); the replacement dialog: opens on every replacement, before any upload, no action preselected, unavailable actions disabled with their reason, « Annuler » sends no request and leaves document and history unchanged
E2E board 08 without automatic access: rectangle over the elbow, proposed name, explicit placement, preview; replacement dialog: the seed head drawing on a crop with the same viewBox → keep and cancel offered, keep applied, annotations to_confirm; a re-based fixture drawing with the same aspect → reposition applied, all moved annotations to_confirm, one undo entry; a fixture with another aspect → reposition disabled with its reason; cancel → no upload request, document byte-identical; a keep or reposition failing the geometry accept → document unchanged, message
Accessibility axe on the dialogs; the reason of a disabled action is announced

U6 · Category model

Kind Tests
Rust serialisation both keys round-trip; absent keys not written (no role or fill_opacity text in the re-serialised seed); explicit null refused; opacity outside 10-100 or not an integer refused; unknown role refused
Rust identity pins (T2, BDR-068) equine fingerprint 12d78872… and alias 27c7383c… recomputed equal; every seed review digest equal to its value pinned before the change; characterisation_serde_tolerance.rs, sheet_fingerprint.rs, r5_6_switch.rs green unchanged; fingerprint.rs construction unchanged in the diff
Rust rules, verdict tier (T4) absolute on the draft: missing role, duplicate role, wrong FR or EN name on a role-bearing category each give an error issue mapped to verification.validation.rules; a first version with no base is judged the same; the base is never judged; validate.rs issue lists identical before and after on every fixture
Rust rules, editor tier (T4) refused: remove a role-bearing category, change or clear its role, a duplicate role, a rename away from the fixed names, any navigation assignment; giving a role writes the fixed names in the same update; repair commands (insert a missing fixed category, restore fixed names, clear a duplicate role) turn every state a direct save can write into one that passes the rule
Rust empty sheet sheet.empty creates the three categories with the ratified T5 ids, names, roles and colours and passes sheet.check and the T4 rule
Rust layer absent keys → R3 trees identical; present fill_opacity changes only the twin and zone fill attributes; triggers unchanged; svg_marker_isolation.rs green
Rust snapshot (T2, T7) lean_document and the export gate strip both keys; controlled widening: the snapshot reader accepts exactly the two keys with their types and range, and gives Schema (report kept) for any other unknown key, null, unknown role, out-of-range opacity
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 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
Unit and E2E app board 07 locks (no delete, name read-only, role badge, « Couleur d'origine »); opacity slider and field synchronised, commit on release; board 09: regions from the vertebra-role category, picker filtered, staged « Appliquer (n erreurs) »; fallback « Régions vertébrales » entry when no category has the role, no duplicate entry once a Vertèbres category exists (T17); board 08 automatic access
Acceptance journey a new non-equine sheet with the new UX (drawing, rectangle view, automatic access, points, zones, findings, custom opacity), saved, submitted, worker verdict passes, round open; its PDF exported, reopened by the app and read by N-1 (archive kept); the same journey with the roles stripped by a direct save: refused at save, the stored draft unchanged; a draft that never carried roles saves, its verdict fails and no round opens; no publication in either case
Recovery a copy taken before an opacity edit restored after reload; conflict journey on a role-bearing category; « Garder ma version » with a role-less document: on a sheet whose stored draft carries roles, the save is refused by the declared check; on a role-less sheet it saves and shows the issue and the repair
Security fresh review: no path writes the keys into an envelope; the SQL checks are exactly those declared under T4 and O22 as amended at U0 (contract §12.2: the save check and the approval and publication check, fixed-category invariants only); the core gate checks a version marker only
Accessibility axe on board 07 and 09 states; the opacity value is exposed to assistive technology

U7 · Common text

Starts only with the owner's text, its source and its validation record (T12).

Kind Tests
Unit insertion only into empty FR and EN fields; never overwrites; template id and version in the change note; comparison read-only; tests use a fixture text marked as a test value, under tests/ only
Review the shipped template module holds exactly the owner-supplied text; the commit cites the validation record; no other normative wording in src/ or the dictionaries
E2E insert, edit, undo, save, reload
Accessibility axe on General with the comparison open

U8 · Closure

Kind Tests
Full run common gates, check:all, sandbox order, verify-e2e, N-1 suite, frozen references unchanged, axe on every tab and state, keyboard-only journey, tablet touch journey
Acceptance contract §16.7 journey re-run on the redesigned editor
Level-1 residuals (T11) each tracked item re-checked and its state recorded (closed, still open, superseded by the redesign); level 1 still not declared validated as a whole
Paths (T16) 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 recorded (sandbox by U6 itself; DEV and shared environments by the owner or under an explicit authorisation)
Owner trial V1-2-6_OWNER_TRIAL.md updated; WebKit iPad and a real tablet by the owner

Curves lot (ex-U9, deferred out of V1-2.6, T16)

Kind Tests
Frozen reader oracle before any change: number_list, path_bounds, path_outline on a corpus (fixtures, hostile paths, owner exports) recorded; compared byte for byte after the change
Rust conformance every command absolute and relative; implicit repeats; M followed by pairs; H and V along and off axis; S and T kept or converted; arcs (endpoint move, λ rescale reported); Z then relative; numbers at ±2^20, exponent forms, .5.5, 1-2 separator merges
Properties (seeded) untouched numbers keep their bytes; moving point i never changes the absolute position of point j ≠ i (exact decimal arithmetic); translate then inverse translate restores the path byte for byte; bounds after translate = bounds shifted
Hostile unreadable d, 2 MiB d, unknown index, non-finite or out-of-range move; no panic
SQL round-withdrawal migration, as U6
E2E fixture sheet with paths (never the seed): drag an anchor, a control, move the zone, save, reload, untouched bytes identical; remap of a crop view holding a path; preview transform during the drag, one core call on release
Size gate with the figure printed