Files
faunosteo/docs/development/V1-2-6_UX_RISKS.md
T

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