docs(docs): consolidate V1-2 contract with ratified O1-O23, open AR-1

This commit is contained in:
bchanot committed 2026-10-28 11:35:51 +01:00
1 parent 397d6007b4
commit 7fec2ce86f
7 files changed
+1621 -646

No files matched your search

+15 -2
View File
@@ -29,7 +29,7 @@ computer. Inventory: `.claude/audits/2026-10-25-functional-inventory.md`.
|---|---|---|
| P0 | Documents realigned on the code, decisions recorded (`OPEN_QUESTIONS.md` statuses) | none |
| V1-1 | Clients and animals of a practitioner's workspace, with the permission frame of future cabinets (`V1-1_OWNERS_ANIMALS.md`) | 12 reduced, frame of 10 |
| V1-2 | Anatomical sheets loaded from Supabase under control (no publication of the equine draft without the owner) | 13 reduced |
| V1-2 | Official anatomical sheets administered from the application: rights, structured editor, server-verified review and publication, catalogue; the equine sheet prepared, never published inside V1-2 (`V1-2_ANATOMICAL_SHEETS.md`, decisions ratified 2026-10-28, BDR-082) | 13, and 17 reduced to official sheets |
| V1-3 | Bilans persisted, linked to an animal, history | 14 (+ 11 skeleton if a quota applies) |
| V1-4 | Stored PDF artifacts and authorised sharing | 15 reduced, sharing part of 12 |
| V1-5 | Cross-cutting mobile and accessibility validation | design README, `TEST_STRATEGY.md` |
@@ -367,7 +367,7 @@ Name: Anatomical sheets in the database and official equine seed
Objective: Sheet and version tables with immutability, SVG assets in Storage, seed of the official equine sheet as a draft, SheetProvider over Supabase, read-only sheet library in the app.
Dependencies: Step 3, Step 4, Step 8
Changes expected:
- supabase: anatomical_sheets, anatomical_sheet_versions (content_jsonb + schema CHECK), immutability trigger on published rows, version numbering RPC, deprecate RPC, GC function with the four preconditions (no report, no fork, no grant, no pending process) returning candidates only (deletion job at Step 18), helpers can_use_sheet/can_fork_sheet (creator-only for now), operator upload of the drawings (`pnpm assets:upload`) and the generated draft seed. Publication of the official equine sheet is an explicit act of a platform admin after the business review of REVIEW-REPORT.md (BDR-034, BDR-037); no step publishes it automatically.
- supabase: anatomical_sheets, anatomical_sheet_versions (content + schema CHECK), immutability trigger on published rows, version numbering RPC, deprecate RPC, GC function with the four preconditions (no report, no fork, no grant, no pending process) returning candidates only (deletion job at Step 18), helpers can_use_sheet/can_fork_sheet (creator-only for now), operator upload of the drawings (`pnpm assets:upload`) and the generated draft seed. Publication of the official equine sheet is an explicit act of a platform admin after the business review of REVIEW-REPORT.md (BDR-034, BDR-037); no step publishes it automatically.
- packages/supabase: typed accessors; apps/app: SheetProvider.supabase replaces the bundled seed in production builds (bundled kept for tests), /app/anatomy read-only list and preview.
Tests: pgTAP: UPDATE on published content raises; v2 numbering; GC preconditions each individually; non-creator cannot read a private sheet; integration: seed is idempotent and byte-faithful (checksums).
Manual validation: open /app/anatomy, see "Faunosteo / Cheval / officielle" with its draft or published status, preview both views, click zones (no report yet).
@@ -384,6 +384,11 @@ candidates. Roadmap item V1-2 reduces the step to a controlled loading of the
sheets; whether a signed-in practitioner may load the unpublished draft is an
owner decision taken at V1-2.
Step 13 note (2026-10-28): V1-2 absorbs the provider and the library
(`V1-2_ANATOMICAL_SHEETS.md` §10, §11). Drafts are never served to readers
(D3); the catalogue is read under an explicit, provisional catalogue access
until the entitlements of Step 11 (O21). The GC candidates stay with Step 18.
```text
Step 14
Name: Cloud reports
@@ -444,6 +449,14 @@ Definition of Done: architecture Sprint 6 (except "promote manual point", added
Risks: largest UI step; split into sub-branches (canvas tools / panels / publish) each merged green behind a "beta" flag; feature parity gaps with the vanilla tool found late (mitigate with the reference tests first).
```
Step 17 note (2026-10-28): requirement D9 (BDR-081) moves the editor of
official sheets into V1-2, at the level 1 of `V1-2_ANATOMICAL_SHEETS.md` §8.2,
with server-verified review and publication. It supersedes, for official
sheets, the 2026-10-25 rule « no graphic editor until Step 17 »: the curation
pipeline stays the authority of the historical equine sheet only, whose work
moves to an application working copy (O17). Step 17 keeps personal sheets, the
level 2 editor (§8.3) and the community parts.
```text
Step 18
Name: Community