Generated by /init-project. React 19 + TS strict + Vite 6 + Tailwind 4 + shadcn/ui + motion + pdf-lib + Zod + Zustand + react-router 7. Empty skeleton, no business logic. Docker multi-stage + nginx + Traefik labels commented. AGPL-3.0-or-later.
2.2 KiB
2.2 KiB
Architecture — Osteo Report
Vue d'ensemble
SPA React 100 % cliente. Aucun backend pour le MVP. Tout l'état vit dans le navigateur ; la persistance canonique est le PDF exporté (le JSON du bilan est embarqué en pièce jointe PDF native).
Flux
Choix : Nouveau bilan ─┐
├─► Éditeur (3 vues anatomiques)
Importer PDF ──────────┘ │
├─► Sélection zones ─► Findings
├─► Conclusion / Recommandations / RDV
└─► Export PDF (joint report.json)
Modules
| Module | Rôle |
|---|---|
state/reportStore |
Source de vérité unique. Persist localStorage (autosave). |
schema/* |
Schémas Zod = source de types (z.infer). Version 1. |
species/registry |
Map SpeciesId → SpeciesPack { anatomy, pathologies }. |
species/equine/* |
Données cliniques cheval (anatomie + pathologies sourcées). |
editor/* |
UI d'édition : vue anatomique, sélection, panneau findings, zoom. |
pdf/export |
Construit le PDF A4 + attache report.json. |
pdf/import |
Lit la pièce jointe, valide Zod, restitue l'état. |
routes/* |
3 routes : /, /new, /editor, 404. |
Décisions structurantes
- Pas de backend MVP. RGPD trivial, scalabilité gratuite, surface d'attaque minimale.
- Tailwind 4 via
@tailwindcss/vite(config CSS dansglobals.css). - React 19 + TS strict +
noUncheckedIndexedAccess+exactOptionalPropertyTypes. - Anatomie SVG : convention à 2 couches (
#illustrationnon interactive +#zonesavecdata-zone="..."cliquables). VoirANATOMY-SVG-CONVENTION.md. - Zoom sous-zones : modal dédié avec
react-zoom-pan-pinch. Le SVG principal reste pure click. - Versioning PDF : champ
versiondans le JSON. Migrations explicites à l'import.
Phase 2 (hors MVP)
Ajout backend (PostgreSQL) + comptes praticiens + historique par animal. La couche métier (schema/, state/, pdf/) reste intacte ; seul un adapter de persistance s'ajoute.