# 12. Généralisation à d'autres espèces Périmètre : ce que le système actuel permet réellement pour ajouter chien, chat, vache, chèvre, porc, lapin, âne, mouton (section 16 du brief), et ce qui reste spécifique au cheval. Aucune espèce n'est codée ici ; aucune solution SaaS n'est proposée. ## Sources lues - `src/domain/species/{types,registry}.ts`, `src/domain/species/equine/{index,vertebrae,pathologies}.ts` - `scripts/scaffold-species.mjs`, `docs/ADDING-A-SPECIES.md` - `src/domain/schema/{observation,findings}.ts`, `src/lib/spineZones.ts`, `src/lib/zoneMatch.ts` - `src/app/routes/{NewReportRoute,EditorRoute,SvgEditorRoute}.tsx`, `src/components/report/AnimalForm.tsx` - `src/pdf/export.ts`, `src/pdf/render/observationPage.ts` - `public/pathology-editor.html`, `tests/unit/anatomy.horse.test.ts` ## 1. Ce que le code permet aujourd'hui (FACTUEL) | Mécanisme | Réalité | Référence | |---|---|---| | Découverte automatique | tout `src/domain/species/*/index.ts` exportant par défaut un `SpeciesManifest` est enregistré au build ; doublon d'`id` ignoré avec avertissement | `registry.ts:16-38` | | Scaffold | `pnpm scaffold:species` demande id, libellés FR/EN, dossier d'assets, SVG principal, détails (clé + chemin), formule vertébrale ; écrit `index.ts`, `vertebrae.ts`, `pathologies.ts`, `pathologies.json` ; crée `public/species//` vide ; refuse d'écraser | `scripts/scaffold-species.mjs:157-228` | | Squelette de catalogue produit | `schema_version: '1.1'` alors que le cheval est en `"2.0"` ; zones vides | `scaffold-species.mjs:123` | | Formule par défaut du scaffold | C7 T13 L6 S5 Cd18 (valeurs mixtes : T13 est canin, L6 et Cd18 sont équins) | `scaffold-species.mjs:180-184` | | Sélection de l'espèce dans un bilan | `AnimalForm` liste `getAllSpecies()` triées par `labelFr` ; valeur par défaut `'equine'` codée en dur dans le formulaire de création | `AnimalForm.tsx:19`, `NewReportRoute.tsx:20` | | Résolution à l'usage | éditeur et PDF font `getSpecies(report.animal.speciesId)` et lisent `mainSvg`, `details`, `vertebralFormula`, `findings()` | `EditorRoute.tsx:129`, `export.ts:42`, `observationPage.ts:639` | | Zod sur le catalogue | `SpeciesFindingsSchema` ne contient rien de spécifique au cheval ; `species.id` est une chaîne libre | `findings.ts:56-65` | | Parser SVG | ne connaît ni l'espèce ni une liste de catégories | `svgConvention.ts:44-89` | DEDUIT : le squelette technique d'une espèce est générique. Tout le contenu (dessin, annotations, catalogue) est à produire de zéro, et plusieurs comportements restent câblés sur des hypothèses équines (sections suivantes). ## 2. Tableau fonction par fonction | Fonction | Générique | Spécifique cheval | À refactorer | |---|---|---|---| | Registry des espèces (`registry.ts`) | oui, auto-découverte par glob | non | seulement si les fiches doivent exister hors du bundle | | Manifeste (`SpeciesManifest`) | oui, champs neutres (`mainSvg`, `details`, `vertebralFormula`, `findings`) | aucune version, aucune métadonnée | compilé en TS : une espèce = un rebuild | | Chargement SVG (`svgLoader.ts`) | oui, `fetch` d'un chemin | chemins `/species/equine/...` dans le manifeste et dans l'éditeur de pathologies | non pour l'app | | Parser SVG (`parseSvgBones`) | oui, attributs seulement | non | non | | Catégories SVG | chaîne libre acceptée | valeurs réelles en français slugifié (`charni-res-vert-brales`, `cadrans-du-cr-ne`), `CATEGORY_TEMPLATES` de l'éditeur SVG désalignés (`SvgEditorRoute.tsx:276-282`) | une liste de catégories par fiche n'existe pas | | Détail / zoom | mécanisme générique (`data-anno-opens-detail` + `details[clé]`) ; libellé PDF `pdf.view.detail_prefix` + clé en majuscules (`observationPage.ts:380`) | un seul détail `head`, fichier produit à la main (`04-detail-svg-generation.md`) | pas d'outil de création de détail | | Formule vertébrale | oui, par manifeste | `C7 T18 L6 S5 Cd18` (`vertebrae.ts`) | non | | Régions vertébrales | enum `C|T|L|S|Cd` en dur (`observation.ts:7`) ; convient aux mammifères domestiques listés | pas de région "autre", pas de vertèbres fusionnées (sacrum du chien = 3 vertèbres soudées, mais le picker les énumère S1..S3 si la formule le dit) | si une espèce doit sortir du modèle à 5 régions | | Déduction de région (`regionFromLabel`) | racines en dur : `cervic`, `thorac` ou `dors`, `lombair` ou `lumbar`, `sacral` ou `sacre`, `caudal` ou `coccyg` (`spineZones.ts:18-22`) | fonctionne sur les libellés du cheval ; "Rachis dorsal" (chien) tombe en `T`, correct ; "Queue" ou "Vertèbres de la queue" ne matche rien | FACTUEL : région non reconnue → `findSpineZoneId` retourne `undefined` → la zone n'est pas créée et les vertèbres cochées sont perdues (`spineZones.ts:126-127`) ; à remplacer par une région déclarée | | VertebraPicker | oui, onglets depuis la formule | libellés d'onglet via i18n `vertebra.region.*` | non | | Catalogue (structure) | oui, Zod neutre | 3 catégories par zone = convention d'auteur non imposée par le schéma ; `scope_disclaimer` rédigé pour le cheval mais texte générique "ostéopathie animale" | non pour la structure | | Catalogue (contenu) | non | 100 % équin : zones (boulets, jarret, grasset…), muscles, motifs ("travail monté", "mors", "selle") | tout à rédiger par espèce ; aucune zone partagée | | Lien SVG ↔ catalogue (`zoneMatch.ts`) | oui, par libellés FR/EN | les 26 libellés du cheval sont en égalité stricte ; un chien aura aussi "Hanche (coxo-fémorale)", sans conflit car un catalogue par espèce | générique mais fragile (voir `06-svg-findings-link.md`) | | Latéralité | oui, attribut + picker + `side` dans le bilan | 9 points bilatéraux annotés | non | | Éditeur SVG | lit `getAllSpecies()` : une nouvelle espèce apparaît dans son sélecteur | nom de fichier par défaut `horse_anatomy_edited.svg` (`SvgEditorRoute.tsx:325`), remplacé dès qu'un fichier est chargé | non | | Éditeur de pathologies | non | `SPECIES_CONFIG` codé en dur avec la seule entrée `equine` (`pathology-editor.html:786-796`), clé i18n `species_equine` (lignes 568 et 646) ; une nouvelle espèce n'y apparaît jamais sans éditer le HTML ; l'upload manuel reste possible | oui | | Bilan (`Report`) | oui, `animal.speciesId` chaîne libre (`animal.ts:5`) | défaut `'equine'` dans `NewReportRoute.tsx:20` | trivial | | PDF | oui, tout passe par `getSpecies` | aucun | non ; un `speciesId` inconnu donne un PDF sans images et sans libellés de zone (`export.ts:43`, `observationPage.ts:640`) | | i18n de l'app | oui | `species` affichée via `labelFr`/`labelEn` du manifeste | non | | Tests | partiel | `tests/unit/anatomy.horse.test.ts` fige 18 et 9 annotations, 5 zones colonne, 9 articulations (lignes 21-49) ; `pdf.zoneLabels.test.ts` mocke les deux fichiers du cheval | à dupliquer par espèce ou à généraliser | | Documentation | `docs/ADDING-A-SPECIES.md` décrit la procédure | cite encore 7 catégories "valides" qui ne correspondent pas aux SVG réels | à corriger | ## 3. Espèce par espèce : ce qui change vraiment DEDUIT. Le code ne distingue aucune des huit espèces ; les différences sont anatomiques et pèsent sur le contenu à produire, pas sur le moteur. | Espèce | Formule vertébrale usuelle (hors code, à valider par le domaine) | Points d'attention avec l'existant | |---|---|---| | Chien | C7 T13 L7 S3 Cd~20 | catalogue entier à écrire ; motifs "travail monté" inapplicables | | Chat | C7 T13 L7 S3 Cd~22 | idem | | Vache | C7 T13 L6 S5 Cd~18-20 | détail possible sur la mamelle ou les onglons : nécessite de nouveaux SVG de détail à la main | | Chèvre, mouton | C7 T13 L6-7 S4 Cd~12-16 | idem | | Porc | C7 T14-15 L6-7 S4 Cd~20 | thoraciques variables : la formule est un entier fixe par manifeste | | Lapin | C7 T12-13 L7 S4 Cd~16 | idem | | Âne | C7 T18 L5-6 S5 Cd~15-18 | proche du cheval ; le catalogue équin pourrait servir de base mais rien dans le code ne permet d'hériter ou de partager | HYPOTHESE : les comptes ci-dessus viennent de la connaissance anatomique générale, pas du repo. Ils montrent seulement que le modèle `VertebralFormula` (cinq entiers) les couvre tous, et que la variabilité individuelle (porc, caudales) est absorbée en prenant un maximum, comme le fait déjà le cheval pour `Cd: 18` (`vertebrae.ts:5`). ## 4. Effort réel pour ajouter une espèce aujourd'hui FACTUEL, chaîne complète : 1. Dessiner ou obtenir un SVG anatomique, l'annoter dans l'éditeur SVG (points, polygones, catégories, latéralité, `vertebral-precision` sur les zones colonne), exporter, copier le fichier dans `public/species//`. 2. Pour chaque vue de détail : copier le SVG principal, recadrer son `viewBox` à la main, réannoter, exporter, copier ; poser `data-anno-opens-detail=""` sur un polygone du SVG principal. 3. Lancer `pnpm scaffold:species`, corriger `schema_version` à `"2.0"` dans le JSON produit. 4. Rédiger le catalogue complet : une zone par annotation nommée, libellés FR/EN strictement égaux aux attributs SVG, trois catégories par zone, feuilles, flags vétérinaires. Pour le cheval : 26 zones, 792 nœuds. 5. Copier le JSON dans `public/species//` aussi, et ajouter l'espèce et ses vues dans `SPECIES_CONFIG` de `public/pathology-editor.html` si l'on veut l'éditer avec l'outil pré-câblé. 6. Rebuild, redéploiement. Rien n'est partagé entre espèces : pas de catalogue commun, pas de zone commune, pas de catégorie commune, pas de formule par défaut correcte. Chaque espèce est une île qui duplique la convention du cheval. ## Points non déterminés - Si la convention "3 catégories par zone, `anamnesis` non préfixé" doit être imposée aux autres espèces : elle est documentée dans `docs/PATHOLOGIES-FORMAT.md` mais le code ne la vérifie pas. - Si les valeurs du scaffold (`T: 13`, `schema_version '1.1'`) sont des oublis ou des choix : aucune trace dans le journal de décisions. - Si des SVG d'autres espèces existent hors du repo (le README cite les huit espèces comme cibles) : aucun fichier dans `public/species/` hors `equine`.