2026-05-17 06:48:28 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:48:28 +02:00
2026-05-17 06:43:11 +02:00
2026-05-17 06:43:11 +02:00

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 use lit .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


Licence

AGPL-3.0-or-later © ZenQuality

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