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.
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}.tsscripts/scaffold-species.mjs,docs/ADDING-A-SPECIES.mdsrc/domain/schema/{observation,findings}.ts,src/lib/spineZones.ts,src/lib/zoneMatch.tssrc/app/routes/{NewReportRoute,EditorRoute,SvgEditorRoute}.tsx,src/components/report/AnimalForm.tsxsrc/pdf/export.ts,src/pdf/render/observationPage.tspublic/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 |
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 :
- Dessiner ou obtenir un SVG anatomique, l'annoter dans l'éditeur SVG (points, polygones, catégories, latéralité,
vertebral-precisionsur les zones colonne), exporter, copier le fichier danspublic/species/<id>/. - Pour chaque vue de détail : copier le SVG principal, recadrer son
viewBoxà la main, réannoter, exporter, copier ; poserdata-anno-opens-detail="<clé>"sur un polygone du SVG principal. - Lancer
pnpm scaffold:species, corrigerschema_versionà"2.0"dans le JSON produit. - 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.
- Copier le JSON dans
public/species/<id>/aussi, et ajouter l'espèce et ses vues dansSPECIES_CONFIGdepublic/pathology-editor.htmlsi l'on veut l'éditer avec l'outil pré-câblé. - 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,
anamnesisnon préfixé" doit être imposée aux autres espèces : elle est documentée dansdocs/PATHOLOGIES-FORMAT.mdmais 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/horsequine.