Files
faunosteo/docs/faunosteo-audit/relevant-files/INDEX.md
T
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

96 lines
4.9 KiB
Markdown

# 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-<cat>` |
| `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 |