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>
14 KiB
Journal
2026-05-18
Scaffolded Osteo Report MVP skeleton from approved design spec. Created 80+ files: schemas, stubs, routes, stores, PDF modules, Docker infra. Moved Horse.svg + Horse_head.svg to public/species/equine/. pnpm install + build + typecheck + tests passing. pnpm 11 used (corepack shim broken on host Node 20.20.0).
- MVP scaffold+impl done. Editor flow works. PDF roundtrip green. Real SVG assets in repo.
2026-05-19
Fixed 3 zone-interaction bugs (b9da4fa). Detail-popup clicks now resolved via detailBones map.
Spine zones (data-anno-special="vertebral-precision") auto-open VertebraPicker on click.
ObservationCard hides "Vertèbres…" button on non-special zones.
Parser reads data-anno-special; convention doc updated.
- BLK-003 resolved. LRN-004, LRN-005 captured. 91 tests green, lint clean, build OK.
- VertebraPicker preselects region tab inferred from zone label (
b3bd75d). +5 tests. - Hotfix: detailBones now accumulate across popup opens; merged allBones passed to ObservationList so detail-popup zone labels survive after modal close.
- PDF rendering bugfix: titles cleared the header rule, zone-line wrap respects following blocks, non-selected zones hidden + data-anno-* stripped before raster, main SVG skipped when every zone lives in details. BLK-004, LRN-006, LRN-007 captured.
- PDF styling pass: eyebrow + Times 22 title + 2pt accent rule + uppercase accent section labels + color-coded severity pill (sage/amber/red). Eyebrow/title baseline gap raised to 27pt after first attempt still overlapped. BDR-008, LRN-008 captured.
- Commits this session: b9da4fa..d7ea99e (10 commits — bugfix + feat + hotfix + PDF styling).
2026-05-19 (session 2)
feat(editor): home-nav (back btn + clickable Brand link to "/") + "Modifier les infos" dialog reusing PractitionerForm/AnimalForm via draft-copy with save/cancel. 3 store setters (setPractitioner/setAnimal/setOwner), 4 setter tests. Cache re-synced on save. 100/100 tests, lint 0, typecheck clean.
- hotfix(pdf): multi-SVG observation page packed into 2-col grid; pre-rasterize → measure aspect → reserve text-area height → cell budget per row; single-SVG keeps full width; floor prevents zero-cells. Text sections now always visible. LRN-009 captured.
- hotfix(editor): zone-highlight scoped to active obs only (collapsed obs no longer leave faint 'linked'/'multi' tints). AnatomyCanvas re-paints highlights after async SVG mount so DetailModal popup zones color correctly. NewReportRoute header harmonized with editor — back btn + clickable Brand left-aligned. 3 files (hotfix cap +1, accepted). LRN-010 captured.
- domain pivot decided: flat Pathology[] → hierarchical findings tree per zone, path+snapshot serialization, FR/EN bilingual site+PDF. ReportSchema bumps v1→v2 (no retro-compat, no prod PDFs). Sample 3-zone JSON v1.1 dropped at src/domain/species/equine/pathologies.json — inert (loader not migrated). TODO rewritten as B0..B5 + C ship gate, ~23h dev.
- NEXT SESSION: run /ship-feature on B0 (findings Zod schema + JSON loader) + B1 (ReportSchema v2 + observation.findings) + B2 (FindingsTreePicker replacing flat PathologyPicker). I18N (B3) deferred to separate feature. Reconcile JSON species.id (currently "equin") vs registry species.id ("equine") before parse — pick one.
2026-05-20
Bundled B0+B1+B2 shipped on feat/findings-tree-v2. 3 atomic commits.
- B0 (
f80e161): findings.ts Zod schema (recursive z.lazy + explicit ZodType), SpeciesFindingsSchema.parse(JSON) at boot, manifest swaps pathologies→findings, JSON species.id "equin"→"equine", new species.equineFindings test (5). - B1 (
d08d773): ObservationSchema.findings + freeTextFindings, ReportSchema.version 1→2, store emptyObservation+initReport updated, PDF import detects v1 via IncompatibleReportVersionError + ImportError wraps message (FR), pathology.ts schema + test deleted. - B2 (
b67f4cd): FindingsTreePicker (breadcrumb, drill, leaf toggle, retour, vet-referral ⚠, description_fr), ObservationCard renders one picker per zone with catalog, FreeTextPathologyInput renamed FreeTextFindingInput, scope_disclaimer modal once/session via osteo:disclaimer-shown sessionStorage flag, PDF observationPage renders findings via labelFrSnapshot with ⚠ prefix on vet-referral. B5 folded in: Toast + ZoneTooltip stubs deleted, CLAUDE.md folder map refreshed. - 107/107 tests green, lint 0 warn, typecheck clean, vite build OK (882KB main + 15KB lazy pathologies chunk).
- BDR-009 (snake_case JSON fields preserved in TS), LRN-011 (Zod recursive via z.lazy + explicit ZodType), LRN-012 (sessionStorage flag pattern for once-per-session UX modals) to capitalize.
- NEXT: push branch + PR. After merge: B3 (i18n FR/EN) + B4 (PDF observationPage polish for vet-referral) + C (full horse.json + QA + deploy).
2026-05-20 (session 3 — B3 shipped)
B3 (i18n FR/EN site + PDF) shipped on feat/findings-tree-v2 via /ship-feature. 5 new commits:
0a05c47docs(plan): B3 i18n FR/EN implementation plana570475feat(i18n): localeStore + persist359104cfeat(i18n): fr/en dicts + useT hook (~90 keys each, parity-tested)d602726feat(i18n): migrate site + PDF to locale-aware (25 files, +390/-207)fa3eb51test(pdf): roundtrip per locale (3 cases)- (post-review fix) typed ImportError discriminant for localized PDF import errors
- 154/154 tests pass, lint clean, typecheck clean, build OK.
- description_fr + scope_disclaimer stay FR-only this iteration (vet-expert authoring needed).
- BDR-014 (PDF locale = render preference), BDR-015 (typed ImportError discriminant), LRN-017 (dict parity test), LRN-018 (useT selector+closure), LRN-019 (exhaustive-deps closure trap), EVAL-002 (review caught FR leak in PDF import) captured.
- NEXT: B4 (PDF observationPage vet-referral polish), C (full horse.json + QA + Scaleway deploy). description_fr/_en EN copy when vet expert provides.
2026-05-21
User dropped catalog v1.2→v2.0 in place. pathologies.json now schema_version "2.0", 26 zones (was 3), 792 nodes, 612 leaves, 41 vet-referral leaves. Generic vet description_fr purged on 25 leaves; 16 kept with clinical differential.
- Zero code change needed:
findings.tsZod schema already optional description_fr + boolean requires_vet_referral since B0. FindingsTreePicker + PDF already read boolean (no textual fallback). 154/154 tests stay green, typecheck clean. - One case mismatch noted then fixed by user: SVG Horse_head.svg
data-anno-name-fr="hyoïde"→"Hyoïde". JSON ↔ SVG strict equality now holds for all 26 zones (diff empty). Fuzzy matcher (lib/zoneMatch.ts) no longer needed for this pair but kept as safety net. - BDR-016 (v2.0 catalog adoption), LRN-020 (forward-compat schema absorbed change), BLK-002 resolved capitalized.
- TODO Phase C item 1 "Author full horse.json" → done. B4 still has scope_disclaimer footer decision open.
- NEXT: B4 disclaimer footer call + C QA + Scaleway deploy.
- hotfix(pdf): PDF export crashed
WinAnsi cannot encode "⚠"on any obs carrying a requires_vet_referral leaf — StandardFonts.Helvetica is WinAnsi-only. Swapped⚠PDF marker →(!)(UI keeps ⚠). Regression test added onwidthOfTextAtSize+ prefixed label. LRN-021, EVAL-003 captured. 155/155 green. Follow-up: migrate PDF body to embedded TTF (Inter/Fraunces per CLAUDE.md spec) so future non-Latin-1 glyphs work. - chore: rename project
osteo-report→zoosteo→faunosteo(Gitea repo moved). 15 files: repo URLs (CHANGELOG, DEPLOY, package.json), brand strings (env.ts DEFAULTS, entrypoint.sh fallbacks, i18n fr/en, pdf attachment metadata, index.html title, Brand test, scaffold banner, README/CLAUDE/CHANGELOG/ADDING-A-SPECIES headings), example URL osteo.example.com → zoosteo.fr in DEPLOY.md. PDF FILENAMEosteo-report.json+ startsWith contract preserved. 155/155 tests green. Commit7dd4f63+ push. - fix(docker): pin
pnpm@11.1.3in Dockerfile:7.corepack prepare pnpm@latestre-resolved to pnpm >=11.4 on VPS cold build, which needs Node 22.13 →ERR_UNKNOWN_BUILTIN_MODULE: node:sqliteon Node 20 image. Commit7dccde7+ push. BLK-005 + LRN-022 captured. - fix(docker) v2: 11.1.3 pin insufficient — pnpm 11.x ENTIRE LINE imports
node:sqlite(not just 11.4+). Local dev was misleading because pnpm install never re-ran on host. Downgrade Dockerfile topnpm@10.13.1(last 10.x cached on host, reads lockfile v9 unchanged). Commit990c8e7+ push. BLK-005 + LRN-022 corrected with iteration log. - chore(docker): pin
container_name: faunosteo-webin docker-compose.yml — Compose v2 always appends-1replica suffix; single-instance service doesn't need scaling. DEPLOY.md log-prune command updated. Commit7d214ed. - fix(docker): nginx template used bash-style
${PORT:-8080}but envsubst doesn't support:-default. Switched to plain${PORT}since entrypoint.sh already exports PORT with default. Commit0fcc526. - feat(ui): global footer (© year + brand + "Powered by ZenQuality" logo linking to zenquality.fr). New Footer.tsx mounted via flex-column layout in App.tsx so it sticks bottom on every route. Two i18n keys added (footer.all_rights_reserved, footer.powered_by). Commit
caac149. - feat(ui): unify header — tagline next to brand on left for every page; LanguageSwitcher far right everywhere; dropped redundant "← Accueil" button on /new + /editor (brand is already a link to /). 3 files. Commit
1b01744part 1. - fix(editor): scroll(0,0) on mount — long /editor page was landing at bottom on navigation due to browser scroll restoration. Commit
1b01744part 2. - feat(editor): directional slide+fade between findings-tree levels (motion.ul, key-remount, 180ms). Forward enters from right, back enters from left. AnimatePresence omitted to keep test assertions synchronous. Commit
adbab1b.
2026-05-22 (session 2)
- feat: locale-aware hover tooltip on anatomy zones (AnatomyCanvas custom floating tooltip, replaces native SVG title).
- feat: /editors listing page + footer "Éditeurs" link + "Paws iin Harmony" credit.
- feat(i18n): SVG editor header navbar + 58 FR/EN keys; pathology editor header + 76 FR/EN keys. Both editors fully bilingual.
- fix(ui): 3 iterations on vertical centering — h-full→flex-1 on route containers (LRN-027). App.tsx main needs flex flex-col for children to grow.
- Commits 569e571..89e010c (9 commits). 155/155 tests green throughout.
2026-05-22
Integrated standalone editor.html (~1630 lines vanilla JS SVG annotation tool) into React app at /svg-editor route. Vanilla JS wrapped in useRef+useEffect — zero behavior loss. CSS restyled to Faunosteo tokens (warm palette, accent vars, serif headings). DOMParser used for safe SVG loading (no innerHTML). Page noindexed via dynamic meta tag. 3 files created (SvgEditorRoute.tsx, svg-editor.css), 1 modified (App.tsx route registration), CLAUDE.md folder structure updated.
- 155/155 tests green, typecheck clean, build OK (941KB main). No regressions.
- BDR-017 (vanilla wrap decision), LRN-022 (DOMParser SVG loading) captured.
- feat(editor): standalone pathology-editor.html — JSON pathology tree editor with SVG zone selection. 1390 lines vanilla JS/CSS, zero deps. Pre-wired species list + manual upload. Fuzzy zone matching ported from zoneMatch.ts. Recursive tree editor: add/edit/delete nodes, sources management, auto ID generation. SVG sanitized (scripts/foreignObject/on* stripped). Export full JSON preserving all zones. public/species/equine/pathologies.json added for HTTP access. Docs synced (CLAUDE.md + README).
- BDR-020 (standalone HTML not React route), BDR-021 (inline port of zoneMatch.ts), LRN-025 (importNode XSS), LRN-026 (inline port pattern) captured.
2026-05-20 (session 2)
Iterated on the findings-tree branch — 11 more commits on top of B0+B1+B2.
1731adffix(editor): match findings tree to SVG zones via FR label (strict equality, dropped raw-boneId lookup).95d746bfeat(editor): fuzzy zone matcher (src/lib/zoneMatch.ts) — normalize + Levenshtein, EN-first + FR fallback. 23 new tests.34acb0cfeat(editor): count badges on intermediate FindingsTreePicker nodes (pathStartsWith + countSelectedUnder).93294a4fix(pdf): buildZoneLabels per-source try/catch + parallel + warn + exported for tests. Fixes raw-boneId fallback when detail SVG fetch fails.1e12f22fix(editor): EditorRoute eagerly preloads every species.details SVG so re-imported PDFs render their pickers immediately.de40c5ffeat(editor+pdf): per-zone PDF sections "CONSTATS — " + dedicated "CONSTATS LIBRES"; ObservationCard accordion (one zone picker open at a time).add408efeat(pdf): single-SVG observations halved + centered; first halo glow on main-view selections.4f8ea9efix(pdf): bumped halo with stacked feGaussianBlur (stdDeviation 18 + 8) to survive the SVG→canvas→PNG→pdf-lib alpha attenuation.700567ffeat(pdf): inter-item separator rendered as accent-coloured bold "•" @14pt with per-segment layout instead of plain join (height-estimator updated).70b7f20feat(species): auto-discover species via import.meta.glob default-export contract +pnpm scaffold:speciesNode script + docs refresh.70f21ccdocs: PATHOLOGIES-FORMAT.md — canonical findings-JSON spec mirroring src/domain/schema/findings.ts.- BDR-012 (auto-discovery import.meta.glob), BDR-013 (fuzzy FR/EN label bridge), LRN-013 (glob+default plugin pattern), LRN-014 (normalize+Levenshtein cross-walk), LRN-015 (per-source try/catch), LRN-016 (pdf-lib subset-font bytes-grep caveat) captured.
- Tests 139/139 green, lint 0, typecheck clean, vite build OK throughout. Branch feat/findings-tree-v2 = 15 commits ahead of main, no remote configured (push + PR still pending).
- NEXT: push branch + PR; then B3 (i18n FR/EN), B4 (PDF observationPage vet-referral polish), C (full horse.json + QA + Scaleway deploy).