44 lines
4.0 KiB
Markdown
44 lines
4.0 KiB
Markdown
---
|
|
paths: ["crates/core/src/domain/sheet/**", "docs/development/ANATOMICAL_SHEET_MODEL.md", "docs/development/V1-2_ANATOMICAL_SHEETS.md", "supabase/seed/anatomical-sheets/**", "crates/core/src/bin/upload_sheet_assets/**"]
|
|
---
|
|
|
|
# Anatomical sheet model (crates/core/src/domain/sheet + migration 20261008110000)
|
|
- `docs/development/ANATOMICAL_SHEET_MODEL.md` is the source of truth for the model as built: document shape, issue
|
|
codes, tables, RPCs. `docs/development/V1-2_ANATOMICAL_SHEETS.md` holds the ratified V1-2 rules (O1-O23, BDR-082):
|
|
every V1-2 change follows it, and V1-2.9 folds it back into the model file.
|
|
- Ids are stable slugs never derived from labels; labels are `{ fr, en }` objects. Annotation → findings is the
|
|
explicit `finding_zone_id`; vertebral regions are ordered data with free codes. No label matching at runtime.
|
|
- A published version is immutable (trigger, every role) and, from V1-2, never deleted, even deprecated. Change = new
|
|
draft (`create_sheet_draft`) then publication; from V1-2, publication only from an approved round on a server
|
|
verdict of the core.
|
|
- The Rust core is the only authority on document rules (O22): add a rule to `validate_sheet_document` and to the spec
|
|
table only. A rule that must not strip existing fingerprints or reject old snapshots lives in `edit.rs` (editor
|
|
refusals) and in the verdict-only tier of `sheet_report`, never as a `validate.rs` error (V1-2.6 fixed categories,
|
|
T4). V1-2 (M5) dropped the SQL mirror (`private.sheet_document_issues`); SQL keeps the structural and relational
|
|
guards, the declared status check and, from V1-2.6 U6, the two declared fixed-category checks (save
|
|
non-regression; approval and publication), which hold the fixed-category invariants only (contract §12.2,
|
|
§17.12). Never add any other business rule in SQL.
|
|
- Document schema change → bump `SHEET_DOCUMENT_SCHEMA_VERSION`, extend the SQL CHECK on `document_schema_version`.
|
|
No bump during V1-2 (BLK-008). Ratified exception (V1-2.6 T2, BDR-100, BDR-101): an optional key omitted when
|
|
absent (`skip_serializing_if`, `js::present`, `ts(optional)`, an explicit `null` refused, never defaulted in the
|
|
fingerprinted document) is not a version change; it ships only with the proofs of
|
|
`docs/development/V1-2-6_UX_COMPATIBILITY.md` §8, and its first write is a point of no return (one-way
|
|
compatibility, never called full backward compatibility).
|
|
- Historical equine sheet `503dc301…` = generated seed `draft/` (`pnpm import:equine --out` into an empty folder, then
|
|
reviewed and copied; never edit `legacy-import/` or `draft/` by hand; `curation_draft` / `curation_review` fail on
|
|
drift, `pnpm import:equine --check` lists it). Its content changes only through `curation/changes.json` (traced in
|
|
CHANGELOG.md), and the pipeline stays unchanged during V1-2. It is never published; equine work moves to an
|
|
application working copy (O17), whose publication is an owner act after the business review.
|
|
- Sheet SVG bytes live in Storage bucket `anatomical-sheet-assets` as `<sha256>.svg`, never overwritten. Until M5
|
|
(V1-2.1) uploads are an operator task (`pnpm assets:upload <seed dir>`, local stacks, service key in env); from M5,
|
|
editors upload from the application after the core's cleaning, and the worker verifies every submitted revision (M6).
|
|
- Omitted `review_status` means `inherited` (`#[serde(default)]`): any check on statuses treats an absent value as
|
|
`inherited`.
|
|
- Since V1-2.2 the core also holds the review model (`review.rs`: groups, digests, `coverable`, change list), the server
|
|
verdict (`verdict.rs`, the shape the M5 SQL reads; the function is never exported to the browser, only its TypeScript type for the
|
|
review screen), the document measure (`size.rs`:
|
|
PostgreSQL's `jsonb` text, never `JSON.stringify`), `PreviewSheet` and the editor's commands (`edit.rs`, the §6.6
|
|
marking rules). A change to the SVG reader, the rules, the caps, the fingerprint or the digests is a core change
|
|
(contract §6.4: the release withdraws the rounds of drafts in flight; a published version's round stays approved).
|
|
RUST.md §12.
|