Phase A — Domain & schemas (15 tests): - Zod schemas: ReportSchema, FindingSchema, PractitionerSchema, SeveritySchema - Types derived via z.infer (single source of truth) - newId() helper with optional prefix Phase B — Equine anatomy + pathology DB (7 tests): - 26 macro zones, axial subzones C1-7/T1-18/L1-6/S1-5 - 31 pathologies, each citing Merck Vet Manual, PubMed, IMAIOS or LCAO - Placeholder SVGs (lateral L/R + dorsal) with data-zone convention - Species registry: equine registered, 8 others remain stubs Phase C — Zustand store (8 tests): - Single source of truth with persist middleware (localStorage key osteo-report-draft) - Actions: hydrate, reset, toggleZone, addFinding, updateFinding, removeFinding, setConclusion/Recommendations/NextAppointment Phase H/I — PDF export + import roundtrip (2 tests): - A4 portrait, pdf-lib StandardFonts - Header (practitioner + animal), anatomy pages (per used view), findings table, conclusion/recommendations/RDV page, page footer with date+page# - Attachment: base64 data URI workaround (pdf-lib treats raw string as base64 input, and rejects cross-realm Uint8Array in jsdom tests) - Import: walks Catalog→Names→EmbeddedFiles→Names array→F stream; inflates via pako directly (bypasses pdf-lib's reference-equality FlateDecode check which fails across module realms in vitest); validates with ReportSchema Tooling: - Add pako 2.x + @types/pako (already transitive of pdf-lib) - Switch vitest 2 → 3 (already done in prior commit) - Add 8 test files (34 tests total green)
Osteo Report
Bilans de séance d'ostéopathie animalière — application web client-side, export PDF auto-portant.
Application web pour vétérinaire ostéopathe : saisie du compte rendu de séance, annotation de zones anatomiques sur des schémas, export en PDF propre. Le PDF généré embarque le JSON complet du bilan en pièce jointe native — il peut être ré-importé plus tard pour reprendre l'édition.
100 % côté client. Aucun serveur, aucune base de données, aucune donnée stockée en dehors du PDF que le praticien télécharge.
Tech
- React 19 / TypeScript 5 strict / Vite 6
- Tailwind 4 + shadcn/ui (canary) +
motion(framer-motion) - Zod (validation runtime des PDFs importés)
- Zustand 5 (état + autosave localStorage)
- pdf-lib (génération PDF + pièces jointes natives)
- react-hook-form, react-router 7, react-zoom-pan-pinch
- Vitest + @testing-library/react + Playwright
- Docker multi-stage → nginx alpine + Traefik (labels commentés)
Prérequis
- Node ≥ 20.18 (
nvm uselit.nvmrc) - npm 10
- Docker (déploiement uniquement)
npx playwright install chromium(avant les tests e2e, une seule fois)
Démarrage
npm install
npm run dev # http://localhost:5173
Commandes
npm run dev # dev server (Vite)
npm run build # production build (tsc -b && vite build)
npm run preview # preview build sur :4173
npm run test # vitest run
npm run test:watch # vitest watch
npm run test:e2e # playwright
npm run lint # eslint
npm run lint:fix # eslint --fix
npm run typecheck # tsc -b --noEmit
npm run format # prettier --write .
Docker
docker compose up --build
Le docker-compose.yml contient des labels Traefik commentés à activer pour la
mise en production sur sous-domaine.
Espèces couvertes
Le formulaire de nouveau bilan propose 9 espèces :
| Espèce | MVP | Anatomie complète | Base pathologies |
|---|---|---|---|
| Cheval | ✅ | en cours | seed initial |
| Chien | bientôt | — | — |
| Chat | bientôt | — | — |
| Lapin | bientôt | — | — |
| Bovin | bientôt | — | — |
| Chèvre | bientôt | — | — |
| Âne | bientôt | — | — |
| Mouton | bientôt | — | — |
| Porc | bientôt | — | — |
Le code est conçu pour qu'ajouter une espèce = ajouter un dossier
src/species/<id>/. Voir docs/ADDING-A-SPECIES.md.
Format PDF
Chaque PDF exporté contient :
- Header avec coordonnées du praticien, animal, propriétaire, date.
- Pour chaque vue où des zones ont été cliquées : un schéma annoté.
- Tableau des findings (zone, pathologie, sévérité, commentaire).
- Conclusion + recommandations.
- Date de prochain rendez-vous (optionnel).
- Footer avec date d'export.
- Pièce jointe
report.json: le bilan complet, lisible par cette application pour reprendre l'édition.
À l'import, l'app vérifie la présence de la pièce jointe, valide le JSON via Zod et restitue l'état. Un PDF externe (pas généré par l'app) est rejeté avec un message clair.
Documentation
docs/ARCHITECTURE.md— modules, flux, décisions.docs/ADDING-A-SPECIES.md— guide d'ajout d'une espèce.docs/ANATOMY-SVG-CONVENTION.md— règles SVG anatomique.CLAUDE.md— instructions pour Claude Code dans ce repo.
Licence
AGPL-3.0-or-later © ZenQuality