Files
faunosteo/docs/faunosteo-audit/03-svg-editor.md
T
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

303 lines
25 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 `<meta name="robots" content="noindex,nofollow">` 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 `<svg>`. 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="<id>"` 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 `<nom>_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 : <clé>` par entrée de `details`. Le fichier est récupéré par `fetch(svgPath)`. Le nom de téléchargement devient `<fichier>_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 `<script>` et `<foreignObject>`, les attributs `on*` et les `href` commençant par `javascript:`, sur la racine et tous les descendants. Ajouté lors du tour 2026-07-12 (SEC-2).
### 3.3 `loadSVG`
FACTUEL `SvgEditorRoute.tsx:522-570`. Ordre des étapes :
1. `DOMParser` en `image/svg+xml`, échec si aucun `<svg>`.
2. `importNode` puis `sanitizeSvg`.
3. Si pas de `viewBox`, en fabrique un `0 0 <width|1000> <height|1000>` (`SvgEditorRoute.tsx:543-549`).
4. Supprime `width` et `height` de la racine (`SvgEditorRoute.tsx:551-552`). Cette suppression est conservée à l'export.
5. Réinitialise `CATEGORIES`, `selected`, `dragging`, `draggingHandle`, `zoom`.
6. `migrateOldAttributes` → `normalizeDetailZones` → `fixDuplicateIds` → `detectCategories` → `applyAllCategoryColors`.
7. Pose les écouteurs `click`, `mousedown`, `contextmenu` sur la racine SVG.
### 3.4 `migrateOldAttributes`
FACTUEL `SvgEditorRoute.tsx:591-608`. Renomme cinq attributs d'une convention antérieure si le nouveau nom est absent : `data-bone-id` → `data-anno-id`, `data-bone-fr` → `data-anno-name-fr`, `data-bone-en` → `data-anno-name-en`, `data-category` → `data-anno-category`, `data-opens-detail` → `data-anno-opens-detail`. L'ancien attribut est supprimé dans tous les cas. Cette migration n'existe que dans l'éditeur. Le parser de l'application (`svgConvention.ts`) ne la connaît pas.
### 3.5 `normalizeDetailZones`
FACTUEL `SvgEditorRoute.tsx:572-589`. Pour tout élément portant `data-anno-opens-detail` : ajoute la classe `detail-zone`, et si le `fill` est différent de `transparent`, force `fill` à `#808080`, `fill-opacity` à `0.20` si absent, et pour un polygone `stroke` `#606060` + `stroke-dasharray` `8,4` si absent.
DEDUIT. Sur `Horse.svg` tel que livré, le polygone `zone-mpby55kd` a `fill="#ff9500"` et `fill-opacity="0.06"` : il sera recoloré en gris dès son chargement dans l'éditeur, et l'export conservera ce gris. Le fichier actuel n'a donc pas été réexporté depuis cette version de l'éditeur, ou a été corrigé à la main ensuite.
### 3.6 `fixDuplicateIds`
FACTUEL `SvgEditorRoute.tsx:610-633`. Regroupe les éléments par `data-anno-id` puis par `data-anno-category`. Si un même id apparaît sous plusieurs catégories, toutes les catégories sauf la première reçoivent l'id `<id>-<cat>` (et l'attribut `id` est réécrit s'il valait l'ancien id). Conséquence : l'éditeur considère que la clé réelle d'un élément est le couple (id, catégorie), alors que le parser de l'application regroupe par id seul.
### 3.7 `detectCategories` et `CATEGORY_TEMPLATES`
FACTUEL `SvgEditorRoute.tsx:276-282`. Cinq modèles codés en dur :
| Clé | Couleur | Nom affiché |
|---|---|---|
| `articulation` | `#fb5607` | Articulations |
| `charniere` | `#d00000` | Charnieres vertebrales |
| `cadran-crane` | `#06a77d` | Cadrans du crane |
| `os-overlay` | `#f72585` | Os overlay |
| `spine-zone` | `#7209b7` | Zones colonne |
FACTUEL. Les catégories réellement présentes dans les SVG du cheval sont `articulations`, `os`, `charni-res-vert-brales`, `zone-colonne`, `cadrans-du-cr-ne`. Aucune ne coïncide avec un modèle (pluriel, slug accentué dégradé, nom différent). `detectCategories` (`SvgEditorRoute.tsx:635-664`) tombe donc toujours dans la branche "catégorie inconnue" : couleur lue sur le `fill` du premier élément non transparent de la catégorie (sinon `#00aaff`), nom lu dans `data-anno-category-name` (sinon le slug lui-même). Un `data-anno-special` trouvé sur un élément est remonté sur la catégorie entière.
DEDUIT. Les slugs `charni-res-vert-brales` et `cadrans-du-cr-ne` proviennent de `addCategory` (`SvgEditorRoute.tsx:1574-1579`) : la normalisation NFD y est appliquée avant `replace(/[^a-z0-9]+/g,'-')` mais la plage de combinants retirée est `[̀-ͯ]` (U+0300 à U+036F) ; les "è"/"â" ont pourtant été remplacés par `-`. HYPOTHESE : la version de `addCategory` qui a généré ces slugs ne retirait pas les diacritiques (bug historique), les slugs sont depuis figés dans les fichiers et dans `pathologies`-independant. Ils sont des identifiants opaques et doivent être traités comme tels.
### 3.8 `applyAllCategoryColors`
FACTUEL `SvgEditorRoute.tsx:666-677`. Pour chaque catégorie détectée, réécrit `fill` (et `stroke` pour un polygone) sur tous les éléments non transparents de la catégorie. Les couleurs d'origine du fichier sont donc remplacées par la couleur de catégorie à chaque chargement.
## 4. Modes et interactions
FACTUEL `SvgEditorRoute.tsx:832-844`, `SvgEditorRoute.tsx:934-950`.
| Mode | Touche | Clic sur le SVG |
|---|---|---|
| `select` | `1` | Sélectionne l'élément annoté le plus proche, sinon désélectionne |
| `point` | `2` | `addCircleAt(x, y)` |
| `polygon` | `3` | Ajoute un sommet au polygone en cours (`polygonPoints`) |
Raccourcis : `Entrée` valide le polygone, `Échap` annule le polygone ou désélectionne, `Suppr` supprime l'élément sélectionné. Les touches sont ignorées quand le focus est dans un champ de formulaire.
Les coordonnées de clic sont converties dans le repère du SVG par `getSVGPoint` (`SvgEditorRoute.tsx:927-932`, `getScreenCTM().inverse()`), donc le zoom CSS n'altère pas les coordonnées écrites.
## 5. Création
### 5.1 Point : `addCircleAt`
FACTUEL `SvgEditorRoute.tsx:1233-1293`.
- Groupe conteneur `<g id="osteo-overlays">` créé à la fin du SVG s'il n'existe pas (`SvgEditorRoute.tsx:1238-1243`).
- Id généré : `'point-' + Date.now().toString(36)` (`SvgEditorRoute.tsx:1245`).
- Deux `<circle>` sont ajoutés avec les mêmes `cx`, `cy` arrondis à l'entier et les mêmes attributs `data-anno-*` :
- hitbox : `r="28"`, `fill="transparent"`, `pointer-events="all"`, `style="cursor:pointer"` ;
- visible : `r="16"`, `fill=<couleur catégorie>`, `fill-opacity="0.65"`, `stroke="#000"`, `stroke-width="1.5"`, `pointer-events="none"`, `id=<même id>`.
- Noms par défaut depuis les clés i18n `svg_editor.new_point_fr` / `svg_editor.new_point_en`.
- `data-anno-category` = catégorie par défaut du select, `data-anno-category-name` et `data-anno-special` copiés depuis `CATEGORIES[cat]` si présents.
- Un `<title>` enfant contenant le nom FR.
- Retour en mode `select`, sélection du hitbox, focus sur le champ nom FR.
FACTUEL. Les points réels de `Horse.svg` ont `r="34"` / `r="22"` (corps) et `r="30"` / `r="18"` (charnières), ceux de `Horse_head.svg` `r="27"` / `r="15"`. Ces valeurs correspondent à la règle d'édition `hitbox = rayon + 12` (`SvgEditorRoute.tsx:1202-1208`) appliquée après création.
### 5.2 Polygone : `finalizePolygon`
FACTUEL `SvgEditorRoute.tsx:1331-1388`.
- Refus si moins de 3 sommets.
- Id : `'zone-' + Date.now().toString(36)` sauf en redessin (id conservé via `_polygonRestartMemo`).
- `points` arrondis à l'entier, `fill=<couleur>`, `fill-opacity="0.30"`, `stroke=<couleur>`, `stroke-width="2"`, `pointer-events="all"`, `id=<id>`, `data-anno-id`, `data-anno-name-fr/en` par défaut, `data-anno-category`, `data-anno-category-name` et `data-anno-special` si la catégorie les porte.
- `<title>` = `"<FR> / <EN>"`.
- Un seul élément : pas de paire hitbox/visible pour les polygones.
Aperçu pendant la saisie : `updatePolygonPreview` (`SvgEditorRoute.tsx:1295-1318`) ajoute un `polygon.polygon-preview` et des `circle.polygon-preview-pt`, tous retirés à la validation, à l'annulation et à l'export.
### 5.3 Redessin : `restartCurrentPolygon`
FACTUEL `SvgEditorRoute.tsx:1770-1786`. Mémorise id, noms, catégorie, fill, fill-opacity, stroke, stroke-width dans `_polygonRestartMemo`, supprime le polygone, passe en mode `polygon`. `finalizePolygon` réutilise la mémo (`SvgEditorRoute.tsx:1338-1364`). Le `data-anno-lateral` et le `data-anno-special` ne sont pas mémorisés : `special` est re-dérivé de la catégorie, `lateral` est perdu (DEDUIT de la liste des champs de la mémo, `SvgEditorRoute.tsx:1320-1329`).
## 6. Sélection et modification
### 6.1 Sélection
FACTUEL `SvgEditorRoute.tsx:991-1010`. `selectElement` marque `.selected` l'élément cliqué et tous les frères du même parent portant le même `data-anno-id` et la même `data-anno-category`. Ouvre le panneau d'édition, affiche les poignées si polygone, rafraîchit la liste.
### 6.2 Panneau d'édition : `showEditPanel`
FACTUEL `SvgEditorRoute.tsx:1020-1094`. Lit sur l'élément sélectionné `data-anno-name-fr`, `data-anno-name-en`, `data-anno-category`, `data-anno-lateral`. Identifie l'élément visible (frère non transparent) pour lire `fill-opacity` et `r`. Le bloc "ouvre une vue détaillée" n'est affiché que pour un polygone (`SvgEditorRoute.tsx:1080-1091`). Si `data-anno-opens-detail` est présent, les champs nom/catégorie/latéralité sont masqués.
### 6.3 Application : `applyEdit`
FACTUEL `SvgEditorRoute.tsx:1112-1214`. Déclenché sur `change` des champs nom FR, nom EN, catégorie, latéralité, sur `input` des sliders rayon et opacité, et sur la checkbox/le champ de la vue détaillée (`SvgEditorRoute.tsx:853-892`). S'applique à tous les frères (même id, même catégorie d'origine).
Cas "pas de vue détaillée" (`SvgEditorRoute.tsx:1142-1164`, `SvgEditorRoute.tsx:1183-1209`) :
| Attribut écrit | Source | Condition |
|---|---|---|
| `data-anno-name-fr` | champ FR | seulement si non vide (un champ vidé ne supprime pas l'attribut) |
| `data-anno-name-en` | champ EN | idem |
| `data-anno-category` | select | si non vide |
| `data-anno-category-name` | `CATEGORIES[cat].name` | si la catégorie a un nom |
| `data-anno-special` | `CATEGORIES[cat].special` | posé si la catégorie en a un, sinon supprimé |
| `data-anno-lateral` | select | `bilateral` posé, vide → attribut supprimé |
| `data-anno-opens-detail` | | supprimé, et `stroke-dasharray` supprimé |
| `<title>` | | `"<FR> / <EN>"` ou `"<FR>"` |
| `fill`, `stroke` | couleur de catégorie | éléments non transparents |
| `fill-opacity` | slider / 100 | éléments non transparents |
| `r` | slider | cercle visible = valeur, cercle transparent = valeur + 12 |
Cas "ouvre une vue détaillée" coché et id renseigné (`SvgEditorRoute.tsx:1134-1141`, `SvgEditorRoute.tsx:1166-1182`) :
- écrit `data-anno-opens-detail=<id saisi>` ;
- supprime `data-anno-name-fr`, `data-anno-name-en`, `data-anno-category`, `data-anno-category-name`, `data-anno-special` ;
- `<title>` = `"Zoom: <id>"` ;
- style `DETAIL_ZONE_STYLE` (`SvgEditorRoute.tsx:288-294`) : `fill="#808080"`, `fill-opacity` = valeur du slider ou `0.20`, `stroke="#606060"`, `stroke-width="2"`, `stroke-dasharray="8,4"` ; classe `detail-zone`.
FACTUEL. Le polygone déclencheur réel `zone-mpby55kd` de `Horse.svg` porte `data-anno-category="articulations"`, `fill="#ff9500"`, `fill-opacity="0.06"`, `stroke="#ff9500"` et un `<title>` `"🔍 Zoom: head"`. DEDUIT : il n'a pas été produit par la version actuelle d'`applyEdit`, qui aurait retiré la catégorie et posé le gris. Il provient d'une version antérieure de l'outil ou d'une édition manuelle. Il satisfait néanmoins le parser de l'application, qui exige `data-anno-category` sur tout élément annoté (`svgConvention.ts:24-31`) : un déclencheur produit par la version actuelle de l'éditeur, sans catégorie, ferait lever `SvgConventionError` au chargement dans l'application. Voir `10-current-limitations.md`.
### 6.4 Déplacement
FACTUEL `SvgEditorRoute.tsx:729-830`, `SvgEditorRoute.tsx:952-985`. `mousedown` en mode `select` sur un élément annoté : capture un instantané de position (`cx`/`cy` pour cercle et ellipse, chaîne `points` pour polygone) de l'élément et de ses frères de même id et même catégorie. `mousemove` applique `dx`, `dy` à tous. Pour un polygone les coordonnées déplacées sont arrondies au dixième. Pas d'annulation (pas d'historique).
### 6.5 Sommets de polygone
FACTUEL `SvgEditorRoute.tsx:1721-1768`. Poignées dessinées dans un `<g id="polygon-handles">` ajouté en fin de SVG : une `circle.polygon-handle` par sommet (`r=8`) et une `circle.polygon-midhandle` par arête (`r=6`). Clic sur une midhandle insère un sommet (`SvgEditorRoute.tsx:697-708`), drag d'une poignée déplace le sommet (`SvgEditorRoute.tsx:733-762`, `SvgEditorRoute.tsx:794-810`), Alt+clic ou clic droit supprime le sommet si plus de 3 (`SvgEditorRoute.tsx:738-749`). Le groupe est retiré à l'export.
### 6.6 Suppression
FACTUEL `SvgEditorRoute.tsx:1216-1231`. Confirmation navigateur, puis suppression de tous les frères de même id et même catégorie. Aucune suppression correspondante dans un catalogue de constats.
## 7. Catégories
FACTUEL.
- Ajout (`SvgEditorRoute.tsx:1567-1594`) : nom libre + couleur ; slug = minuscules, NFD, retrait des combinants, non alphanumériques → `-`. Refus si vide ou existant. La catégorie n'est écrite dans le SVG que lorsqu'un élément l'utilise.
- Renommage (`SvgEditorRoute.tsx:1491-1501`) : `prompt()` navigateur, écrit `data-anno-category-name` sur tous les éléments de la catégorie. Le slug ne change jamais.
- Couleur (`SvgEditorRoute.tsx:1479-1489`) : réécrit `fill`/`stroke` sur tous les éléments non transparents.
- Suppression (`SvgEditorRoute.tsx:1596-1615`) : supprime tous les éléments de la catégorie après confirmation.
- Visibilité (`SvgEditorRoute.tsx:1474-1477`) : bascule une classe `hide-<slug>` sur le conteneur. Les règles CSS correspondantes sont codées en dur pour six slugs seulement : `articulation`, `charniere`, `cadran-crane`, `os-overlay`, `spine-zone`, `custom` (`svg-editor.css:523-528`). Aucune règle n'existe pour `articulations`, `os`, `charni-res-vert-brales`, `zone-colonne`, `cadrans-du-cr-ne`. Sur les SVG du cheval, la case "visibilité" n'a donc aucun effet.
- Comportement spécial (`SvgEditorRoute.tsx:1535-1565`) : `prompt()` avec deux suggestions `vertebral-precision` et `joint-detail` (`SvgEditorRoute.tsx:296-299`), valeur libre, écrite comme `data-anno-special` sur tous les éléments de la catégorie, ou retirée si vide. `joint-detail` n'est consommé nulle part dans l'application (grep `joint-detail` : une seule occurrence, cette liste).
## 8. Liste des éléments
FACTUEL `SvgEditorRoute.tsx:1617-1708`. Une entrée par `data-anno-id` distinct, triée par catégorie puis nom FR, filtrable sur id, nom FR et nom de catégorie. Un élément `data-anno-opens-detail` est listé `Detail: <id>` avec la catégorie `detail`. Clic : sélection, défilement, clignotement `.flashing`.
## 9. Export
FACTUEL `SvgEditorRoute.tsx:1823-1849`. Clone de la racine, retrait des previews, du groupe `polygon-handles`, des classes `selected` et `flashing`. Prologue XML ajouté, `XMLSerializer`, téléchargement d'un Blob `image/svg+xml` nommé `loadedFileName`.
Conséquences :
- aucune écriture dans `public/species/` : l'utilisateur remplace le fichier à la main (FACTUEL, aucune API d'écriture dans le code) ;
- les attributs `class=""` vides, `data-anno-category-name`, le groupe `osteo-overlays` et les `<title>` restent dans le fichier (visibles dans `Horse.svg`) ;
- `width`/`height` de la racine restent supprimés ;
- les couleurs d'origine sont remplacées par les couleurs de catégorie (section 3.8).
## 10. Réponses aux sous-questions A à H
### A. Structures de données exactes
FACTUEL. Il n'y a pas d'interface ni de type décrivant un point ou une zone dans l'éditeur. Les seules structures typées :
```ts
// SvgEditorRoute.tsx:283-286
CATEGORIES: Record<string, { color: string; name: string; visible: boolean; special?: string }>
// SvgEditorRoute.tsx:261-272
draggingHandle: { vIdx; points; originalPoint; polygon } | null
dragStart: { x; y; snap?; siblingSnaps? } | null
// SvgEditorRoute.tsx:1320-1329
_polygonRestartMemo: { id; fr; en; cat; fill; fillOpacity; stroke; strokeWidth } | null
```
Le "modèle" persistant est l'ensemble des attributs `data-anno-*` sur les éléments SVG. Le modèle lu par l'application est l'interface `Bone` (`src/anatomy/types.ts:17-40`) : `id`, `fr`, `en`, `category`, `opensDetail?`, `special?`, `lateral?`, `els`.
### B. Champs obligatoires
FACTUEL, côté application (`svgConvention.ts:15-32`) : `data-anno-id` non vide et `data-anno-category` non vide, sous peine de `SvgConventionError`. Côté éditeur : rien n'est obligatoire, l'éditeur écrit toujours id et catégorie à la création.
### C. Champs optionnels
`data-anno-name-fr`, `data-anno-name-en`, `data-anno-opens-detail`, `data-anno-special`, `data-anno-lateral`, `data-anno-category-name` (ce dernier est lu par l'éditeur seulement, ignoré par `parseSvgBones`).
### D. Champs générés automatiquement
| Champ | Génération |
|---|---|
| `data-anno-id` et `id` | horodatage base 36 préfixé `point-` ou `zone-` |
| `data-anno-name-fr/en` | libellé i18n "Nouveau point" / "New point" / "Nouvelle zone" / "New zone" |
| `data-anno-category-name` | copié depuis le nom de catégorie |
| `data-anno-special` | copié depuis la catégorie |
| `<title>` | dérivé des noms ou de l'id de détail |
| `fill`, `stroke`, `fill-opacity`, `r`, `stroke-width`, `pointer-events`, `style`, `class` | valeurs fixes ou dérivées de la catégorie |
### E. Identifiants générés
FACTUEL. `Date.now().toString(36)` (`SvgEditorRoute.tsx:1245`, `SvgEditorRoute.tsx:1353`). Exemple réel : `point-mpbwrkp0`, `zone-mpbx5hx2`. Unicité garantie à la milliseconde près seulement, dans une seule session de navigateur ; aucun registre, aucune vérification de collision avec un fichier de détail. Le suffixe `-<cat>` de `fixDuplicateIds` est le seul mécanisme de dédoublonnage, et seulement entre catégories différentes.
### F. Identification d'une zone
Éditeur : couple (`data-anno-id`, `data-anno-category`) dans un même parent. Application : `data-anno-id` seul, tous fichiers confondus (`EditorRoute.tsx:175-181`, fusion principal + détails sans écrasement).
### G. Identification d'un point
Identique à une zone. Le préfixe `point-` ou `zone-` est un choix cosmétique de l'éditeur. `parseSvgBones` ne distingue pas cercle et polygone ; `Bone` ne porte ni type géométrique ni coordonnées.
### H. Attributs réellement présents dans les SVG actuels
FACTUEL (comptage sur `public/species/equine/*.svg`) :
| Attribut | Occurrences | Remarque |
|---|---|---|
| `data-anno-id` | 48 | 27 valeurs distinctes (18 + 9) |
| `data-anno-category` | 48 | valeurs : `articulations`, `os`, `charni-res-vert-brales`, `zone-colonne`, `cadrans-du-cr-ne` |
| `data-anno-name-fr` | 47 | absent sur le déclencheur `zone-mpby55kd` |
| `data-anno-name-en` | 47 | idem |
| `data-anno-category-name` | 18 | seulement sur les 9 points du corps à `articulations`/`os`, valeur égale au slug |
| `data-anno-lateral` | 18 | toujours `bilateral`, 9 points du corps |
| `data-anno-special` | 5 | toujours `vertebral-precision`, 5 polygones colonne |
| `data-anno-opens-detail` | 1 | valeur `head` |
Attributs SVG associés présents : `cx`, `cy`, `r`, `points`, `fill`, `fill-opacity`, `stroke`, `stroke-width`, `stroke-dasharray`, `pointer-events`, `style`, `class`, `id`, et un `<title>` enfant par élément.
## Points non déterminés
- HYPOTHESE sur l'origine des slugs `charni-res-vert-brales` / `cadrans-du-cr-ne` (bug de normalisation historique). Le code actuel d'`addCategory` ne reproduit pas ce résultat sur "Charnières vertébrales".
- HYPOTHESE sur l'origine exacte du polygone déclencheur `zone-mpby55kd` (version antérieure de l'outil ou édition manuelle). Le journal mémoire ne le précise pas.