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.
96 lines
4.9 KiB
Markdown
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 |
|