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

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