Bastien ChanotandClaude Opus 4.7 cad94a49db refactor(anatomy): adapt parser to new SVG convention (categories + single-element)
User dropped new Horse.svg / Horse_head.svg that follow a simpler
convention:

- Categories renamed to longer human strings:
    articulation       → articulations
    charniere          → charni-res-vert-brales
    spine-zone         → zone-colonne
    cadran-crane       → cadrans-du-cr-ne
    head, os-overlay   → dropped (head zone is now category="os" + data-anno-opens-detail)
    os                 → unchanged
- No more hitbox / visible class split; multiple elements may still share
  the same data-anno-id but they all carry the same role.
- Trigger-only zones (`data-anno-opens-detail="head"`) may omit
  `data-anno-name-fr/en`.

Changes:
- `Bone` now exposes a single `els: Element[]` instead of `hitboxEls +
  visibleEls`.
- `parseSvgBones` accepts annotations without fr/en labels (defaults to
  empty string) but still rejects unknown or missing categories.
- The "interactive vs decorative" filter is gone — every parsed
  annotation is interactive, since the new SVGs only annotate the
  clickable zones.
- Vertebra-picker trigger: `bone.category === 'zone-colonne'`
  (EditorRoute + ObservationCard).
- PDF colorisation in `observationPage.colorizedSvgString` writes the
  accent fill to every `els[]` entry (no more hitbox dual-pass).
- Dead `src/components/observation/ObservationEditor.tsx` removed (its
  body lives inside ObservationCard since the accordion refactor).
- Tests rewritten for the new vocabulary; synthetic fixture uses the new
  categories, real-SVG test asserts 18 + 9 unique zones.

92/92 tests pass, lint clean, build clean.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 04:06:26 +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%