docs(docs): V1-2.6 UX owner ratification recorded, independent checks

This commit is contained in:
bchanot committed 2026-11-05 19:06:48 +01:00
1 parent e10f167a6d
commit bd444d6906
6 files changed
+713 -273

No files matched your search

@@ -0,0 +1,69 @@
# CONTRACT: V1-2.6 UX, owner ratification of the technical decisions recorded in the docs (2026-11-05)
- REQUEST (owner brief « FAUNOSTEO — V1-2.6 UX — Ratification des décisions techniques », 2026-11-05): record the
owner's answers to T11, T16, T2/T3, T4, T5, T9/T10 and T12 in `docs/development/V1-2-6_UX_DECISIONS.md` and the
associated documents; update risks, dependencies, blocking criteria and tests; add the wasm measuring learning to
the learnings registry, its wording checked against the size test really in the repository; independent review;
exact verdict and remaining blocking points. Documentation only; stop at the final technical checkpoint. The
validated UX choices are not reopened.
- OWNER ANSWERS (summary of the brief):
- T11 approved: stop the complementary trials of the old UX; keep the anomalies and the untested items in
tracking; never declare the old V1-2.6 fully validated.
- T16 conditional deferral: defer curve handle editing only if the audit confirms that no existing curved
annotation and no journey available today needs it; guarantee exact geometry; prevent any destructive
conversion; record full curve editing in an identified future lot.
- T2/T3 agreement in principle, conditional on proofs: optional fields in schema v2, omitted when absent, never
serialised as null by default; fill opacity 10 to 100 %; controlled widening of the snapshot reader;
demonstrate effects on fingerprints, Rust, SQL, PDF, worker, N-1 reader, R3/R4 and BDR-068; document that the
old application cannot be returned to after the new fields are written; never call it full backward
compatibility.
- T4 no residual gap allowed: define the fixed-category checks in the core and at the appropriate server
boundaries for save and publication; do not enable writing the new model before the necessary checks exist;
progressive rollout or functional lock if needed.
- T5 historical preservation: keep ids, names, colours, particular annotations and fingerprints of the historical
equine versions; role adaptation only on a working copy; test the conversion without mutating the originals.
- T9 explicit choice when an SVG is replaced: keep positions only if the framing is compatible and the checks
pass; reposition when the operation is safely supported; cancel without any change; no approximate automatic
transformation.
- T10 automatic access: prefer a system navigation type distinct from the visible anatomical taxonomy; check the
existing schema constraints before choosing an internal id or category; never categorise it arbitrarily as Os,
Articulations or Vertèbres.
- T12: principle of one versioned copy kept; final legal text, source and validation still to be supplied; U7
delivers no invented or unapproved normative text.
- Wasm learning: margin measured with the exact method of the budget test (Node gzipSync with the same
parameters), never a system gzip; reference 592 143 B for a limit of 600 000 B, margin 7 857 B; measure after
each core change; never raise the ceiling silently.
- ACCEPTANCE CRITERIA:
- K1 T11: DECISIONS records the approval; level 1 explicitly not declared validated; the anomalies and untested
items are listed with their sources and tracked in `.claude/tasks/TODO.md`.
- K2 T16: the audit evidence is present and exact (counts and file:line hold in the code); the guarantee of exact
geometry and of no conversion is written, with tests; any limit of the audit is stated rather than hidden; the
future lot is identified in TODO.md with its dependency rule; stale « U9 in V1-2.6 » wording is gone outside
historical records.
- K3 T2/T3: the serialisation rule, the 10-100 range and a bounded definition of the snapshot widening are
written; a proof is listed for each of fingerprints, Rust, SQL, PDF, worker, N-1, R3/R4, BDR-068; the
impossibility of returning to the old application is documented; no text calls the change full backward
compatibility (or equivalent) without that qualifier.
- K4 T4: checks are defined in the core and at server boundaries for both save and publication; no residual gap
is accepted silently (any remaining choice is stated as an open owner question); writing the new model is gated
on the checks being live (order or lock written).
- K5 T5: the preservation list, the working-copy-only rule and a conversion test that proves the originals
unchanged are written.
- K6 T9: the three actions with their conditions are written; no automatic or approximate transformation remains
anywhere in the docs.
- K7 T10: the schema constraints are checked with evidence before a choice; the choice is a navigation type or
internal category outside the visible taxonomy; nothing assigns the access to Os, Articulations or Vertèbres; an
unratified part is stated as open.
- K8 T12: U7 is blocked until the text, its source and its validation exist; no normative wording is written.
- K9 The learnings registry holds the wasm entry, written through `memory.sh`; its wording matches
`packages/core-wasm/tests/size.test.ts` (call, parameters, file, limit, comparison) and the figures.
- K10 Risks, dependencies, blocking criteria and tests are updated and consistent with K1-K9.
- K11 No contradiction across the five docs, TODO.md and BDR-100 (superseded recommendations are marked as
withdrawn, not left active).
- K12 Scope: the change set touches only the FILE SCOPE; no validated UX choice is reopened.
- FILE SCOPE: `docs/development/V1-2-6_UX_{DECISIONS,COMPATIBILITY,TESTS,RISKS,PLAN}.md`, `.claude/tasks/TODO.md`,
`.claude/memory/{learnings,decisions,journal}.md` (through `memory.sh`), this contract.
- OUT OF SCOPE: any change under `crates/`, `apps/`, `packages/`, `supabase/`, `scripts/`; SQL; worker; Supabase
DEV; contract amendments of U0 (`V1-2_ANATOMICAL_SHEETS.md`, the level-1 contract, `.claude/rules/`); merge;
deploy; V1-2.7; any implementation sub-step.
- ABANDON: if a criterion needs a change outside the file scope, stop and report.