# relevant-files : index Copies verbatim des fichiers du repository Faunosteo nécessaires pour comprendre les éditeurs et les données, prises sur la branche `develop` (`83e40af`) le 2026-10-06. L'arborescence du repo est conservée sous ce dossier. Aucun fichier n'a été modifié. ## Données anatomiques (indispensables) | Fichier | Rôle | |---|---| | `public/species/equine/Horse.svg` | SVG principal du cheval : 18 annotations (12 points, 5 zones colonne, 1 déclencheur de détail) | | `public/species/equine/Horse_head.svg` | SVG de détail `head` : même dessin, viewBox recadré, 9 annotations | | `public/species/equine/pathologies.json` | Catalogue de constats v2.0, 26 zones (copie identique de `src/domain/species/equine/pathologies.json`) | ## Manifeste espèce et schémas | Fichier | Rôle | |---|---| | `src/domain/species/types.ts` | `SpeciesManifest`, `VertebralFormula`, `FindingsLoader` | | `src/domain/species/registry.ts` | Auto-découverte des manifestes via `import.meta.glob` | | `src/domain/species/equine/index.ts` | Manifeste cheval : chemins SVG, `details.head`, formule, loader | | `src/domain/species/equine/vertebrae.ts` | Formule vertébrale C7 T18 L6 S5 Cd18 | | `src/domain/species/equine/pathologies.ts` | Parse Zod du catalogue au boot | | `src/domain/schema/findings.ts` | Schéma Zod du catalogue (zones, catégories, feuilles, sources) | | `src/domain/schema/observation.ts` | `ObservationZone`, `Finding`, `Vertebra`, `LateralSide`, `Observation` | | `src/domain/schema/report.ts` | `Report` version 2 | | `src/domain/schema/animal.ts`, `practitioner.ts` | Blocs identité du bilan | ## Parsing SVG et liaison zone ↔ catalogue | Fichier | Rôle | |---|---| | `src/anatomy/types.ts` | `Bone`, `SvgConventionError` | | `src/anatomy/svgConvention.ts` | `parseSvgBones`, `getBoneIdFromEvent` | | `src/anatomy/svgLoader.ts` | `loadSvg` (fetch + DOMParser) | | `src/anatomy/labels.ts` | `boneLabel` (fr → en → fallback) | | `src/i18n/pickLocaleLabel.ts` | Repli bilingue partagé | | `src/lib/zoneMatch.ts` | Matching flou libellé SVG ↔ `zone.name_fr/en` | | `src/lib/spineZones.ts` | Régions vertébrales, `collectSpineVertebrae`, `syncSpineZones` | | `src/lib/id.ts` | `generateId` (UUID) pour Report et Observation | ## Éditeurs | Fichier | Rôle | |---|---| | `src/app/routes/SvgEditorRoute.tsx` | Éditeur SVG anatomique (route `/svg-editor`, vanilla dans un `useEffect`) | | `src/styles/svg-editor.css` | Styles de l'éditeur SVG, dont les règles `hide-` | | `public/pathology-editor.html` | Éditeur de pathologies autonome (HTML + JS inline) | ## Bilan (application) | Fichier | Rôle | |---|---| | `src/app/routes/EditorRoute.tsx` | Route `/editor` : `onZoneClick`, détails, vertèbres, latéralité, export | | `src/state/reportStore.ts` | Store Zustand + miroir `osteo:draft` | | `src/components/canvas/AnatomyCanvas.tsx` | Rendu SVG inline, clic délégué, surbrillance `data-state` | | `src/components/canvas/DetailModal.tsx` | Modal du SVG de détail | | `src/components/observation/ObservationCard.tsx` | Zones d'une observation, `zonesWithTree` (matching) | | `src/components/observation/FindingsTreePicker.tsx` | Sélecteur hiérarchique de constats, snapshots | | `src/components/observation/VertebraPicker.tsx` | Sélecteur de vertèbres par région | | `src/components/observation/LateralityPicker.tsx` | Choix gauche / droite / les deux | ## PDF | Fichier | Rôle | |---|---| | `src/pdf/export.ts` | `exportReportToPdf`, `buildZoneLabels` | | `src/pdf/import.ts` | `importReportFromPdf`, `ImportError` | | `src/pdf/attachment.ts` | Pièce jointe JSON native, extraction, cap d'inflation | | `src/pdf/render/observationPage.ts` | Page par observation, colorisation SVG, sections | | `src/pdf/render/svgToPng.ts` | Rasterisation Image/canvas | ## Outils et documentation | Fichier | Rôle | |---|---| | `scripts/scaffold-species.mjs` | Squelette d'une nouvelle espèce | | `docs/ANATOMY-SVG-CONVENTION.md` | Convention SVG (partiellement obsolète, voir `10-current-limitations.md`) | | `docs/PATHOLOGIES-FORMAT.md` | Contrat d'écriture du catalogue | | `docs/ADDING-A-SPECIES.md` | Procédure d'ajout d'une espèce | ## Tests directement liés | Fichier | Rôle | |---|---| | `tests/unit/anatomy.horse.test.ts` | Comptes réels sur `Horse.svg` et `Horse_head.svg` | | `tests/unit/anatomy.svgConvention.test.ts` | Parser et validation | | `tests/unit/lib.zoneMatch.test.ts` | Matching flou | | `tests/unit/lib.spineZones.test.ts` | Vertèbres et synchronisation des zones colonne | | `tests/unit/species.equineFindings.test.ts` | Catalogue cheval | | `tests/unit/schema.observation.test.ts`, `schema.report.test.ts` | Schémas du bilan | | `tests/unit/components.FindingsTreePicker.test.tsx` | Snapshots et flag vétérinaire | | `tests/unit/components.VertebraPicker.test.tsx` | Picker et `regionFromLabel` | | `tests/unit/pdf.roundtrip.test.ts`, `pdf.attachment.test.ts`, `pdf.zoneLabels.test.ts` | Export, import, labels PDF |