# 11. Les deux éditeurs actuels et la fusion future Périmètre : comparaison de l'éditeur SVG et de l'éditeur de pathologies tels qu'ils existent (section 11 du brief), puis inventaire de ce qui est réutilisable, extractible, couplé ou à refactorer pour une future page "Fiche anatomique" à deux panneaux (section 12). Aucune architecture SaaS n'est proposée ici. ## Sources lues - `src/app/routes/SvgEditorRoute.tsx` (1858 lignes), `src/styles/svg-editor.css`, `src/app/routes/EditorsRoute.tsx`, `src/app/App.tsx` - `public/pathology-editor.html` (1700 lignes) - `src/anatomy/svgConvention.ts`, `src/lib/{zoneMatch,spineZones}.ts`, `src/components/observation/*.tsx`, `src/components/canvas/*.tsx` - `src/domain/species/{types,registry}.ts`, `src/domain/species/equine/index.ts`, `src/i18n/{fr,en}.ts` - `.claude/memory/decisions.md` (BDR-017, BDR-020, BDR-021, BDR-022) ## 1. Fiche : SVG Editor | Rubrique | Réalité | Statut | |---|---|---| | Point d'entrée | route React `/svg-editor` (`App.tsx:20`), lien depuis `/editors` (`EditorsRoute.tsx:20`) | FACTUEL | | Responsabilité | annoter un SVG : créer/déplacer/supprimer des points (`circle`) et des polygones, leur donner `data-anno-*`, gérer des catégories (couleur, visibilité, comportement spécial), marquer un polygone comme déclencheur de détail, exporter le SVG modifié | FACTUEL | | Implémentation | un composant React dont tout le comportement vit dans `initSvgEditor()` (`SvgEditorRoute.tsx:247`), fonction vanilla DOM appelée dans un `useEffect` dépendant de `locale` (`SvgEditorRoute.tsx:31-47`) ; changement de langue = destruction et ré-initialisation complète de l'éditeur, SVG chargé perdu | FACTUEL | | Entrée | soit un SVG du projet choisi via `getAllSpecies()` (`SvgEditorRoute.tsx:327`, liste `mainSvg` + `details`) et chargé par `fetch`, soit un fichier `.svg` uploadé ou glissé, sanitisé (`sanitizeSvg`, ligne 511) | FACTUEL | | Normalisations à l'import | migration des anciens attributs `data-bone-*` (ligne 591), restyle des zones de détail (572), dédoublonnage d'ids partagés entre catégories (610), détection des catégories depuis les attributs et le `fill` (635) | FACTUEL | | Sortie | téléchargement navigateur d'un fichier `_edited.svg` (`exportSVG`, ligne 1823 ; nom calculé lignes 453 et 496) ; aucune écriture dans `public/`, aucun appel serveur | FACTUEL | | Fichiers manipulés | en lecture : `/species/equine/Horse.svg`, `/species/equine/Horse_head.svg` ; en écriture : aucun (le fichier produit doit être recopié à la main dans `public/species/`) | FACTUEL | | Format de sauvegarde | SVG sérialisé par `XMLSerializer`, préfixé de la déclaration XML, aperçus et poignées retirés (lignes 1828-1838) ; les attributs `class="selected"` sont nettoyés, les attributs `data-anno-category-name` et `` ajoutés par l'éditeur restent | FACTUEL | | Dépendances | React (wrapper), `getAllSpecies`/`speciesLabel` (registry), `useLocaleStore` + `getDict` (i18n, 71 clés `svg_editor.*` dans `fr.ts`), `svg-editor.css`, `AppHeader` | FACTUEL | | Ce qu'il ne fait pas | ne crée pas de SVG de détail, ne recadre pas un viewBox, ne lit ni n'écrit le catalogue, ne vérifie pas qu'un libellé existe dans le catalogue, ne gère pas `unpaired` (seulement vide ou `bilateral`, lignes 168-171) | FACTUEL | ## 2. Fiche : Pathology Editor | Rubrique | Réalité | Statut | |---|---|---| | Point d'entrée | fichier statique `public/pathology-editor.html`, lien `<a href="/pathology-editor.html">` depuis `/editors` (`EditorsRoute.tsx:32`) ; hors du routeur React | FACTUEL | | Responsabilité | afficher un SVG annoté, cliquer une zone, retrouver la zone correspondante du catalogue JSON par libellé, éditer son arbre (ajouter/modifier/supprimer un nœud, descriptions, flag vétérinaire, sources), créer une zone manquante, télécharger le JSON | FACTUEL | | Implémentation | 1700 lignes de HTML + CSS + JS vanilla (ES5, `var`) dans une IIFE, aucun build, aucun import depuis `src/` | FACTUEL | | Entrée | onglet "Liste pré-câblée" : `SPECIES_CONFIG` codé en dur (`pathology-editor.html:786-796`) avec une seule espèce `equine`, deux vues (`Horse.svg`, `Horse_head.svg`) et `jsonPath: '/species/equine/pathologies.json'` ; onglet "Upload manuel" : un SVG + un JSON (10 Mo max chacun) | FACTUEL | | Validation du JSON | présence de `schema_version`, `species`, `zones` seulement (lignes 1114-1116) ; pas de validation Zod, pas de vérification de structure des nœuds | FACTUEL | | Lien SVG → zone | copie inline de `normalizeLabel`/`levenshtein`/`scorePair`/`matchZone` (lignes 850-908, commentaire "ported from src/lib/zoneMatch.ts") | FACTUEL | | Sortie | téléchargement `pathologies-<species.id>-<AAAAMMJJ-HHMMSS>.json` (`downloadJson`, lignes 1648-1665) ; aucun appel serveur ; le fichier doit être recopié à la main dans `src/domain/species/equine/` ET dans `public/species/equine/` | FACTUEL | | Génération d'ids | slug kebab-case du `name_en` (fallback `name_fr`), suffixe `-2`, `-3` en cas de collision parmi les frères (`generateId`, ligne 912) | FACTUEL | | Dépendances | aucune bibliothèque ; lit `localStorage['osteo:locale']` (ligne 715) et l'écrit (766) ; 76 clés de traduction inline (`TRANSLATIONS`, lignes 556-713) dupliquant le style de l'app | FACTUEL | | Ce qu'il ne fait pas | ne modifie pas le SVG, ne crée pas d'annotation, ne réordonne pas les zones ni les nœuds, ne supprime pas une zone, n'affiche pas un nœud sans `name_fr` correctement (le nom FR est forcé égal au nom EN si vide, ligne 1574) | FACTUEL | ## 3. Côte à côte | Critère | SVG Editor | Pathology Editor | |---|---|---| | Technologie | React wrapper + vanilla TS | HTML statique + vanilla JS | | Build | bundlé par Vite | copié tel quel dans `dist/` | | Lit le registry des espèces | oui (`getAllSpecies`) | non (`SPECIES_CONFIG` en dur) | | Lit le catalogue | non | oui (fetch de la copie `public/`) | | Écrit le SVG | téléchargement | non | | Écrit le catalogue | non | téléchargement | | i18n | dictionnaire de l'app (`svg_editor.*`) | 76 clés inline | | Matching libellé | non | copie de `zoneMatch.ts` | | Sanitisation SVG importé | oui (`sanitizeSvg`) | oui (lignes 1127-1136, même logique) | | Zoom | `transform: scale()` CSS, 3 boutons | identique | | Persistance entre sessions | aucune | aucune (drapeau `dirty` + `beforeunload`) | | Taille | 1858 lignes | 1700 lignes | ## 4. Pourquoi ils sont séparés DEDUIT du journal de décisions `.claude/memory/decisions.md` (ce sont des choix documentés, pas du code) : - BDR-017 (ligne 141) : l'éditeur SVG était un outil standalone de ~1630 lignes ; il a été enveloppé dans React par `useRef` + `useEffect` plutôt que réécrit, pour éviter des régressions sur le drag, les polygones et le zoom. - BDR-020 (ligne 149) : l'éditeur de pathologies est resté un HTML autonome parce qu'il s'adresse aux experts du domaine, pas aux praticiens, et ne partage aucun état avec l'app. - BDR-021 (ligne 158) : le matcher a été recopié inline parce qu'un HTML sans build ne peut pas importer un module TS ; la cohérence des deux copies repose sur une mise à jour manuelle. - BDR-022 (ligne 191) : l'asymétrie a été confirmée en juin 2026. Argument central : l'éditeur de pathologies produit le fichier de production que l'app lit, donc zone de changement minimal ; l'enveloppe React de l'éditeur SVG est décrite comme "le pire des deux patterns", pas un modèle à copier. Conséquence FACTUELLE : les deux outils ne partagent aucune ligne de code. Les seuls points communs sont des conventions (attributs `data-anno-*`, clé `osteo:locale`) et des chemins de fichiers codés en dur. ## 5. Ce qui est couplé aujourd'hui Liste des couplages qu'une page unique "Fiche anatomique" devrait défaire ou assumer. Tous FACTUELS sauf mention. | Couplage | Où | Effet | |---|---|---| | Lien zone SVG ↔ zone catalogue recalculé par libellé en trois endroits | `ObservationCard.tsx:134` (app), `pathology-editor.html:896` (éditeur), `observationPage.ts:441` (PDF, via `findingsTree.zones[zoneId]` sur l'id déjà résolu) | renommer un libellé dans le SVG ou le JSON casse silencieusement le lien ; aucune table de vérité | | Manifeste compilé | `src/domain/species/equine/index.ts` : chemins SVG, clés de détail, formule vertébrale, loader du catalogue | ajouter une vue ou une espèce exige un rebuild et un déploiement | | Deux copies du catalogue | `src/domain/species/equine/pathologies.json` (lu par l'app) et `public/species/equine/pathologies.json` (lu par l'éditeur), identiques aujourd'hui | une édition exportée doit être recopiée aux deux endroits ; aucune vérification de synchronisation | | Liste des vues codée dans l'éditeur de pathologies | `pathology-editor.html:786-796` | une nouvelle espèce ou un nouveau détail n'apparaît pas dans l'éditeur sans éditer le HTML | | Région vertébrale déduite du libellé | `spineZones.ts:13-24` (`regionFromLabel`) | la région n'est stockée nulle part ; un libellé hors des racines FR/EN perd les vertèbres | | `CATEGORY_TEMPLATES` de l'éditeur SVG | `SvgEditorRoute.tsx:276-282` : `articulation`, `charniere`, `cadran-crane`, `os-overlay`, `spine-zone` | aucune de ces clés n'existe dans `Horse.svg` (catégories réelles `articulations`, `charni-res-vert-brales`, `cadrans-du-cr-ne`, `zone-colonne`, `os`) ; les templates ne s'appliquent jamais aux SVG du projet, les couleurs viennent du `fill` | | Règles CSS `hide-<cat>` | `svg-editor.css:523-528` | mêmes clés obsolètes ; la case "visibilité" d'une catégorie réelle ne masque rien (DEDUIT : la classe `hide-articulations` n'a pas de règle) | | Ids d'annotation générés au clic | `SvgEditorRoute.tsx:1245` (`'point-' + Date.now().toString(36)`), `:1353` (`'zone-'`) | opaques, non enregistrés ailleurs ; unicité garantie seulement par l'horloge du poste | | i18n dupliquée | `src/i18n/fr.ts` / `en.ts` pour l'app et l'éditeur SVG ; `TRANSLATIONS` inline pour l'éditeur de pathologies | deux jeux de chaînes à maintenir | | Ré-initialisation sur changement de langue | `SvgEditorRoute.tsx:31-47` | le travail en cours est perdu quand on change de langue | | Sanitisation SVG écrite deux fois | `SvgEditorRoute.tsx:511`, `pathology-editor.html:1127-1136` | à maintenir en parallèle | ## 6. Ce qui peut être réutilisé tel quel Modules sans état global ni dépendance à un fichier précis. DEDUIT par lecture des signatures. | Module | Signature / contrat | Pourquoi réutilisable | |---|---|---| | `parseSvgBones(svgRoot)` et `getBoneIdFromEvent(event)` | `svgConvention.ts:44`, `:96` | pur DOM, aucun fetch, aucune dépendance React ; marche sur n'importe quel `SVGSVGElement` annoté | | `SpeciesFindingsSchema`, `ZoneFindingsSchema`, `FindingNodeSchema`, `SourceRefSchema` | `findings.ts` | contrat Zod du catalogue, indépendant de la source (fichier, API) | | `ObservationSchema`, `FindingSchema`, `ObservationZoneSchema`, `ReportSchema` | `observation.ts`, `report.ts` | contrat du bilan | | `FindingsTreePicker` | props `zoneId, tree, side?, selected, onChange` (`FindingsTreePicker.tsx:17-23`) | composant React pur sur un `ZoneFindings` ; ne sait pas d'où vient l'arbre | | `VertebraPicker` | props `initial, formula, title, initialRegion?, onConfirm` | pur ; la formule est injectée | | `LateralityPicker` | props `existingSides, onSelect` | pur | | `AnatomyCanvas` | props `src, boneStates, onZoneClick` (`AnatomyCanvas.tsx:11-16`) | réutilisable à condition d'abstraire le `loadSvg(src)` interne (fetch d'URL) | | `zoneMatch.ts` | `matchZoneFindings(bone, zones)` | utile comme outil de suggestion lors de l'édition ; pas comme lien de vérité | | `spineZones.ts` | `collectSpineVertebrae`, `syncSpineZones`, `findSpineZoneId` | purs, testés ; mais dépendent de `regionFromLabel` (voir couplages) | | Pipeline PDF | `exportReportToPdf(report, {locale})` | réutilisable si on lui fournit les mêmes entrées ; dépend aujourd'hui de `getSpecies` et de `fetch` sur `public/` (voir `08-report-and-pdf.md`) | | `sanitizeSvg` | `SvgEditorRoute.tsx:511-520` | 10 lignes, à extraire dans un module partagé | | `useLocaleStore`, `getDict`, `pickLocaleLabel` | `state/localeStore.ts`, `i18n/` | déjà partagés | ## 7. Ce qui doit être extrait avant toute fusion | À extraire | Depuis | Forme cible (sans préjuger de l'architecture) | |---|---|---| | Opérations d'annotation : `addCircleAt` (1233), `finalizePolygon` (1331), `applyEdit` (1112), `deleteSelected` (1216), `exportSVG` (1823), `migrateOldAttributes` (591), `fixDuplicateIds` (610), `detectCategories` (635) | fermeture `initSvgEditor` de `SvgEditorRoute.tsx` | fonctions pures sur un `SVGSVGElement` + un état `CATEGORIES` passé en paramètre ; aujourd'hui elles lisent `document.getElementById(...)` et des variables de fermeture | | Édition d'arbre : `buildNodeEl` (1386), `showInlineForm` (1476), `addSourceRow` (1614), `generateId` (912), `countNodes`/`countLeaves` (926-942) | `pathology-editor.html` | composants et helpers ; aujourd'hui en DOM impératif sur `jsonData` muté en place | | `SPECIES_CONFIG` | `pathology-editor.html:786-796` | doit disparaître au profit du manifeste (ou de ce qui le remplacera) | | Génération d'ids d'annotation | `SvgEditorRoute.tsx:1245`, `:1353` | à centraliser ; `lib/id.ts` existe déjà pour les ids de bilan (UUID) | | Styles de détail (`DETAIL_ZONE_STYLE`, 288-294) et comportements spéciaux (`SPECIAL_BEHAVIORS`, 296-299) | `SvgEditorRoute.tsx` | données de configuration, pas du code | ## 8. Ce qui devra être refactoré DEDUIT. Points où l'existant ne tient pas pour une page unique à deux panneaux sur une fiche sélectionnée. | Sujet | Problème actuel | Pourquoi ça bloque une page unique | |---|---|---| | Identité d'une zone | `data-anno-id` opaque côté SVG, `zone.id` lisible côté catalogue, lien par libellé | le panneau 2 doit afficher les constats de la zone cliquée dans le panneau 1 ; sans id partagé, le lien dépend d'un calcul fragile et un libellé en cours d'édition casse le lien pendant la frappe | | Catalogue en deux exemplaires | `src/` et `public/` | une page qui édite doit avoir une seule source | | Manifeste en TS compilé | `index.ts` | une fiche créée ou modifiée dans l'interface ne peut pas être enregistrée sans rebuild | | Vues de détail codées à la main | `details` dans le manifeste, `data-anno-opens-detail` posé dans l'éditeur SVG, fichier recadré produit hors outil (`04-detail-svg-generation.md`) | un zoom créé dans l'interface n'a nulle part où s'inscrire | | Régions vertébrales | enum en dur `C|T|L|S|Cd` (`observation.ts:7`) + racines de libellé en dur (`spineZones.ts:18-22`) | une fiche d'une autre espèce ou un libellé libre ne peut pas déclarer sa région | | Catégories SVG | chaîne libre, nom lisible dans `data-anno-category-name`, couleur dans le `fill` | pas de liste de catégories de la fiche, donc rien à afficher dans un panneau "points / zones" hors re-scan du DOM | | i18n | dictionnaire app + 76 clés inline | une seule source nécessaire | | Cycle de vie de l'éditeur SVG | tout dans un `useEffect([locale])` | impossible de garder l'état de l'éditeur quand un autre panneau change ; impossible de tester hors DOM | | Validation du JSON édité | aucune (présence de 3 clés) | un catalogue invalide peut être exporté puis faire échouer le boot de l'app (`pathologies.ts:11` lève) | | Ordre des zones | ordre d'insertion de l'objet JSON (convention cranio-caudale) | l'éditeur ne permet pas de réordonner ; une zone créée est ajoutée en fin | ## 9. Fonctionnalités futures qui exigent une évolution de l'existant Liste limitée à ce que le brief annonce (page unique, panneau points/zones, panneau pathologies/observations/anamnèse). Pour chaque point, ce qui manque dans l'existant. Aucune solution proposée. | Fonctionnalité future | Ce qui manque aujourd'hui (FACTUEL) | |---|---| | Sélectionner une fiche anatomique | aucun objet "fiche" ; la seule sélection est `animal.speciesId` dans un formulaire de bilan | | Panneau 1 : lister et éditer les points / zones | la liste n'existe que par scan du DOM SVG (`refreshElementList`, `SvgEditorRoute.tsx:1617`) | | Panneau 2 : éditer les constats de la zone sélectionnée | le lien zone → catalogue est un calcul par libellé ; l'édition d'arbre est en DOM impératif dans un autre fichier | | Enregistrer sans rebuild | les deux éditeurs produisent des téléchargements ; l'app lit un JSON importé au build et des SVG servis depuis `public/` | | Créer un zoom depuis une zone | aucun code ; le seul détail existant a été produit à la main (`04-detail-svg-generation.md`) | | Plusieurs versions d'une fiche | aucune version sur le SVG ni sur le manifeste ; `schema_version` versionne le format, pas le contenu | | Plusieurs praticiens | aucun identifiant de praticien hors le bloc texte du bilan ; aucune authentification | | Garder un bilan lisible après modification de la fiche | partiellement couvert par les snapshots de libellé (`labelFrSnapshot`), pas pour les libellés de zone SVG qui sont relus depuis le SVG à l'export (`08-report-and-pdf.md`) | ## Points non déterminés - Si les clés `CATEGORY_TEMPLATES` et `hide-<cat>` correspondent à une convention antérieure des SVG (les noms figurent dans `docs/ANATOMY-SVG-CONVENTION.md` comme "valid categories") ou à un projet d'uniformisation jamais appliqué. HYPOTHESE : convention documentée puis abandonnée quand les SVG ont été annotés avec l'éditeur, qui slugifie le nom saisi (`addCategory`, `SvgEditorRoute.tsx:1574-1579`, d'où `charni-res-vert-brales`). - Si l'éditeur de pathologies est utilisé en production par un expert externe (ce qui justifierait de ne pas le toucher) ou seulement par le développeur. Le journal de décisions parle d'un "domain expert" sans préciser l'usage de l'outil.