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:
commit
a115e785a7
88 files changed
+12149
No files matched your search
@@ -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.
|
||||
@@ -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-*`.
|
||||
@@ -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.
|
||||
Reference in new issue
Block a user