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

5.9 KiB

V1-2.6 UX redesign: risk register

Status: PROPOSAL, 2026-11-05, revised after the independent review. Companion of V1-2-6_UX_PLAN.md. Blocking 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 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 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 U6 review
R-3 Direct save, or « Garder ma version » from an older bundle, strips roles of a never-published sheet M M report issues against the base; residual accepted under T4, visible in the general review 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 U9, tested with up upgrade and live rounds U6, U9
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 M M measure after each op; T1 fallback; PDF split never on the critical path U5, U6
R-9 Rollback below U6 impossible once a New-present document exists (drafts unreadable by the old app and worker, published rows immutable, migrations forward-only) certain after U6 H 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 Automatic remap moves correct annotations of a drawing cut from the same master H if automatic M explicit choice; positions kept when viewBox equals the crop (T9) 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

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