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.
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.tsxpublic/pathology-editor.html(1700 lignes)src/anatomy/svgConvention.ts,src/lib/{zoneMatch,spineZones}.ts,src/components/observation/*.tsx,src/components/canvas/*.tsxsrc/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+useEffectplutô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_TEMPLATESethide-<cat>correspondent à une convention antérieure des SVG (les noms figurent dansdocs/ANATOMY-SVG-CONVENTION.mdcomme "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.