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.
This commit is contained in:
ZenQuality committed 2026-05-17 06:43:11 +02:00
commit a115e785a7
88 files changed
+12149

No files matched your search

+21
View File
@@ -0,0 +1,21 @@
# Ajouter une espèce
Le code est conçu pour rendre triviale l'ajout d'une nouvelle espèce. Trois fichiers + trois SVG.
## Étapes
1. **Créer le dossier** `src/species/<id>/` où `<id>` ∈ { chien, chat, equine, lapin, bovin, chevre, ane, mouton, porc, … }.
2. **Anatomie** — `src/species/<id>/anatomy.ts` exporte un `SpeciesAnatomy` (voir `src/species/types.ts`) :
- `id`, `label`, `vertebralFormula`
- `zones[]` (id, label, catégorie, vues où visible, sous-zones éventuelles)
- `svg` : chemins relatifs vers les 3 SVG (`lateral_left`, `lateral_right`, `dorsal`)
3. **Pathologies** — `src/species/<id>/pathologies.ts` exporte `PathologyEntry[]`.
Chaque entrée DOIT citer au moins une source clinique (Merck Veterinary Manual, IMAIOS,
PubMed, etc.). Voir `src/species/equine/README.md` pour la liste des sources de référence.
4. **Illustrations** — 3 SVG conformes à la convention (voir `ANATOMY-SVG-CONVENTION.md`) :
- `lateral_left.svg`, `lateral_right.svg`, `dorsal.svg`
- viewBox normalisé (1000×600 latéral, 1000×800 dorsal)
- Couche `#illustration` + couche `#zones` avec `data-zone="<zoneId>"` sur chaque path.
5. **Enregistrement** — dans `src/species/registry.ts`, importer puis `registerSpecies('<id>', { anatomy, pathologies })`.
Ou : laisser le chargement paresseux via `import('./<id>/index.ts')` (préféré pour le code-splitting).
6. **Test** — `tests/unit/species.<id>.test.ts` doit vérifier que le pack se charge et que la liste de zones est non vide.
+42
View File
@@ -0,0 +1,42 @@
# Convention SVG anatomique
Chaque vue (latéral gauche, latéral droit, dorsal) est un fichier SVG avec **au moins deux couches** :
```xml
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 600">
<g id="illustration">
<!-- tout le dessin : silhouettes, ombres, traits -->
<!-- AUCUN evènement, pointer-events: none côté CSS -->
</g>
<g id="zones">
<!-- une <path>/<polygon> par zone cliquable -->
<path id="zone-shoulder-l"
data-zone="zone-shoulder-l"
fill="transparent" />
<path id="zone-thoracic-back"
data-zone="zone-thoracic-back"
fill="transparent" />
<!-- ... -->
</g>
</svg>
```
## Règles
- **viewBox normalisé** :
- Vues latérales : `0 0 1000 600`
- Vue dorsale : `0 0 1000 800`
- **IDs de zones** : `zone-<region>-<side?>`, en minuscules, kebab-case.
- Exemples : `zone-neck`, `zone-shoulder-l`, `zone-shoulder-r`, `zone-thoracic-back`, `zone-lumbar`, `zone-hip-l`, `zone-tail`.
- **Attribut clef** : `data-zone="<id>"` doit matcher l'id de zone dans `anatomy.ts`.
- **Couleur des zones cliquables** : `fill="transparent"` par défaut. Le CSS applique le style selon `data-selected`, `data-linked`, `data-hovered`.
- **Pas d'interactivité** sur la couche `#illustration` (CSS : `pointer-events: none`).
- **Sous-zones** (vertèbres T1-T18, etc.) : dans un SVG séparé, ouvert dans `ZoomOverlay`.
Convention identique avec `data-subzone="T7"` etc.
## Outils suggérés
- Inkscape ou Figma pour le tracé des polygones par-dessus l'illustration.
- Une fois tracés, exporter en SVG plain (Inkscape : "Sauvegarder une copie → SVG simple").
- Nettoyer avec [SVGO](https://github.com/svg/svgo) en préservant les IDs et attributs `data-*`.
+42
View File
@@ -0,0 +1,42 @@
# 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.