79 lines
10 KiB
Markdown
79 lines
10 KiB
Markdown
# 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).
|