docs(docs): V1-2.6 UX redesign technical plan, compatibility, tests, risks, decisions
This commit is contained in:
1 parent
f58cf2308f
commit
14fb527552
5 files changed
+1083
No files matched your search
@@ -0,0 +1,134 @@
|
||||
# V1-2.6 UX redesign: test matrix per sub-step
|
||||
|
||||
Status: PROPOSAL, 2026-11-05, revised after the independent review. 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 approves the plan.
|
||||
|
||||
## 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 gzip ≤ 600 000 B), figure recorded in RUST.md | 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 U1) | U1, U6, U8, U9 |
|
||||
| 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.
|
||||
|
||||
## U0 · Contract and decisions
|
||||
|
||||
| Kind | Test |
|
||||
|---|---|
|
||||
| Review | fresh verifier: each answer recorded once and cited where it applies; no contradiction between contract §7.4, §8.2-8.4, §16.7, the level-1 criteria (C3, C4, C6, C7, C8, C13, C32, C33, C40) and the boards |
|
||||
|
||||
## U1 · Shell
|
||||
|
||||
| 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); 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; 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; « − » hidden at 3 vertices; 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 |
|
||||
| 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 |
|
||||
| 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 » |
|
||||
| E2E | create a detail view by mouse and by keyboard, `view.unreachable` until its access exists, place the access, 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 `remap_view` | same aspect, different aspect (uniform, centred); triggers drawn in the view remapped; descendant view with its own drawing untouched; descendant crop refused (`remap.descendant_crop`); path refused (`remap.path`); no frame refused; output = command batch; numbers on the 0.01 grid |
|
||||
| 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 »); access box checked only with an empty overlap list and a category available; view and access inserted in one batch |
|
||||
| E2E | board 08: rectangle over the elbow, proposed name, access unchecked with its reason, explicit placement, preview; rectangle over an empty area: access created, no annotation under it; attach the seed head drawing to a crop with the same `viewBox`: no question, positions kept; attach a re-based fixture drawing: choice offered, transposition, all remapped annotations `to_confirm`, one undo entry; a remap failing the geometry accept leaves the document unchanged and the drawing held |
|
||||
| Accessibility | axe on the dialogs; the reason of the unchecked box 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; out-of-range opacity and unknown role refused |
|
||||
| Rust identity pins | 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 |
|
||||
| Rust rules | edit refusals (remove, role change, duplicate role, rename of a role-bearing category); report issues against a base (role disappears, duplicate role) mapped to `verification.validation.rules`; none fires on the seed, the oracles or any fixture; `validate.rs` issue lists identical before and after on every fixture |
|
||||
| Rust empty sheet | `sheet.empty` creates the three categories with the T5 ids, names, roles and colours and passes `sheet.check` |
|
||||
| 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 | `lean_document` and the export gate strip both keys; a snapshot from a New-present document passes the gate and the N-1 shape |
|
||||
| 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 round-withdrawal migration: pgTAP with rounds in `verifying`, `open`, `approved` before it and withdrawn after with the reason; `pnpm db:sandbox up upgrade` from the current migration set; `types --check` |
|
||||
| Worker | image rebuilt from `HEAD`; `verify-e2e` with a New-absent and a New-present draft; verdict passes for both |
|
||||
| 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 entry when no category has the role (T17) |
|
||||
| Acceptance journey | a new non-equine sheet with the new UX (drawing, rectangle view, points, zones, access, findings, custom opacity), saved, submitted, worker verdict passes, round `open`; its PDF exported, reopened by the app and read by N-1 (archive kept) |
|
||||
| Recovery | a copy taken before an opacity edit restored after reload; conflict journey on a role-bearing category; « Garder ma version » with a keyless document shows the report issue |
|
||||
| Security | fresh review: no path writes the keys into an envelope; no new SQL business rule |
|
||||
| Accessibility | axe on board 07 and 09 states; the opacity value is exposed to assistive technology |
|
||||
|
||||
## U7 · Common text
|
||||
|
||||
| Kind | Tests |
|
||||
|---|---|
|
||||
| Unit | insertion only into empty FR and EN fields; never overwrites; template id and version in the change note; comparison read-only |
|
||||
| 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 |
|
||||
| Owner trial | `V1-2-6_OWNER_TRIAL.md` updated; WebKit iPad and a real tablet by the owner |
|
||||
|
||||
## U9 · Curves (if kept, 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 |
|
||||
Reference in new issue
Block a user