Files
faunosteo/CHANGELOG.md
T
Bastien ChanotandClaude Opus 4.6 2d6ed809e2 chore: rename Zoosteo → Faunosteo across entire project
Brand strings, config defaults, i18n dicts, PDF attachment metadata,
HTML titles, Docker container name, package name, repo URLs, deploy
paths, and all documentation updated. Git remote switched to
faunosteo.git. Domain URLs (zoosteo.fr) preserved — DNS update is
separate. 155/155 tests green.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-05-22 21:44:21 +02:00

190 lines
9.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Changelog
All notable changes to **Faunosteo** are documented here.
Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
Versions follow [Semantic Versioning](https://semver.org/).
## [Unreleased]
### Added
- _(nothing yet)_
### Changed
- _(nothing yet)_
### Fixed
- _(nothing yet)_
---
## [1.0.0] — 2026-05-21
First public release. Single-praticien web app for veterinary
osteopathy bilans on animal anatomy SVGs. Static SPA, no backend, no
auth; the exported PDF is the long-term record, with the full report
JSON embedded as a native PDF attachment so re-importing the PDF
restores the session for a follow-up.
### Added
- **Anatomy canvas** — inline SVG with clickable zones, hitbox+visible
twin pattern, delegated click listener, async-mount safe.
- **Detail popups** — click a zone (e.g. head) to open a secondary SVG
with finer-grained zones. Independent bones map, fallback lookup
across main + detail.
- **Vertebra picker** — region tabs (C/T/L/S/Cd) with multi-select chip
grid; region tab preselected from the clicked zone label.
- **Hierarchical findings tree** — per-zone picker with breadcrumb
drill-down, leaf toggle, vet-referral badge, count badges on
intermediate nodes, scope-disclaimer modal shown once per session.
- **Bilingual UI (FR / EN)** — full i18n via flat dict + `useT()` hook,
language switcher in every header, locale persisted to
`localStorage`, default auto-detected from the browser.
- **PDF export** — A4 portrait with rasterized anatomy SVGs (canvg
@ 2×), structured per-zone observation sections (`CONSTATS — <ZONE>`
+ `CONSTATS LIBRES`), severity pill, conclusion page, locale-aware
static labels. Inter-item separator rendered as accent-coloured
bold bullet.
- **PDF import** — Zod-validated re-import of a previously exported PDF
restores the entire session. Typed `ImportError` (discriminant +
`foundVersion`) with i18n-resolved user-facing messages.
- **Practitioner cache** — last-used practitioner block prefilled via
`localStorage`.
- **Runtime identity** — `APP_SITE_NAME` / `APP_BRAND_NAME` /
`APP_FOOTER_NAME` / `APP_TAGLINE` injected into `env.js` at container
start; no rebuild required for brand changes.
- **Species auto-discovery** — drop a `src/domain/species/<id>/index.ts`
default-exporting a `SpeciesManifest` and the species appears in the
picker. `pnpm scaffold:species` writes a valid skeleton.
- **Findings catalog v2.0** — full equine catalog authored by the
domain expert: 26 zones (9 head + 17 body), 792 nodes, 612 leaves,
41 vet-referral leaves. Schema documented in
[`docs/PATHOLOGIES-FORMAT.md`](docs/PATHOLOGIES-FORMAT.md) with the
3 standardized categories per zone, 5 taxonomy patterns for
dysfunctions, structural authoring rules (depth ≤ 4, ≥ 2 children
per intermediate, sibling-scoped ID uniqueness), and the legal-scope
disclaimer.
- **Fuzzy zone matcher** — SVG `data-anno-name-fr` / `-en` ↔ JSON
`zone.name_fr` / `name_en` bridged via normalize + Levenshtein
(EN-first, FR fallback). Tolerant of case, accents, and minor typos.
- **Docker delivery** — multi-stage `Dockerfile` (node:20 → nginx:alpine),
`docker-compose.yml`, `entrypoint.sh` runtime env injection, nginx
SPA fallback + `env.js` no-cache rule. Production deploy guide in
[`DEPLOY.md`](DEPLOY.md).
- **Documentation** — `README.md`, `CLAUDE.md` (project conventions
for Claude), `docs/ANATOMY-SVG-CONVENTION.md` (SVG data-* contract),
`docs/ADDING-A-SPECIES.md` (recipe for a new species),
`docs/PATHOLOGIES-FORMAT.md` (findings JSON authoring contract),
`docs/PDF-FORMAT.md` (PDF layout placeholder), and project-state
notes under `.claude/{tasks,memory,audits}/`.
### Changed
- **Report schema v1 → v2**: `Observation` carries hierarchical
`findings: Finding[]` (zone + path + snapshotted FR/EN label + vet
flag) and `freeTextFindings: string[]`; old `pathologyIds` /
`freeTextPathologies` removed. `ReportSchema.version` bumped `1` → `2`.
v1 PDFs are not migrated — they hard-fail import with a
version-specific message (no install base to justify a migration
shim).
- **Catalog v1.2 → v2.0 contract**: `requires_vet_referral` boolean is
now the **sole source of truth** for the vet-orientation flag.
Generic "orienter vers vétérinaire" wording purged from
`description_fr` on 25 leaves where the boolean alone sufficed.
16 leaves carrying a clinical differential (cause neuro/sinusale/
ligamentaire/etc.) keep their `description_fr`. Consumers relying on
`description_fr.includes('vétérinaire')` must migrate — all in-tree
consumers already key off the boolean.
- **PDF locale = render preference**, not a schema field. Finding
snapshots already carry both FR and EN labels (`labelFrSnapshot` /
`labelEnSnapshot`), so `exportReportToPdf(report, { locale })`
picks the right snapshot at render time without a schema bump.
- **PDF date format** — locale-aware via `formatDate(iso, locale)`,
replacing the FR-only `formatDateFr` helper.
- **Default branch** — `main` → `master` (matches the Gitea remote at
`https://git.bchanot.fr/bchanot/faunosteo.git`).
### Fixed
- **PDF export crashed** `WinAnsi cannot encode "⚠" (0x26a0)` whenever
an observation carried a `requires_vet_referral` finding —
`pdf/fonts.ts` embeds `StandardFonts.Helvetica` which uses WinAnsi
(cp1252, Latin-1 only). PDF vet-referral marker swapped `⚠ ` →
`(!) `; picker DOM keeps `⚠` (browsers render U+26A0 natively).
Regression test added on `widthOfTextAtSize` + prefixed label.
Follow-up tracked: switch PDF body to embedded TTF
(Inter / Fraunces per `CLAUDE.md` spec) so future non-Latin-1 glyphs
work without ASCII surrogates.
- **PDF import error messages** localized via typed `ImportError`
discriminant — the prior FR-only messages leaked through to the EN
UI on import failure.
- **Detail-popup zone clicks** silently dropped — main-only bones map
did not know detail SVG ids; fallback lookup `bones.get(id) ??
detailBones.get(id)` added in the shared click handler.
- **PDF text overlap** — `drawText({ maxWidth })` wraps glyphs but not
the cursor; caller now measures with `widthOfTextAtSize` and
advances cursor per wrapped line.
- **PDF multi-SVG layout** — observation pages with N SVGs overflowed
page bounds. Now: pre-rasterize all, measure aspect, reserve
text-area height, derive cell budget per row; single-SVG layout
halved + centered.
- **PDF anatomy rasterization leaks** — interaction-only attributes
(`data-anno-*`, transparent hitboxes, faint default fills) stripped
before raster, non-selected zones hidden, selected zones recoloured.
- **Zone highlight scoping** — collapsed observations no longer leave
faint tints on the canvas; highlights re-painted after async SVG
mount so detail-popup zones colour correctly.
- **Hyoid label case** — SVG `data-anno-name-fr="hyoïde"` →
`"Hyoïde"` to match the JSON strict-equality rule across all 26
zones (fuzzy matcher still acts as safety net).
- **i18n key parity** — fr/en dicts validated by a parity test
(`Object.keys(fr).sort()` deep-equals `Object.keys(en).sort()`) so a
missing translation fails CI instead of falling back to the key
literal at runtime.
### Known limitations
- PDF body fonts are `StandardFonts.Helvetica` / `TimesRoman`
(WinAnsi / Latin-1) instead of the planned TTF Inter / Fraunces.
Any non-Latin-1 glyph in PDF text needs an ASCII surrogate until
the TTF migration lands.
- `description_fr` for sensitive vet-referral leaves and the
`scope_disclaimer` are FR-only; vet-expert authoring is needed for
the EN copy.
- Only the equine species ships. The infrastructure (manifest +
auto-discovery + scaffold script + schema) accepts any species —
domain expert authoring is the gating step.
- No backend, no accounts, no cloud sync. Each PDF is the long-term
record for the corresponding bilan.
---
## Pre-1.0 milestones (for reference)
These were never tagged but are reflected in git history on `master`.
- **Scaffold (2026-05-18)** — initial skeleton from approved design
spec: 80+ files (schemas, stubs, routes, stores, PDF modules, Docker
infra), real `Horse.svg` + `Horse_head.svg`, `pnpm`/`build`/
`typecheck`/`tests` all green.
- **Editor polish (2026-05-19)** — detail-popup click bridge,
VertebraPicker auto-region, PDF rendering fixes (header rule clear,
text-line wrapping, multi-SVG grid, halo glow), eyebrow + Times 22
title + accent severity pill.
- **Findings tree pivot (2026-05-20)** — B0 schema (`findings.ts`
Zod), B1 Report schema v2 (`Observation.findings`), B2 UI
(`FindingsTreePicker` replaces flat `PathologyPicker`), B3 i18n
FR/EN site + PDF, B5 stub cleanup. `requires_vet_referral` boolean
introduced alongside the textual fallback.
- **Catalog v2.0 + WinAnsi hotfix (2026-05-21)** — full 26-zone horse
catalog landed, `requires_vet_referral` becomes the sole source of
truth, PDF vet marker swapped to a WinAnsi-safe surrogate. Docs
refreshed, `DEPLOY.md` + `CHANGELOG.md` written, default branch
renamed `master`, repo pushed to `https://git.bchanot.fr/bchanot/faunosteo.git`.
[Unreleased]: https://git.bchanot.fr/bchanot/faunosteo/compare/v1.0.0...HEAD
[1.0.0]: https://git.bchanot.fr/bchanot/faunosteo/releases/tag/v1.0.0