Files
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

4.9 KiB

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