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.
303 lines
25 KiB
Markdown
303 lines
25 KiB
Markdown
# 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.
|