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

18 KiB

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 <nom>_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 <title> 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
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.