Files
faunosteo/docs/faunosteo-audit/12-species-generalization.md
bastien e471d41c6b docs(docs): add anatomical audit of existing SVG, catalog and report systems
Read-only technical audit before the SaaS redesign: 13 reports,
a logical anatomical-sheet JSON built from real horse data, verbatim
copies of the 52 relevant source files, and a self-contained ZIP.
2026-10-06 23:51:35 +02:00

10 KiB

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/<dossier>/ 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
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/<id>/.
  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="<clé>" 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/<id>/ 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.