10 KiB
10 KiB
V1-2.6 UX redesign: risk register
Status: PROPOSAL, 2026-11-05, revised after the independent review and after the owner's answers of 2026-11-05
(BDR-100, then BDR-101 with the brief « Autorisation U0 uniquement »).
Companion of V1-2-6_UX_PLAN.md. Decisions live in V1-2-6_UX_DECISIONS.md (single table); sub-step dependencies
in the plan (§3, each sub-step's « Dependencies »); deploy order, write lock and rollback in
V1-2-6_UX_COMPATIBILITY.md §7. Probability and impact: H high, M medium, L low.
| Id | Risk | P | I | Mitigation | Where checked |
|---|---|---|---|---|---|
| R-1 | New category keys written as null when absent: every fingerprint, review digest, equine sheet-ref, alias and R4 app-path digest changes |
H without a pin | H | skip_serializing_if + js::present; tests pin fingerprint 12d78872…, alias 27c7383c…, seed digests (T2) |
U6 |
| R-2 | An unconditional validate.rs rule on roles strips fingerprints of existing documents and rejects old PDF snapshots |
H if done | H | rules only in edit.rs and sheet_report (T4) |
U6 review |
| R-3 | Direct save, « Garder ma version » or an older bundle strips the roles of a sheet before its first publication | M | H | closed (T4): absolute verdict rule on the draft, no base needed; core gate at verification completion; declared publication check private.sheet_fixed_categories_ok at approval and publication; declared save check (both approved, contract §12.2, built at U6) |
U6 |
| R-4 | Worker older than the app reads a New-present draft: definitive integrity.document |
H on skew | M | one commit for both images; worker before app; verify-e2e refuses a stale image |
U1 guard, U6 |
| R-5 | Rounds in flight across a rule or reader change keep a verdict of the old core | M | M | round-withdrawal migration in U6 (T4) and the curves lot, tested with up upgrade and live rounds |
U6 |
| R-6 | A caller-built snapshot or export_from_envelope carries the keys: N-1 and older apps drop the snapshot |
M | M | strip at both points (T7); N-1 test on a New-present fixture | U6 |
| R-7 | Opacity written as anything but fill-opacity would reach the PDF (category colour already reaches strokes) |
L | M | layer writes fill-opacity only |
U6 |
| R-8 | Budget exceeded mid-sub-step, or measured with another tool than the gate's | M | M | measure after each op with the gate's exact method (LRN-118); T1 fallback; never raised silently; PDF split never on the critical path | U5, U6 |
| R-9 | Return to the old application impossible once a New-present document exists (drafts unreadable by the old app and worker, published rows immutable, migrations forward-only); not full backward compatibility | certain after the first write | H | point of no return stated (COMPATIBILITY §0, §7); write lock (T4); sandbox only until the owner decides; release-readiness item (new RR id, reconciled with develop where RR-11 is taken) | U6 |
| R-10 | An executor follows the CLAUDE.md SQL line (db:reset, db:test, db:types) and reaches DEV |
M | H | plan forbids them and lists the sandbox commands; LRN-110 absolute-path rule in every brief | every SQL sub-step |
| R-11 | Shared sandbox and worker tag: another checkout replaces the stack or image between rebuild and test | M | M | no other checkout runs them during V1-2.6; image label checked against HEAD |
U1 guard |
| R-12 | Rebuilding the sandbox wipes the owner-trial stack | M | L | tell the owner before any down or up fresh |
every sub-step |
| R-13 | Keeping positions for a re-based drawing, or an approximate remap, misplaces annotations | M | M | explicit three-action dialog on every replacement (T9); keep only when V equals R, reposition only for a same-aspect mapping, each with its stated premise; both fail closed; every affected annotation to_confirm |
U5 |
| R-14 | Remap of a subtree with descendant crops or paths | L | M | closed refusals remap.descendant_crop, remap.path |
U5 |
| R-15 | A pinch with finger 1 on a handle moves the handle | H on touch | M | a second pointerdown cancels the armed drag; two-touch test starting on a handle | U2 |
| R-16 | Undo, redo or a document replacement during a pending preview resurrects a change or moves the wrong vertex | M | H | pending previews cancelled before any of them | U2, U3 |
| R-17 | Toast undoes a different action than it names | M | L | dismissed on any commit, undo or redo | U2 |
| R-18 | Arrow keys pan and move handles | H | M | focus decides | U2 |
| R-19 | Sliders flood the history | M | M | commit on release or blur (T19); history depth test | U2, U6 |
| R-20 | touch-action read at touchstart: a late change breaks one-finger handle drags |
M | M | touch-action: none on handle hit targets and in move mode, box keeps pan |
U2 |
| R-21 | Oversized shapes render thousands of handles | L | M | handle cap (T18) | U2 |
| R-22 | Keyboard gaps: no Insert or Delete on compact keyboards, Tab through every vertex, toast timing | M | M | Backspace and visible buttons, roving focus, persistent toast, live region | U2 |
| R-23 | Header undo after typing reverts the typing, not the previous action | M | L | flush the field first, pinned by a test | U1 |
| R-24 | Large test rewrite hides lost coverage | M | M | each removed assertion mapped to its replacement; verifier checks the mapping | U1, U2 |
| R-25 | Touch only tested in Chromium; WebKit and real tablets differ (LRN-108) | M | M | owner trial on a real tablet at U2 and U8 | owner |
| R-26 | Owner demos depend on the equine working copy blocked on the sandbox | certain | M | demo sheet provisioned through the application upload path | U1 |
| R-27 | Preview of a staged category form leaks into history | M | M | preview on the handle only, commit on Apply, restore on Cancel | U3 |
| R-28 | Two tabs on one draft: the second learns at its save; « Garder ma version » overwrites the first | H if used | M | unchanged from level 1; follow-up T14 | n/a |
| R-29 | Undo crosses a save; addDrawing outside history |
L | L | kept as built; stated in the trial guide | U8 |
| R-30 | 0.1.0 production reader behaviour on new PDFs unknown | unknown | M | read before any production release carrying U6 | release track |
| R-31 | Bounds-based overlap over-reports for concave shapes | M | L | conservative by design | U5 |
| R-32 | An old worker (rollback, stale image, second instance) passes a draft without the fixed categories | M | H | core gate at completion refuses a passed verdict from a pre-U6 core (T4); verified_with needs a U6 marker since every core reports 0.1.0 |
U6 |
| R-33 | The release replay judges published versions with the fixed-category rule and flags the historical equine version | M | M | the rule is a submission rule on drafts; the replay checks reading, fingerprint, validation, drawings (COMPATIBILITY §5) | release track |
| R-34 | The equine working copy and every pre-U6 draft fail verification under the absolute rule | certain | L | intended (T4); repair action in the editor; working copy converted at V1-2.8 (T6) | U6, V1-2.8 |
| R-35 | The navigation category (T10 B) shows up in the anatomical taxonomy or is used by a point or zone | M | M | absent from panels and pickers; navigation never given, changed or cleared by an edit, cat-access inserted only in the core-built access batch; edit refusal and verdict issue for an observable annotation in it; old readers see an ordinary category |
U6 |
| R-36 | Invented or unapproved normative text ships with U7 | L | H | U7 blocked until the owner's text, source and validation record; test fixtures only under tests/; review gate (T12) |
U7 |
| R-37 | A future feature lets a path into a document before the curves lot exists | M | H | dependency recorded in TODO.md (T16); path guarantee tests stay in the suites | future lots |
| R-38 | A path already sits in a database (direct RPC save or test fixture) that U6 or U8 reaches | L | M | read-only count before the new model is activated on an environment and before U6 or U8 reaches any environment beyond the throwaway sandbox; non-zero reopens T16 | U8, deploy |
| R-39 | The halted level-1 trial leaves defects unseen; level 1 read as validated | M | M | level 1 not declared validated (T11); residuals tracked in TODO.md; untouched criteria re-tested at U1 and U8 | U1, U8 |
Blocking criteria
Each line holds until its condition is met; nothing in this list authorises a sub-step by itself.
| Criterion | Holds | Condition to lift |
|---|---|---|
| U1 and every later sub-step | all code | a new explicit owner authorisation each (U0, documents only, authorised 2026-11-05) |
| T2/T3 proofs (COMPATIBILITY §8) | writing a key outside a test | every proof green and reviewed |
| T4 checks live on the environment | the U6 write lock | U6 migration (withdrawal, core gate, publication check, save check, rules epoch) first, then the U6 worker |
| T1 | U5 or U6 only if a measure exceeds 600 000 B | owner decision on the measured figure |
| T12 text | U7 | owner supplies the FR and EN text, its source and its validation record |
| T16 database count | activating the new model on an environment; U6 or U8 on any environment beyond the throwaway sandbox | read-only count of paths recorded and zero (non-zero reopens T16) |
| 0.1.0 reader check and release replay | any production release carrying U6 | R-30 read and recorded; replay green |
Dependencies outside the plan
- V1-2.8 (equine working copy) depends on U6 (roles, repair action) and on T6.
- The curves lot depends on U2 and U5 (handles, remap) and on T1 (a size lever is certain); it precedes any feature that lets a path enter a document.
- The registry id reconciliation with develop (LRN-095, BLK-013, RR-11 and RR-12) precedes the V1-2 merge.
Separate tracks (kept out, tracked in TODO.md)
- TOTP asked at sign-in for accounts with a factor.
- Historical equine drawings missing on the sandbox, which block the working copy.
- Full phone editing, a future lot after V1-2 (boards 14 to 16 kept as its reference).
- RR-12, the AAL2 token after factor removal (production prerequisite, unchanged by this plan).
- The curves lot (T16).