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:
1 parent
ce2ec26112
commit
0476276a8f
19 files changed
+276
-112
No files matched your search
@@ -10,3 +10,20 @@ Will cover:
|
||||
- JSON attachment spec (EmbeddedFiles, afRelationship:Data)
|
||||
- Font handling (pdf-lib StandardFonts Helvetica/Times-Roman, WinAnsi; TTF Inter/Fraunces planned, not shipped)
|
||||
- Import/re-import roundtrip contract
|
||||
|
||||
## Attachment versions (Step 5)
|
||||
|
||||
The attachment `osteo-report.json` carries the Report **v3** document
|
||||
(`packages/domain/src/report/v3.ts`): zones by `(annotationId, viewId)`,
|
||||
findings by `(findingZoneId, path)` with label snapshots, severity codes,
|
||||
the `sheet` reference (sheet id, version id, sha256 of the document) and the
|
||||
reserved `localAnnotations`.
|
||||
|
||||
Import (`importReportFromPdf(bytes, migrationMap)`) accepts:
|
||||
|
||||
- v3: read as is;
|
||||
- v2 (PDFs produced by the application before Step 5, the practitioner's
|
||||
archive): migrated through the sheet's `report-migration-map.json`; a zone
|
||||
or finding the map cannot place is kept with its snapshots and flagged
|
||||
`unresolved: true`; the outcome reports `migrated` and the unresolved counts;
|
||||
- any other version: `ImportError('incompatible_version', foundVersion)`.
|
||||
Reference in new issue
Block a user