docs: sync drift after catalog v2.0 + i18n + WinAnsi hotfix

doc-syncer audit applied 10 AUTO patches and 1 HUMAN reword (#5)
across the doc set.

README.md:
- Test count "7 tests pass on skeleton" / "88 tests across 23 files"
  → "155 tests" / "155 tests across 29 files".
- Reword "Observation builder" bullet + add hierarchical findings
  tree + browser-detected locale bullets (HUMAN #5).
- Status paragraph: pathology DB "intentionally empty" → full
  26-zone v2.0 catalog (792 nodes, 612 leaves, 41 vet leaves).
- Documentation section: add PATHOLOGIES-FORMAT.md link; tidy the
  DEPLOY.md mention (DEPLOY.md itself comes in the next commit).

CLAUDE.md:
- Architecture block: "embedFonts (Inter body + Fraunces heading)"
  → reality (Helvetica + TimesRoman / WinAnsi StandardFonts; TTF
  Inter/Fraunces planned).
- PDF convention: "Fonts are TTF" → "Fonts are StandardFonts
  (Helvetica/TimesRoman, WinAnsi)" with the ASCII-surrogate caveat.
- Folder map: add src/anatomy/labels.ts, include zoneMatch.ts in
  src/lib/{...}.ts.
- i18n: locale default "fr" → "navigator-detected fr/en, or 'fr'
  if no match" to match commit 9cf8a66.

docs/PATHOLOGIES-FORMAT.md:
- "PDF surface: snapshot label is prefixed ⚠" → "(!)" in two
  places (after WinAnsi hotfix 143fdc3). Picker ⚠ statement
  kept — browser renders U+26A0 natively.

docs/ADDING-A-SPECIES.md:
- data-anno-category: "Free-form" → enum of 7 valid values per
  ANATOMY-SVG-CONVENTION.md; parser throws SvgConventionError on
  unknown values.
- Section 4 (findings catalog): cross-link to
  docs/PATHOLOGIES-FORMAT.md so authors find the v2.0 contract.
This commit is contained in:
Bastien Chanot committed 2026-05-21 04:13:13 +02:00
1 parent f4bb7cf9e0
commit 8385b49bbe
4 files changed
+35 -28

No files matched your search

+7 -4
View File
@@ -91,7 +91,7 @@ clickable element must carry:
| `data-anno-id` | yes | Stable identifier, unique within the SVG. The renderer treats it as opaque. |
| `data-anno-name-fr` | yes | French anatomical label. |
| `data-anno-name-en` | yes | English anatomical label. |
| `data-anno-category` | yes | Free-form string used for grouping (e.g. `articulations`, `cadrans-du-cr-ne`). |
| `data-anno-category` | yes | Must be one of the 7 valid values defined in [`ANATOMY-SVG-CONVENTION.md`](./ANATOMY-SVG-CONVENTION.md) (`articulation`, `charniere`, `spine-zone`, `os`, `os-overlay`, `head`, `cadran-crane`). Parser throws `SvgConventionError` on unknown values. |
| `data-anno-opens-detail` | no | Key of a detail popup SVG. Must match a key in the manifest's `details` map. |
| `data-anno-special` | no | Behavior hint. `vertebral-precision` opens the VertebraPicker on click. |
@@ -156,9 +156,12 @@ Two files:
`src/domain/species/<id>/pathologies.json` — authored tree of zones,
categories, sub-categories and leaves. The shape is defined by
`src/domain/schema/findings.ts`. The scaffold script ships a minimal
skeleton; populate the `zones` map by mirroring the equine reference at
`src/domain/species/equine/pathologies.json`.
`src/domain/schema/findings.ts`, and the full authoring contract
(structural rules, taxonomy patterns, v2.0 vet-referral policy,
changelog) lives in
[`docs/PATHOLOGIES-FORMAT.md`](./PATHOLOGIES-FORMAT.md). The scaffold
script ships a minimal skeleton; populate the `zones` map by mirroring
the equine reference at `src/domain/species/equine/pathologies.json`.
`src/domain/species/<id>/pathologies.ts` — loader:
+6 -4
View File
@@ -217,9 +217,11 @@ v2.0 purge). All in-tree consumers (`FindingsTreePicker`,
PDF `observationPage`) already key off the boolean.
Picker surface: a ⚠ badge is shown next to vet-flagged leaves. PDF
surface: the snapshot label is prefixed `⚠` in the
`CONSTATS — <ZONE>` section. If a `description_fr` is also present,
it is rendered as an additional context line below the children list.
surface: the snapshot label is prefixed `(!)` in the
`CONSTATS — <ZONE>` section (the picker `⚠` cannot be rendered until
the PDF font path migrates from WinAnsi StandardFonts to TTF). If a
`description_fr` is also present, it is rendered as an additional
context line below the children list.
---
@@ -346,7 +348,7 @@ required to re-render an existing report.
In the PDF, findings are grouped by `zoneId` (one
`CONSTATS — <ZONE>` section per zone) followed by a single
`CONSTATS LIBRES` section listing the free-text additions. Vet-referral
leaves are prefixed with ⚠ in the rendered list.
leaves are prefixed with `(!)` in the rendered list.
---