# 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 dans `globals.css`). - **React 19** + TS strict + `noUncheckedIndexedAccess` + `exactOptionalPropertyTypes`. - **Anatomie SVG** : convention à 2 couches (`#illustration` non interactive + `#zones` avec `data-zone="..."` cliquables). Voir `ANATOMY-SVG-CONVENTION.md`. - **Zoom sous-zones** : modal dédié avec `react-zoom-pan-pinch`. Le SVG principal reste pure click. - **Versioning PDF** : champ `version` dans 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.