docs(chore): step 5 — annotation rendering contract, CLAUDE.md map and conventions, README, DEPLOY SHEET_BUNDLE, PDF format v3, spec §6 migration map, plan/changelog/strategy notes; BDR-038, LRN-043, TODO

This commit is contained in:
bchanot committed 2026-10-10 11:41:55 +02:00
1 parent ce2ec26112
commit 0476276a8f
19 files changed
+276 -112

No files matched your search

+11
View File
@@ -22,6 +22,9 @@ evolves without a big-bang rewrite. The step-by-step schedule is in
## 2. `reportStore`
Status 2026-10-10: moves A and B done in Step 5 (`state/persistence.ts`,
Report v3 in `packages/domain/report`); move C pending (Cloud reports).
Today: Zustand store holding `Report | null`, 14 actions, a `subscribe` that
mirrors every change to `sessionStorage['osteo:draft']`, restore on boot via
`ReportSchema.safeParse` (`reportStore.ts:42-56`, `159-167`).
@@ -39,6 +42,10 @@ UI state stay client-only.
## 3. Anatomy domain
Status 2026-10-10: points 1, 2, 4, 5 and 6 done (Steps 4, 4b, 5). Point 3 differs:
ids are stable slugs, not UUIDs (BDR-031/034). The renderer emits elements from
the document's geometry, not attributes on legacy elements (docs/ANNOTATION-RENDERING.md).
Today: four sources with no common object (manifest TS, two SVG files
fetched from `public/`, catalog JSON bundled), link by fuzzy label at render
time (audit 02 §1, 06 §1).
@@ -82,6 +89,10 @@ Evolution:
## 4. PDF
Status 2026-10-10: Step 5 took the sheet as export input and attached v3 with
v2 import; points 2 (sheet snapshot in the attachment), 3 (server import) and 5
(branding object) stay for Step 6.
Today: `exportReportToPdf(report, { locale })` re-fetches SVGs from
`public/`, re-parses them for labels, reloads the catalog through the
registry, rasterises in the browser, attaches the raw `Report` JSON.