Files
faunosteo/docs/ARCHITECTURE.md
T
ZenQuality a115e785a7 chore: initial scaffold
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.
2026-05-17 06:43:11 +02:00

43 lines
2.2 KiB
Markdown

# 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.