Bastien ChanotandClaude 1e12f2252f fix(editor): preload all detail SVGs on mount so re-imported reports render findings
EditorRoute used to populate detailBones lazily, inside the useEffect
that fires when the user opens a detail popup. That was fine for
fresh sessions, but after re-importing a PDF the store can already hold
observations whose zones reference detail-popup bone ids (e.g. an ATM
zone with boneId "point-mpbyo7zq" carried by the head detail SVG).

Without the matching Bone in detailBones, ObservationCard.zonesWithTree
could not resolve bone.fr — matchZoneFindings discarded the zone and
the findings tree picker never appeared on observations whose only
zones came from a detail popup. The findings were already in the store
(read straight from the JSON attachment), so it looked exactly like
"the pathologies don't load on re-upload" from the user side.

Fix: in the species-load useEffect, fire a fetch for every
species.details path in parallel and merge the parsed bones into
detailBones. Each fetch has its own catch so one missing asset does
not block the others. The popup-open useEffect stays as a no-op
safety net (merge is idempotent thanks to the !merged.has(id) guard).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-20 04:55:47 +02:00
2026-05-17 06:43:11 +02:00

Osteo Report

Web app for veterinary osteopaths to write session bilans on animal anatomy SVGs — click zones, build observations, export a self-contained PDF with the full report JSON embedded as a native PDF attachment. Re-importing that PDF restores the state for a follow-up.

Multi-species by design. MVP data set covers the horse (équin). Additional species — dog, cat, goat, cow, pig, rabbit, donkey, sheep — drop in by adding their SVG schematic + manifest + pathology file under src/domain/species/. See docs/ADDING-A-SPECIES.md for the recipe.

Open to every praticien who wants to use it. No authentication, no backend, no central server in v1 — the PDF is the long-term record. Phase 2 will add optional praticien accounts + server-side persistence on the same data contract.


Features

  • Anatomy canvas — inline SVG with clickable zones; hitbox+visible twin pattern; delegated click listener
  • Observation builder — group zones into clinical observations with pathology selection, severity, and free-text notes
  • Vertebra picker — region tabs (C/T/L/S/Cd) with multi-select chip grid for precise vertebral notation
  • Detail popups — click a zone (e.g. head) to open a secondary SVG with finer-grained zones
  • PDF export — A4 portrait with rasterized anatomy SVGs (canvg @ 2×), structured observations, and the full report JSON as a native PDF attachment
  • PDF re-import — open a previously exported PDF to restore the session for a follow-up
  • Configurable identity — site name, brand, footer, tagline all come from env vars; nothing hardcoded
  • Practitioner cache — last-used practitioner block prefilled via localStorage

Stack

  • Node.js 20
  • React 19 + TypeScript 5 (strict)
  • Vite 7 + @vitejs/plugin-react-swc
  • Tailwind CSS v4 (CSS-first, no postcss config)
  • Zustand 5 (state)
  • Zod 3 (schema + runtime validation)
  • pdf-lib 1.17 (PDF generation + native attachments)
  • canvg 4 (SVG → canvas rasterization)
  • motion 11 (animations)
  • vitest 3 + happy-dom + @testing-library/react

Quick start (dev)

Single process, no Docker:

# Requires pnpm — install if needed:
curl -fsSL https://get.pnpm.io/install.sh | sh
source ~/.bashrc   # or restart your shell

pnpm install
cp .env.example .env   # edit APP_* vars if desired
pnpm dev               # http://localhost:5173

Docker Compose (matches production topology):

cp .env.example .env   # set APP_* identity vars
docker compose up --build
# app at http://localhost:8080

Verifying a change

pnpm typecheck    # TypeScript strict, no emit
pnpm lint         # ESLint 9 flat config, 0 warnings
pnpm test:run     # vitest run (7 tests pass on skeleton)
pnpm build        # tsc + vite build → dist/

Build & deploy

pnpm build                  # production build → dist/
docker build -t osteo-report .   # multi-stage Docker image
docker compose up --build   # run with env_file: .env

For production deployment (VPS provisioning, firewall, TLS, nginx reverse proxy, backups) — see DEPLOY.md (to be written post-scaffold).


Documentation


Project layout

osteo/
├─ public/species/equine/   anatomy SVGs (Horse.svg, Horse_head.svg)
├─ src/app/                 routes + ConfigProvider
├─ src/config/              runtime env config resolution
├─ src/domain/              Zod schemas + species registry + equine data
├─ src/state/               Zustand store + localStorage cache
├─ src/anatomy/             SVG parser + loader
├─ src/components/          UI primitives, canvas, observation, report
├─ src/pdf/                 export/import/attachment/fonts + renderers
├─ src/lib/                 id, dates, assert utilities
├─ src/styles/              Tailwind v4 CSS + design tokens
├─ tests/unit/              vitest tests
├─ docker/                  entrypoint.sh + nginx.conf
└─ docs/                    conventions + species guide + PDF spec

Status

v1.0 MVP — implementation complete.

  • pnpm typecheck ✅
  • pnpm lint ✅
  • pnpm test:run ✅ — 88 tests across 23 files
  • pnpm build ✅ — 979 kB JS (349 kB gzip), 20 kB CSS

The first species data set ships with the real Horse.svg + Horse_head.svg anatomy sources at public/species/equine/. Adding dog, cat, goat, cow, pig, rabbit, donkey, sheep is the same procedure: convention-compliant SVG + manifest + pathology file. See docs/ADDING-A-SPECIES.md.

The pathology reference DB is intentionally empty in v1; the praticien adds entries via the free-text input. Source-cited DB authoring is deferred to v1.1 once the multi-praticien account architecture is decided (see docs/superpowers/specs/2026-05-18-osteo-report-mvp-design.md §Prerequisites/REMAINING).

Manual QA checklist: .claude/audits/MVP-QA.md — walk it through pnpm dev before delivery.

License: MIT.

S
Languages
TypeScript 78.6%
HTML 14.6%
CSS 3.7%
JavaScript 2.2%
Shell 0.7%
Other 0.2%