diff --git a/docs/faunosteo-audit/01-repository-map.md b/docs/faunosteo-audit/01-repository-map.md new file mode 100644 index 00000000..cfd44f37 --- /dev/null +++ b/docs/faunosteo-audit/01-repository-map.md @@ -0,0 +1,253 @@ +# 01. Carte du repository + +Périmètre : arborescence réelle du dépôt (branche `develop`, tête `83e40af`), rôle de chaque fichier pertinent pour la fiche anatomique, graphe des imports, points d'entrée, build et déploiement, et la liste des fichiers nécessaires à la reconstruction d'une fiche anatomique (section 9 du brief). + +## Sources lues + +- `git ls-files` (inventaire complet, 177 fichiers hors `.claude/`) +- `index.html`, `src/main.tsx`, `src/app/App.tsx`, `src/app/routes/*.tsx` +- `vite.config.ts`, `vitest.config.ts`, `package.json`, `Dockerfile`, `docker/nginx.conf`, `docker/entrypoint.sh` +- `src/anatomy/*`, `src/lib/*`, `src/domain/**`, `src/state/*`, `src/components/**`, `src/pdf/**`, `src/i18n/*` +- `public/species/equine/*`, `public/pathology-editor.html`, `public/assets/`, `public/brand/`, `logos/` +- `scripts/scaffold-species.mjs`, `docs/*.md`, `docs/superpowers/**` +- `.claude/audits/TOUR.md`, `.claude/audits/BUGS-FOUND.md` (lus, non copiés) + +## 1. Arborescence commentée + +Seuls les fichiers utiles à la compréhension des éditeurs et des données sont commentés. Les lignes sans commentaire sont présentes dans le dépôt mais hors périmètre. + +``` +faunosteo/ +├─ index.html entrée SPA, charge /env.js puis src/main.tsx +├─ package.json scripts dev/build/test/lint, scaffold:species +├─ vite.config.ts alias @ → src/, plugins react-swc + tailwind +├─ vitest.config.ts happy-dom, include tests/**/*.test.ts(x) +├─ Dockerfile multi-stage node:20-alpine → nginx:1.31-alpine, USER nginx +├─ docker-compose.yml +├─ docker/entrypoint.sh écrit env.js (window.__APP_CONFIG__) au démarrage +├─ docker/nginx.conf SPA fallback, /species/ en Cache-Control: no-cache +├─ README.md, CHANGELOG.md, DEPLOY.md, CLAUDE.md, LICENSE +├─ .githooks/ hooks gitflow (hors périmètre) +├─ logos/ sources SVG/PNG de la marque + generate-sizes.sh +├─ scripts/scaffold-species.mjs génère le squelette d'une espèce (index.ts, vertebrae.ts, pathologies.ts/json) +├─ docs/ +│ ├─ ANATOMY-SVG-CONVENTION.md contrat data-anno-* (partiellement obsolète, voir §6) +│ ├─ ADDING-A-SPECIES.md recette d'ajout d'espèce +│ ├─ PATHOLOGIES-FORMAT.md contrat du catalogue JSON v2.0 +│ ├─ PDF-FORMAT.md placeholder de 12 lignes +│ └─ superpowers/{specs,plans}/ specs et plans de conception datés (historique) +├─ public/ +│ ├─ env.js config runtime par défaut (dev) +│ ├─ favicon.svg, logo-horizontal.svg, apple-touch-icon.png, Paws_in_harmony.svg +│ ├─ assets/ 2 PNG logos utilisés par le PDF +│ ├─ brand/zenquality-logo-fr.png +│ ├─ pathology-editor.html éditeur de constats autonome (1700 lignes, zéro import src/) +│ └─ species/equine/ +│ ├─ Horse.svg SVG principal (viewBox 0 0 2073.4 1629.4) +│ ├─ Horse_head.svg SVG de détail "head" (viewBox 60 100 500 380) +│ └─ pathologies.json copie du catalogue, fetchée par pathology-editor.html +├─ src/ +│ ├─ main.tsx ReactDOM root +│ ├─ app/App.tsx BrowserRouter + routes +│ ├─ app/routes/ +│ │ ├─ HomeRoute.tsx nouveau bilan / import PDF +│ │ ├─ NewReportRoute.tsx formulaire praticien/animal/propriétaire +│ │ ├─ EditorRoute.tsx éditeur de bilan (canvas + observations + export) +│ │ ├─ SvgEditorRoute.tsx éditeur SVG anatomique (1858 lignes, vanilla DOM dans useEffect) +│ │ ├─ EditorsRoute.tsx page de liens vers les deux éditeurs +│ │ └─ NotFoundRoute.tsx +│ ├─ app/providers/ConfigProvider.tsx +│ ├─ config/env.ts AppConfig (siteName, brandName, footerName, tagline) +│ ├─ anatomy/ +│ │ ├─ types.ts Bone, BoneCategory, BoneState, SvgConventionError +│ │ ├─ svgConvention.ts parseSvgBones(), getBoneIdFromEvent(), getAnnotatedElement() +│ │ ├─ svgLoader.ts loadSvg(publicPath) via fetch + DOMParser +│ │ └─ labels.ts boneLabel(bone, locale, fallback) +│ ├─ domain/schema/ +│ │ ├─ findings.ts SourceRef, FindingNode (récursif), ZoneFindings, SpeciesFindings +│ │ ├─ observation.ts Severity, VertebralRegion, Vertebra, LateralSide, ObservationZone, Finding, Observation +│ │ ├─ report.ts Report (version literal 2), NextAppointment +│ │ ├─ practitioner.ts, animal.ts +│ ├─ domain/species/ +│ │ ├─ types.ts VertebralFormula, SpeciesManifest, FindingsLoader +│ │ ├─ registry.ts import.meta.glob('./*/index.ts'), getSpecies(), getAllSpecies(), speciesLabel() +│ │ └─ equine/ +│ │ ├─ index.ts manifeste : mainSvg, details.head, vertebralFormula, findings loader +│ │ ├─ vertebrae.ts C7 T18 L6 S5 Cd18 +│ │ ├─ pathologies.ts SpeciesFindingsSchema.parse(json) au chargement +│ │ └─ pathologies.json catalogue source (identique octet pour octet à public/species/equine/pathologies.json) +│ ├─ lib/ +│ │ ├─ zoneMatch.ts normalizeLabel, levenshtein, scorePair, matchZoneFindings +│ │ ├─ spineZones.ts regionFromLabel, findSpineZoneId, collectSpineVertebrae, syncSpineZones +│ │ ├─ id.ts generateId() = crypto.randomUUID() +│ │ ├─ dates.ts, assert.ts +│ ├─ state/ +│ │ ├─ reportStore.ts Zustand, miroir sessionStorage osteo:draft +│ │ ├─ localeStore.ts osteo:locale +│ │ └─ practitionerCache.ts osteo:lastPractitioner +│ ├─ components/ +│ │ ├─ canvas/AnatomyCanvas.tsx SVG inline, clic délégué, data-state, tooltip +│ │ ├─ canvas/DetailModal.tsx Dialog + AnatomyCanvas du SVG de détail +│ │ ├─ observation/ ObservationList, ObservationCard, FindingsTreePicker, VertebraPicker, LateralityPicker, SeveritySelector, FreeTextFindingInput +│ │ ├─ report/ ReportHeader, PractitionerForm, AnimalForm, ConclusionPanel, NextAppointmentPicker +│ │ ├─ brand/ AppHeader, Brand, Footer, LanguageSwitcher +│ │ └─ ui/ primitives +│ ├─ pdf/ +│ │ ├─ export.ts exportReportToPdf(), buildZoneLabels() +│ │ ├─ import.ts importReportFromPdf(), ImportError +│ │ ├─ attachment.ts attachReportJson(), extractReportJson(), inflateFlate() +│ │ ├─ fonts.ts StandardFonts Helvetica / TimesRoman +│ │ └─ render/ header, footer, observationPage, conclusionPage, svgToPng, text, logo, linkAnnotation, constants +│ ├─ i18n/ fr.ts, en.ts (dicts plats), useT, pickLocaleLabel +│ └─ styles/ index.css, tokens.css, svg-editor.css +├─ tests/unit/*.test.ts(x) 30 fichiers, 180 cas `it(` (voir 13-tests.md) +└─ .claude/ mémoire projet (decisions, learnings, blockers, journal, evals), TODO, audits. Existe, non copiée. +``` + +## 2. Points d'entrée + +| Entrée | Fichier | Rôle | +|---|---|---| +| `/` | `src/app/routes/HomeRoute.tsx` | nouveau bilan ou import PDF | +| `/new` | `src/app/routes/NewReportRoute.tsx` | saisie identité, `initReport()` | +| `/editor` | `src/app/routes/EditorRoute.tsx` | éditeur de bilan, redirige vers `/` si aucun report (`EditorRoute.tsx:120-122`) | +| `/svg-editor` | `src/app/routes/SvgEditorRoute.tsx` | éditeur SVG, footer masqué (`App.tsx:12`) | +| `/editors` | `src/app/routes/EditorsRoute.tsx` | liens vers `/svg-editor` et `/pathology-editor.html` | +| `*` | `NotFoundRoute.tsx` | 404 SPA | +| `/pathology-editor.html` | `public/pathology-editor.html` | fichier statique servi tel quel, hors React (FACTUEL : `EditorsRoute.tsx:32` utilise un ``, pas un ``) | + +FACTUEL : `App.tsx:16-22` déclare exactement six routes. Le routage est `BrowserRouter` ; en production le fallback `try_files $uri $uri/ /index.html` de `docker/nginx.conf:25` sert `index.html` pour toute route inconnue, et le fichier statique `pathology-editor.html` est servi avant le fallback parce qu'il existe sur disque (LRN-029). + +## 3. Graphe des imports entre modules clés + +Direction : A → B signifie "A importe B". Relevé par `grep import` sur `src/`. + +``` +app/App.tsx → routes/*, providers/ConfigProvider, components/brand/Footer + +routes/EditorRoute.tsx + → anatomy/svgLoader (loadSvg), anatomy/svgConvention (parseSvgBones), anatomy/labels (boneLabel), anatomy/types + → domain/species/registry (getSpecies) + → domain/schema/{observation,report,findings,practitioner,animal} (types) + → lib/spineZones (regionFromLabel, collectSpineVertebrae, syncSpineZones) + → state/reportStore, state/localeStore, state/practitionerCache + → components/canvas/{AnatomyCanvas,DetailModal} + → components/observation/{ObservationList,VertebraPicker,LateralityPicker} + → components/report/*, components/ui/{Button,Dialog} + → pdf/export (exportReportToPdf) + → i18n/useT + +routes/SvgEditorRoute.tsx + → domain/species/registry (getAllSpecies, speciesLabel) + → state/localeStore, i18n/index (getDict), i18n/useT + → components/brand/AppHeader, styles/svg-editor.css + (n'importe PAS anatomy/svgConvention : il a sa propre lecture des attributs data-anno-*) + +routes/HomeRoute.tsx → pdf/import, state/reportStore +routes/NewReportRoute.tsx → state/reportStore, state/practitionerCache, components/report/* + +components/observation/ObservationCard.tsx + → lib/zoneMatch (matchZoneFindings) ← seul consommateur runtime du matcher + → anatomy/labels (boneLabel), anatomy/types + → domain/schema/{observation,findings} (types) + → FindingsTreePicker, FreeTextFindingInput, SeveritySelector + +components/observation/FindingsTreePicker.tsx → domain/schema/{findings,observation} (types), state/localeStore +components/observation/VertebraPicker.tsx → domain/schema/observation, domain/species/types +components/canvas/AnatomyCanvas.tsx → anatomy/svgLoader, anatomy/svgConvention, state/localeStore, i18n/pickLocaleLabel +components/canvas/DetailModal.tsx → AnatomyCanvas, components/ui/Dialog + +lib/zoneMatch.ts → domain/schema/findings (type ZoneFindings) +lib/spineZones.ts → domain/schema/observation (types), anatomy/types +anatomy/labels.ts → i18n/pickLocaleLabel, anatomy/types + +domain/species/registry.ts → domain/species/types (+ import.meta.glob des manifestes) +domain/species/equine/index.ts → domain/species/types, ./vertebrae ; findings: () => import('./pathologies') +domain/species/equine/pathologies.ts → domain/schema/findings, ./pathologies.json + +pdf/export.ts → anatomy/{svgLoader,svgConvention}, domain/species/registry, i18n, render/*, attachment +pdf/render/observationPage.ts → anatomy/{svgLoader,svgConvention}, domain/species/registry, i18n/pickLocaleLabel, render/{svgToPng,text,header,constants} +pdf/import.ts → attachment ; pdf/attachment.ts → domain/schema/report (ReportSchema) + +state/reportStore.ts → domain/schema/report (ReportSchema), lib/id, lib/dates +``` + +Observations (DEDUIT) : + +- `lib/zoneMatch.ts` n'a qu'un seul appelant dans l'application : `ObservationCard.tsx:134`. Le PDF n'utilise pas le matcher : il lit `Finding.zoneId` directement (`observationPage.ts:441`). +- `anatomy/svgConvention.ts` est appelé à quatre endroits : `EditorRoute.tsx:135,146,167`, `AnatomyCanvas.tsx` (clic/tooltip), `pdf/export.ts:53`, `pdf/render/observationPage.ts:220`. Le SVG est donc re-téléchargé et re-parsé à chaque export PDF. +- `public/pathology-editor.html` n'importe rien de `src/` (BDR-020) ; il réimplémente le matcher (`pathology-editor.html:850-908`, commentaire "ported from src/lib/zoneMatch.ts") et son propre `generateId` (`:912`). + +## 4. Build et déploiement + +| Étape | Fait (FACTUEL) | +|---|---| +| Build | `pnpm build` = `tsc --noEmit && vite build` (`package.json`). Vite n'a qu'une entrée, `index.html`. Tout `public/` est copié tel quel dans `dist/`. | +| Catalogue | `src/domain/species/equine/pathologies.json` est importé statiquement par `pathologies.ts:5` et inclus dans le bundle JS. `public/species/equine/pathologies.json` est une copie servie en HTTP, utilisée uniquement par `pathology-editor.html:790`. md5 identique (`f3b11822…`). | +| SVG | Jamais bundlés : fetchés à l'exécution par `loadSvg('/species/equine/Horse.svg')` depuis `public/`. | +| nginx | `location /species/ { add_header Cache-Control "no-cache"; }` (`docker/nginx.conf:19-21`) : les SVG et le JSON public sont revalidés à chaque requête. `/assets/` immuable un an. | +| Runtime config | `entrypoint.sh` écrit `env.js` ; `src/config/env.ts` lit `window.__APP_CONFIG__` puis `VITE_APP_*` puis défauts. Ne concerne que l'identité de marque. | +| Conteneur | `USER nginx`, port 8080, aucun backend, aucune base. | + +DEDUIT : une mise à jour du catalogue exige un rebuild du bundle pour l'application, mais seulement un remplacement de fichier pour l'éditeur de constats. Les deux copies peuvent diverger sans qu'aucun test ne le détecte (voir `10-current-limitations.md`). + +## 5. Fichiers nécessaires pour reconstruire une fiche anatomique complète (section 9 du brief) + +Le code n'a pas de notion nommée "fiche anatomique" (voir `02-anatomical-sheet.md`). La liste ci-dessous est DEDUITE des imports et des fetchs réels. + +### Indispensables + +| Fichier | Pourquoi | +|---|---| +| `public/species/equine/Horse.svg` | SVG principal, seule source des zones, points, labels FR/EN, catégories, latéralité, drapeau `vertebral-precision`, lien vers le détail | +| `public/species/equine/Horse_head.svg` | SVG de détail `head`, seule source des 9 zones crâniennes | +| `src/domain/species/equine/pathologies.json` | catalogue des constats (26 zones), bundlé | +| `src/domain/species/equine/index.ts` | manifeste : relie `mainSvg`, `details.head`, formule vertébrale, loader du catalogue. Sans lui l'espèce n'existe pas (`registry.ts:16-19`) | +| `src/domain/species/equine/vertebrae.ts` | formule C/T/L/S/Cd, consommée par `VertebraPicker` | +| `src/domain/species/equine/pathologies.ts` | parse Zod du JSON au chargement | +| `src/domain/species/types.ts`, `src/domain/species/registry.ts` | contrat du manifeste et découverte automatique | +| `src/domain/schema/findings.ts` | schéma du catalogue | +| `src/domain/schema/observation.ts`, `report.ts`, `practitioner.ts`, `animal.ts` | schéma du bilan qui référence les zones | +| `src/anatomy/types.ts`, `svgConvention.ts`, `svgLoader.ts` | lecture du SVG en `Map` | +| `src/lib/zoneMatch.ts` | le seul pont SVG → catalogue | +| `src/lib/spineZones.ts` | déduction de la région vertébrale depuis le libellé | + +### Optionnels (la fiche fonctionne sans, avec dégradation) + +| Fichier | Rôle | +|---|---| +| `public/species/equine/pathologies.json` | copie HTTP pour l'éditeur de constats uniquement | +| `src/anatomy/labels.ts`, `src/i18n/pickLocaleLabel.ts` | repli FR/EN des labels | +| `src/i18n/fr.ts`, `en.ts` | libellés statiques de l'UI et du PDF, pas les noms de zones | +| `docs/ANATOMY-SVG-CONVENTION.md`, `docs/PATHOLOGIES-FORMAT.md`, `docs/ADDING-A-SPECIES.md` | contrats écrits, partiellement désynchronisés du code | +| `scripts/scaffold-species.mjs` | génère un squelette d'espèce (écrit `schema_version: '1.1'`, `scaffold-species.mjs:123`, alors que le catalogue cheval est en `"2.0"`) | + +### Purement UI + +| Fichier | Rôle | +|---|---| +| `src/app/routes/SvgEditorRoute.tsx` + `src/styles/svg-editor.css` | outil d'annotation ; produit le SVG, ne fait pas partie de la fiche | +| `public/pathology-editor.html` | outil d'édition du JSON ; produit le catalogue | +| `src/app/routes/EditorRoute.tsx`, `components/canvas/*`, `components/observation/*`, `components/report/*`, `components/ui/*`, `components/brand/*` | consommation de la fiche dans le bilan | +| `src/pdf/**` | rendu et attachement ; re-lit la fiche à l'export | +| `src/state/*`, `src/config/env.ts`, `src/app/providers/ConfigProvider.tsx` | état et identité | +| `public/assets/*.png`, `public/brand/*.png`, `public/Paws_in_harmony.svg`, `public/logo-horizontal.svg`, `public/favicon.svg` | marque | + +### Historiques ou inutilisés + +| Élément | Constat | +|---|---| +| `docs/PDF-FORMAT.md` | placeholder de 12 lignes, jamais rédigé (FACTUEL) | +| `docs/superpowers/specs/*`, `docs/superpowers/plans/*` | documents de conception datés mai 2026 ; utiles pour l'intention, pas pour l'état courant | +| Attribut `data-anno-category-name` (18 occurrences dans `Horse.svg`) | écrit et relu uniquement par l'éditeur SVG (`SvgEditorRoute.tsx:640,1150`) ; ignoré par `parseSvgBones` (FACTUEL : non lu dans `svgConvention.ts:44-89`) | +| `BoneState` `linked` / `multi` | supprimés par `9d8267b` ; `types.ts:43` ne garde que `'current' \| 'default'`, `index.css:12` n'a qu'une règle `data-state='current'`. Le doc `ANATOMY-SVG-CONVENTION.md:138-139` les décrit encore (obsolète) | +| 22 PNG logos inutilisés (TOUR CLN-7) | supprimés par `9d8267b` (23 fichiers `public/assets` touchés). `public/assets/` ne contient plus que les 2 PNG lus par `pdf/render/logo.ts` (vérifié `ls`) | +| `logos/` | sources de marque + script de génération, non servies | +| Règles CSS `.hide-articulation`, `.hide-charniere`, `.hide-cadran-crane`, `.hide-os-overlay`, `.hide-spine-zone`, `.hide-custom` (`svg-editor.css:523-528`) | ciblent les noms de catégories des templates (`CATEGORY_TEMPLATES`, `SvgEditorRoute.tsx:276-282`). Les catégories réelles des SVG cheval sont `articulations`, `charni-res-vert-brales`, `cadrans-du-cr-ne`, `zone-colonne`, `os`. DEDUIT : la case "visibilité" (`SvgEditorRoute.tsx:1476`) ajoute une classe `hide-articulations` qu'aucune règle CSS ne cible, donc elle est sans effet sur les SVG du projet | +| Migration `data-bone-*` → `data-anno-*` (`SvgEditorRoute.tsx:591-608`) | compatibilité avec l'ancienne convention (commit `1109e33`) ; aucun SVG du dépôt ne porte encore `data-bone-*` | +| `scaffold-species.mjs:158` | bannière "Zoosteo", ancien nom du projet | + +## Points non déterminés + +- HYPOTHESE : l'absence de `data-bone-*` dans les SVG commités ne prouve pas qu'aucun SVG externe à migrer n'existe chez le praticien ; la migration est conservée par prudence ou par oubli, le code ne le dit pas. +- La raison de la double copie de `pathologies.json` est documentée dans la spec de l'éditeur (`docs/superpowers/specs/2026-05-22-pathology-editor-design.md:56`, "copied or symlinked"). Aucun script ne synchronise les deux copies ; la synchronisation est manuelle (DEDUIT de l'absence de script dans `package.json` et `scripts/`). diff --git a/docs/faunosteo-audit/02-anatomical-sheet.md b/docs/faunosteo-audit/02-anatomical-sheet.md new file mode 100644 index 00000000..f70a4e6c --- /dev/null +++ b/docs/faunosteo-audit/02-anatomical-sheet.md @@ -0,0 +1,283 @@ +# 02. La "fiche anatomique" actuelle, reconstruite + +Périmètre : ce que serait aujourd'hui une fiche anatomique dans Faunosteo (sections 2 et 8 du brief), à partir du code et des données réelles du cheval. Aucun concept nommé "fiche anatomique" n'existe dans le code. Ce document reconstruit l'ensemble implicite. + +## Sources lues + +- `src/domain/species/types.ts`, `src/domain/species/registry.ts`, `src/domain/species/equine/{index,vertebrae,pathologies}.ts` +- `src/domain/schema/{findings,observation,report}.ts` +- `src/anatomy/{types,svgConvention,svgLoader,labels}.ts` +- `src/lib/{zoneMatch,spineZones}.ts` +- `src/app/routes/EditorRoute.tsx`, `src/components/observation/ObservationCard.tsx` +- `public/species/equine/Horse.svg`, `public/species/equine/Horse_head.svg`, `public/species/equine/pathologies.json` +- `docs/ANATOMY-SVG-CONVENTION.md`, `docs/PATHOLOGIES-FORMAT.md` (lus, mais le code fait foi quand ils divergent) + +Le fichier `anatomical-sheet-example.json` à côté de ce document contient la même reconstruction sous forme de données, avec toutes les annotations et toutes les zones du catalogue. + +## 1. Ce qui tient lieu de fiche anatomique aujourd'hui + +FACTUEL. Une "espèce" est assemblée à partir de quatre sources sans objet commun : + +| Composant | Fichier | Nature | Chargement | +|---|---|---|---| +| Manifeste | `src/domain/species/equine/index.ts:4-14` | objet TS `SpeciesManifest` compilé dans le bundle | `import.meta.glob` au build (`src/domain/species/registry.ts:16`) | +| Formule vertébrale | `src/domain/species/equine/vertebrae.ts:7-13` | constante TS | importée par le manifeste | +| SVG principal | `public/species/equine/Horse.svg` | fichier statique | `fetch` + `DOMParser` à l'ouverture de l'éditeur (`EditorRoute.tsx:135`) | +| SVG de détail | `public/species/equine/Horse_head.svg` | fichier statique | `fetch` préchargé pour chaque clé de `details` (`EditorRoute.tsx:143`) | +| Catalogue de constats | `src/domain/species/equine/pathologies.json` | JSON importé et validé Zod au boot (`pathologies.ts:11`) | `species.findings()` lazy | +| Copie du catalogue | `public/species/equine/pathologies.json` | copie octet pour octet (md5 identique) | lue seulement par `public/pathology-editor.html:790` | + +DEDUIT : la fiche anatomique est donc "le manifeste + les fichiers qu'il référence + le catalogue qu'il importe". Elle n'a ni identifiant propre, ni version, ni date, ni auteur. Son identité est la chaîne `'equine'` répétée dans `index.ts:5`, `pathologies.json` (`species.id`) et `NewReportRoute.tsx:20`. + +## 2. Inventaire composant par composant + +| Composant demandé | Existe ? | Forme réelle | Où | Statut | +|---|---|---|---|---| +| SVG principal | oui | `mainSvg: '/species/equine/Horse.svg'`, viewBox `0 0 2073.4 1629.4` | `index.ts:8`, `Horse.svg` ligne 2 | FACTUEL | +| SVG de détail | oui, un seul | `details: { head: '/species/equine/Horse_head.svg' }`, viewBox `60 100 500 380` | `index.ts:9-11` | FACTUEL | +| Relations entre SVG | oui, unidirectionnelle | attribut `data-anno-opens-detail="head"` sur un polygone du SVG principal + clé `details.head` du manifeste | `Horse.svg` (élément `zone-mpby55kd`), `index.ts:10` | FACTUEL ; le détail ne connaît pas son parent (DEDUIT : aucun attribut inverse) | +| Points anatomiques | oui | `` en paire hitbox (fill `transparent`, r+12) + visible, même `data-anno-id` préfixé `point-` | `Horse.svg` 12 points, `Horse_head.svg` 9 points | FACTUEL | +| Zones (surfaces) | oui | `` seul, `data-anno-id` préfixé `zone-` | `Horse.svg` 5 polygones colonne + 1 déclencheur | FACTUEL | +| Distinction point / zone côté application | non | le parser regroupe tout élément `[data-anno-id]` en un `Bone` sans regarder la balise | `svgConvention.ts:46-52` | FACTUEL | +| Catégories SVG | oui, libres | `data-anno-category`, chaîne opaque ; valeurs réelles `articulations`, `os`, `charni-res-vert-brales`, `zone-colonne`, `cadrans-du-cr-ne` | `svgConvention.ts:52`, `types.ts:9` | FACTUEL | +| Nom lisible de catégorie SVG | partiel | `data-anno-category-name` sur 18 éléments, non lu par le parser, lu par l'éditeur SVG | `Horse.svg`, `SvgEditorRoute.tsx:640` | FACTUEL | +| Sous-catégories SVG | non | aucun attribut de hiérarchie | | FACTUEL | +| Vertèbres | oui | régions `C|T|L|S|Cd` codées dans `VertebralRegionSchema` + comptes dans `vertebralFormula` ; déclenchées par `data-anno-special="vertebral-precision"` | `observation.ts:7`, `vertebrae.ts`, `EditorRoute.tsx:309` | FACTUEL | +| Latéralité | oui | `data-anno-lateral="bilateral"` sur 9 points ; valeur `unpaired` documentée mais jamais présente dans les SVG | `svgConvention.ts:56`, `Horse.svg` | FACTUEL | +| Paramètres spéciaux | oui, un seul utilisé | `data-anno-special`, seule valeur consommée `vertebral-precision` ; `joint-detail` proposé par l'éditeur SVG mais ignoré par l'app | `types.ts:28-35`, `SvgEditorRoute.tsx:296-299` | FACTUEL | +| Catalogue de constats | oui | `SpeciesFindings` : `schema_version`, `scope_disclaimer`, `species`, `zones` (record) | `findings.ts:56-65` | FACTUEL | +| Pathologies | oui, sous le nom "findings" | arbre `FindingNode` récursif, feuilles cochables | `findings.ts:23-45` | FACTUEL | +| Observations / motifs de consultation | oui | 2e catégorie de chaque zone, id `-observations` | `pathologies.json` | FACTUEL (convention d'auteur, non imposée par Zod) | +| Anamnèse | oui | 3e catégorie de chaque zone, id `anamnesis` ; 3 variantes de contenu selon les zones | `pathologies.json` | FACTUEL | +| Métadonnées (auteur, date, licence) | non | aucune dans les SVG ni dans le JSON | | FACTUEL | +| Disclaimer | oui | `scope_disclaimer` racine, affiché une fois par session (`osteo:disclaimer-shown`) | `findings.ts:58`, `EditorRoute.tsx:33` | FACTUEL | +| Version | partiel | `schema_version: "2.0"` du catalogue ; `Report.version: 2` du bilan ; aucune version pour le SVG ni pour le manifeste | `pathologies.json`, `report.ts:18` | FACTUEL | +| Espèce | oui | `SpeciesManifest.id/labelFr/labelEn` + `species{id,name_fr,name_en}` dans le JSON, dupliqués | `index.ts:5-7`, `pathologies.json` | FACTUEL | +| Sources / citations | prévu, vide | `sources?: SourceRef[]` validé Zod ; 0 nœud en porte dans le catalogue réel | `findings.ts:15-19` | FACTUEL | + +## 3. Homonymes à lever avant toute migration + +Le mot "zone" a trois sens dans le code, et "catégorie" en a deux. Les confondre est la principale source d'ambiguïté du brief. + +| Terme | Sens SVG | Sens catalogue | Sens bilan | +|---|---|---|---| +| zone | un `` annoté, `data-anno-id` préfixé `zone-` (convention de l'éditeur SVG, `SvgEditorRoute.tsx:1353`) | une entrée `zones[]` du JSON, avec `id`, `name_fr`, `name_en`, `categories` (`findings.ts:47-52`) | un `ObservationZone { boneId, detailSourceId?, vertebrae?, side? }` (`observation.ts:21-30`) | +| point | un `` annoté, `data-anno-id` préfixé `point-` (`SvgEditorRoute.tsx:1245`) | n'existe pas | n'existe pas : un point cliqué devient un `ObservationZone` comme un polygone | +| catégorie | `data-anno-category`, bucket visuel libre, 5 valeurs réelles | `categories[]`, premier niveau de l'arbre d'une zone, 3 par zone | n'existe pas ; le `Finding.path[0]` est l'id de catégorie catalogue | +| id | `data-anno-id` généré (`point-`), opaque | `zone.id`, lisible (`hip`), égal à la clé | `boneId` = `data-anno-id` ; `zoneId` = `zone.id` catalogue ; les deux coexistent dans une observation sans lien explicite | + +DEDUIT : dans l'application de bilan, "point" et "zone" SVG sont strictement équivalents. La seule différence de comportement vient des attributs (`special`, `lateral`, `opens-detail`), pas de la géométrie. + +## 4. Arbre logique de la fiche anatomique réelle (cheval) + +```text +Fiche anatomique "equine" [concept implicite, DEDUIT] +├── identité +│ ├── id: "equine" src/domain/species/equine/index.ts:5 +│ ├── labelFr: "Cheval" / labelEn: "Horse" index.ts:6-7 +│ └── species {id,name_fr,name_en} dupliqué pathologies.json (racine) +├── version +│ ├── SVG : aucune [ABSENT] +│ ├── manifeste : aucune [ABSENT] +│ ├── catalogue : schema_version "2.0" pathologies.json +│ └── bilan : Report.version 2 src/domain/schema/report.ts:18 +├── SVG principal /species/equine/Horse.svg index.ts:8 +│ ├── viewBox "0 0 2073.4 1629.4" +│ ├── dessin anatomique (groupes sans annotation, ~700 lignes) +│ └── dernière ligne du fichier +│ ├── 12 points (circle hitbox + circle visible, même data-anno-id) +│ │ ├── 9 articulations bilatérales (épaule, coude, boulets, hanche, grasset, jarret, sacro-iliaque, sésamoïdes) +│ │ └── 3 charnières (C7-T1, T18-L1, L6-S1), catégorie charni-res-vert-brales +│ ├── 5 polygones zone-colonne, data-anno-special="vertebral-precision" +│ │ (cervicales, thoraciques, lombaires, sacrales, caudales) +│ └── 1 polygone déclencheur zone-mpby55kd +│ data-anno-opens-detail="head", sans name-fr/en, catégorie articulations +├── SVG de détail "head" /species/equine/Horse_head.svg index.ts:10 +│ ├── même dessin que Horse.svg, viewBox "60 100 500 380" [DEDUIT : copie recadrée] +│ └── +│ ├── 5 points cadrans-du-cr-ne (pariétal, frontal, sphénoïde, temporal, occipital) +│ ├── 2 points articulations (ATM, SSB) +│ ├── 1 point os (hyoïde) +│ └── 1 point charni-res-vert-brales (C0-C1) +├── relations entre SVG +│ └── zone-mpby55kd --opens-detail="head"--> details.head [codée à la main, unidirectionnelle] +├── configuration vertébrale +│ ├── formule C7 T18 L6 S5 Cd18 vertebrae.ts:7-13 +│ └── régions autorisées C|T|L|S|Cd observation.ts:7 (schéma, pas le manifeste) +├── catalogue de constats pathologies.json (26 zones, 792 nœuds, 612 feuilles, 41 vet, 0 sources) +│ ├── scope_disclaimer (texte légal, affiché 1 fois/session) +│ ├── zones (record ordonné cranio-caudal, 26 clés) +│ │ └── {id, name_fr, name_en} +│ │ ├── categories[0] "-dysfunctions" (arbre à 2 niveaux : sous-catégorie > feuille) +│ │ ├── categories[1] "-observations" (feuilles directes ou 1 sous-niveau) +│ │ └── categories[2] "anamnesis" (feuilles directes) +│ └── feuille {id, name_fr, name_en, description_fr?, requires_vet_referral?} +├── lien SVG <-> catalogue [CALCULÉ, jamais stocké] +│ └── matchZoneFindings({fr: bone.fr, en: bone.en}, zones) ObservationCard.tsx:134 +│ (égalité stricte vérifiée pour 26/26 annotations nommées, cf. 06-svg-findings-link.md) +└── métadonnées : aucune (auteur, date, licence, provenance du dessin) [ABSENT] +``` + +Chiffres vérifiés sur les fichiers : 48 éléments porteurs de `data-anno-id` (30 dans `Horse.svg`, 18 dans `Horse_head.svg`), 27 annotations uniques, 26 nommées, toutes appariées au catalogue. + +## 5. Exemple complet reconstruit (données réelles) + +Format : `Fiche anatomique cheval → SVG → élément → ObservationZone produit → zone catalogue → constats disponibles`. + +### 5.1 Zone normale, sans latéralité : charnière C7-T1 + +```text +Fiche "equine" + └─ Horse.svg + └─ point-mpbwyyc9 (circle r=30 hitbox + circle r=18 fill #ff0000) + data-anno-name-fr="Charnière C7-T1 (cervico-thoracique)" + data-anno-name-en="C7-T1 (Cervicothoracic)" + data-anno-category="charni-res-vert-brales" (pas de lateral, pas de special) + └─ clic → toggleZone → ObservationZone { boneId: "point-mpbwyyc9" } + └─ match EN exact → zones["c7-t1"] + ├─ c7-t1-dysfunctions + │ ├─ segmental : restriction-flexion, restriction-extension, + │ │ restriction-lateroflexion, restriction-rotation, fixation + │ ├─ muscular : scalenus-tension, serratus-tension, + │ │ brachiocephalicus-tension, deep-cervical-tension + │ └─ mechanical: amplitude-asymmetry, alignment-asymmetry + ├─ c7-t1-observations + │ base-neck-stiffness, forelimb-engagement, ewe-neck-posture, + │ forelimb-lameness [requires_vet_referral] + └─ anamnesis + trauma-direct, saddle-context, posture-context, + stress-context, post-veterinary, no-identified-cause +``` + +Un constat coché produit par exemple `Finding { zoneId: "c7-t1", path: ["c7-t1-dysfunctions","segmental","fixation"], labelFrSnapshot: "Fixation de la charnière", labelEnSnapshot: "Junction fixation" }` (FACTUEL : `FindingsTreePicker.tsx:146-155`). + +### 5.2 Zone avec latéralité : hanche + +```text +Fiche "equine" + └─ Horse.svg + └─ point-mpbwtst0 (circle r=34 hitbox + circle r=22 fill #ff9500) + name-fr="Hanche (coxo-fémorale)" name-en="Hip joint" + category="articulations" data-anno-lateral="bilateral" + └─ clic → handleBilateralZone → LateralityPicker (gauche / droite / les deux) + └─ ObservationZone { boneId: "point-mpbwtst0", side: "left" } + ObservationZone { boneId: "point-mpbwtst0", side: "right" } (deux entrées distinctes) + └─ match EN exact → zones["hip"] (un picker par côté, clé "hip:left" / "hip:right") + ├─ hip-dysfunctions + │ ├─ articular : restriction-flexion, restriction-extension, + │ │ restriction-abduction-adduction, restriction-rotation, + │ │ hypomobility, hypermobility [vet] + │ ├─ muscular : gluteal-group-tension, iliopsoas-tension, + │ │ adductors-tension, biceps-femoris-tension, trigger-points + │ └─ mechanical: weight-bearing-asymmetry, amplitude-asymmetry, croup-asymmetry + ├─ hip-observations + │ ├─ ridden-work : canter-difficulty, backing-difficulty, + │ │ limb-engagement, jumping-difficulty + │ └─ limb-lameness [vet] + └─ anamnesis + trauma-direct, sport-context, posture-context, + stress-context, post-veterinary, no-identified-cause +``` + +Le `Finding` porte alors `side: "left"` (FACTUEL : `FindingsTreePicker.tsx:154`). Le catalogue lui-même ignore la latéralité : la même liste sert aux deux côtés. + +### 5.3 Zone vertébrale : vertèbres cervicales + +```text +Fiche "equine" + └─ Horse.svg + └─ zone-mpbx5hx2 (polygon 16 sommets, fill #e100ff) + name-fr="Vertèbres cervicales" name-en="Cervical Vertebrae" + category="zone-colonne" data-anno-special="vertebral-precision" + └─ clic → handleSpineZone → VertebraPicker + │ région initiale = regionFromLabel("Vertèbres cervicales") → "C" (spineZones.ts:18) + │ onglets C(7) T(18) L(6) S(5) Cd(18) depuis vertebralFormula + └─ ObservationZone { boneId: "zone-mpbx5hx2", vertebrae: [{region:"C",index:3},{region:"C",index:4}] } + └─ match EN exact → zones["cervical"] + ├─ cervical-dysfunctions + │ ├─ segmental : restriction-flexion, restriction-extension, + │ │ restriction-lateroflexion, restriction-rotation, localized-fixation + │ ├─ group : nsr-group, functional-scoliotic-attitude + │ ├─ muscular : splenius-tension, longissimus-capitis-cervicis, + │ │ scalenus-tension, brachiocephalicus-tension, multifidus-cervicis + │ └─ mechanical: lateral-bend-asymmetry, muscle-relief-asymmetry + ├─ cervical-observations + │ ├─ ridden-work : bend-asymmetry-work, head-carriage, contact-resistance + │ ├─ stumbling-proprioceptive [vet] + │ ├─ palpation-sensitivity [vet] + │ └─ new-stiffness [vet] + └─ anamnesis (6 feuilles) +``` + +Le catalogue ne connaît pas les vertèbres individuelles : `C3` et `C4` vivent dans `ObservationZone.vertebrae`, le constat est attaché à la zone `cervical` entière (FACTUEL : `Finding` n'a pas de champ vertèbre, `observation.ts:40-47`). + +### 5.4 Zone qui ouvre un détail : tête, puis ATM + +```text +Fiche "equine" + └─ Horse.svg + └─ zone-mpby55kd (polygon 15 sommets, fill #ff9500 opacité 0.06, pointillés) + data-anno-opens-detail="head" category="articulations" (aucun name-fr/en) + └─ clic → handleDetailOpen → species.details["head"] → DetailModal + │ (zone-mpby55kd n'est JAMAIS ajoutée au bilan ; EditorRoute.tsx:295-297) + └─ Horse_head.svg (viewBox 60 100 500 380) + └─ point-mpbyo7zq (circle r=27 hitbox + circle r=15 fill #ff8800) + name-fr="Articulation Temporo-Mandibulaire (ATM)" + name-en="Temporomandibular Joint (TMJ)" category="articulations" + └─ clic → toggleZone → ObservationZone { boneId: "point-mpbyo7zq", detailSourceId: "head" } + └─ match EN exact → zones["atm"] + ├─ atm-dysfunctions + │ ├─ articular : restriction-opening, restriction-closing, + │ │ restriction-lateral, restriction-protrusion, + │ │ hypomobility, hypermobility [vet] + │ ├─ muscular : masseter-tension, temporalis-tension, + │ │ pterygoid-tension, trigger-points + │ └─ mechanical: lateral-deviation-jaw, asymmetric-dental-wear, + │ opening-deviation, asymmetric-amplitude + ├─ atm-observations (8 feuilles, dont headshaking [vet]) + └─ anamnesis (6 feuilles, dont dental-context) +``` + +`detailSourceId: "head"` sert ensuite au PDF pour choisir le SVG à rasteriser (FACTUEL : `observationPage.ts:367-384`). + +### 5.5 Zone à plusieurs catégories de constats : sphénoïde + +Toutes les zones ont trois catégories. Le sphénoïde illustre en plus une anomalie d'identifiant : sa première catégorie s'appelle `ssb-dysfunctions`, comme celle de la zone `ssb` (FACTUEL, `pathologies.json`). + +```text +Horse_head.svg + └─ point-mpbymcln name-fr="Sphénoïde" name-en="Sphenoid" category="cadrans-du-cr-ne" + └─ zones["sphenoid"] + ├─ ssb-dysfunctions (id identique à zones["ssb"].categories[0].id) + │ ├─ physiological : flexion, extension, torsion-right, torsion-left, + │ │ sidebending-rotation-right, sidebending-rotation-left + │ ├─ traumatic : vertical-strain-superior, vertical-strain-inferior, + │ │ lateral-strain-right, lateral-strain-left, compression + │ ├─ intraosseous : pre-post-sphenoid, lesser-wings, greater-wings + │ └─ sutures : 8 sutures (sphenopetrosal … sphenopalatine) + ├─ sphenoid-observations + │ ├─ behavior-change : irritability, withdrawal, hypersensitivity + │ ├─ performance-drop + │ ├─ cycle-irregularity [vet] + │ └─ post-trauma-head + └─ anamnesis : trauma-direct, stress-context, posture-context, dental-context, … +``` + +Conséquence DEDUITE : un `Finding` de la zone `sphenoid` et un `Finding` de la zone `ssb` peuvent porter le même `path[0]`. Ils restent distinguables par `zoneId`, jamais par le chemin seul. + +## 6. Ce qui manque pour que cette fiche existe en tant qu'objet + +DEDUIT, à partir de l'inventaire ci-dessus : + +- aucun identifiant de fiche, aucune version, aucune date, aucun auteur ; +- aucune table d'annotations : la liste des points et zones n'existe que dans le DOM SVG ; +- aucun lien persisté entre une annotation et une zone du catalogue (voir `06-svg-findings-link.md`) ; +- aucune table des vues de détail en données : elle est codée dans un fichier TS (`index.ts:9-11`) et recopiée dans `public/pathology-editor.html:786-796` ; +- aucune métadonnée d'affichage (couleur de catégorie, ordre) hors du style inline des éléments SVG ; +- deux copies du catalogue à garder synchronisées à la main. + +## Points non déterminés + +- Origine du dessin anatomique (tracé Inkscape ? source externe ?) : aucune métadonnée dans les SVG. HYPOTHESE : export Inkscape nettoyé, au vu des `linearGradient`/`filter` en tête de fichier. +- Si `zone-mpby55kd` porte la catégorie `articulations` par choix ou par oubli (l'éditeur SVG retire normalement `data-anno-category` d'une zone de détail, `SvgEditorRoute.tsx:1139`). HYPOTHESE : annotation faite avant cette règle de l'éditeur. +- Pourquoi la première catégorie de `sphenoid` s'appelle `ssb-dysfunctions` : erreur d'auteur ou choix clinique (le sphénoïde est l'os de la SSB). Non tranché par le code. diff --git a/docs/faunosteo-audit/03-svg-editor.md b/docs/faunosteo-audit/03-svg-editor.md new file mode 100644 index 00000000..67a55f65 --- /dev/null +++ b/docs/faunosteo-audit/03-svg-editor.md @@ -0,0 +1,302 @@ +# 03. Éditeur SVG anatomique (`/svg-editor`) + +Périmètre : ce que l'éditeur SVG intégré permet réellement de faire aujourd'hui, opération par opération, avec les structures de données et les attributs qu'il écrit. + +## Sources lues + +- `src/app/routes/SvgEditorRoute.tsx` (1858 lignes, composant React + fonction `initSvgEditor`) +- `src/styles/svg-editor.css` +- `src/i18n/fr.ts` et `src/i18n/en.ts` (clés `svg_editor.*`, 71 clés) +- `src/domain/species/registry.ts` (source de la liste d'espèces) +- `src/anatomy/svgConvention.ts` (parser côté application, pour la notion de champ obligatoire) +- `public/species/equine/Horse.svg`, `public/species/equine/Horse_head.svg` +- `.claude/memory/decisions.md` (BDR-017, BDR-022) + +## 1. Nature de l'outil + +FACTUEL. L'éditeur est un outil vanilla JS d'environ 1600 lignes enveloppé dans un composant React (`SvgEditorRoute.tsx:13-245` pour le squelette JSX, `SvgEditorRoute.tsx:247-1858` pour `initSvgEditor`). Le composant monte la logique impérative dans un `useEffect` et la détruit via un `AbortController` (`SvgEditorRoute.tsx:254-256`, `SvgEditorRoute.tsx:1857`). Décision documentée en BDR-017 : enveloppe plutôt que réécriture React. + +FACTUEL. Le `useEffect` dépend de `[locale]` (`SvgEditorRoute.tsx:31-47`). Changer la langue réinitialise entièrement l'éditeur : le SVG chargé, les catégories et la sélection sont perdus. Aucun état n'est conservé en dehors du DOM. + +FACTUEL. Une balise `` est injectée au montage (`SvgEditorRoute.tsx:21-29`). + +FACTUEL. Il n'y a aucun modèle de données intermédiaire. L'état éditable est le DOM SVG lui-même, plus quelques variables de fermeture : `mode`, `selected`, `polygonPoints`, `dragging`, `draggingHandle`, `dragStart`, `zoom`, `svgRoot`, `CATEGORIES`, `loadedFileName`, `_polygonRestartMemo` (`SvgEditorRoute.tsx:257-325`, `SvgEditorRoute.tsx:1320-1329`). + +## 2. Opérations demandées par le brief + +| Opération | Statut | Où | Comment | +|---|---|---|---| +| Charger un SVG | Implémenté | `SvgEditorRoute.tsx:333-507`, `SvgEditorRoute.tsx:522-570` | Écran d'accueil à deux onglets : SVG du projet ou import de fichier | +| Afficher un SVG | Implémenté | `SvgEditorRoute.tsx:532-552` | `DOMParser` + `importNode`, insertion dans `canvasInner` | +| Identifier une zone | Implémenté | `SvgEditorRoute.tsx:713-715`, `SvgEditorRoute.tsx:991-1010` | `closest('[data-anno-id]')` puis sélection de tous les frères de même id et même catégorie | +| Créer un point | Implémenté | `SvgEditorRoute.tsx:1233-1293` | Mode `point`, paire de cercles hitbox + visible | +| Créer une zone (polygone) | Implémenté | `SvgEditorRoute.tsx:1331-1388` | Mode `polygon`, clics successifs, validation Entrée | +| Modifier un point | Implémenté | `SvgEditorRoute.tsx:729-830`, `SvgEditorRoute.tsx:1112-1214` | Drag (cx/cy), panneau d'édition (noms, catégorie, latéralité, rayon, opacité) | +| Modifier une zone | Implémenté | `SvgEditorRoute.tsx:1721-1786` | Drag global, poignées de sommets, insertion/suppression de sommet, redessin | +| Supprimer un point | Implémenté | `SvgEditorRoute.tsx:1216-1231` | Bouton ou touche Suppr, retire tous les frères de même id et catégorie | +| Supprimer une zone | Implémenté | idem | Même fonction `deleteSelected` | +| Définir une catégorie | Implémenté | `SvgEditorRoute.tsx:1567-1594`, `SvgEditorRoute.tsx:1112-1214` | Catégorie par défaut pour les nouveaux éléments, ou select dans le panneau d'édition | +| Définir une latéralité | Implémenté | `SvgEditorRoute.tsx:167-171`, `SvgEditorRoute.tsx:1159-1163` | Select à deux valeurs : vide (unilatéral) ou `bilateral` | +| Définir les attributs `data-anno-*` | Implémenté partiellement | `SvgEditorRoute.tsx:1134-1210` | Écrits par `applyEdit`, jamais édités librement (pas de champ "id", pas de champ "special" par élément) | +| Créer un zoom | Implémenté, visuel seulement | `SvgEditorRoute.tsx:301-323`, `SvgEditorRoute.tsx:1851-1855` | Boutons +, −, ⌂ qui appliquent `transform: scale()` sur le ``. Rien n'est écrit dans le fichier | +| Créer un SVG de détail à partir d'une partie du SVG | NON IMPLEMENTE | aucune occurrence | Voir `04-detail-svg-generation.md` | +| Relier le détail au principal | Implémenté partiellement | `SvgEditorRoute.tsx:136-152`, `SvgEditorRoute.tsx:1131-1141` | Pose `data-anno-opens-detail=""` sur un polygone. Le mapping id → fichier reste manuel dans le manifeste d'espèce | +| Gérer les vertèbres | NON IMPLEMENTE dans l'éditeur | `SvgEditorRoute.tsx:296-299`, `SvgEditorRoute.tsx:1535-1565` | Seule possibilité : attacher le comportement `vertebral-precision` à une catégorie. Aucune notion de vertèbre, de région ou de formule | +| Gérer les zones bilatérales | Implémenté au niveau attribut | `SvgEditorRoute.tsx:1159-1163` | `data-anno-lateral="bilateral"`. Aucun dessin miroir, aucune paire gauche/droite | +| Gérer les cas particuliers | Implémenté partiellement | `SvgEditorRoute.tsx:1535-1565` | `data-anno-special` libre, par catégorie, saisi via `prompt()` | +| Sauvegarder le résultat | Implémenté, téléchargement uniquement | `SvgEditorRoute.tsx:1823-1849` | Sérialisation + téléchargement `_edited.svg`. Aucune écriture dans `public/` | + +## 3. Chargement + +### 3.1 Écran d'accueil + +FACTUEL `SvgEditorRoute.tsx:333-403`. Deux onglets : + +- `SVG du projet` (`buildProjectPicker`, `SvgEditorRoute.tsx:405-465`) : liste les espèces via `getAllSpecies()` du registre, puis pour l'espèce choisie une vue `Corps entier` (`mainSvg`) et une vue `Détail : ` par entrée de `details`. Le fichier est récupéré par `fetch(svgPath)`. Le nom de téléchargement devient `_edited.svg` (`SvgEditorRoute.tsx:452-453`). +- `Importer un fichier` (`buildUploadPicker`, `SvgEditorRoute.tsx:467-481`) : input file `.svg` ou drag-and-drop sur le canvas (`SvgEditorRoute.tsx:483-507`). + +### 3.2 `sanitizeSvg` + +FACTUEL `SvgEditorRoute.tsx:511-520`. Retire `