Files
faunosteo/docs/faunosteo-audit/13-tests.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

125 lines
11 KiB
Markdown

# 13. Tests existants et couverture
Périmètre : inventaire exhaustif des tests automatisés du dépôt (`tests/unit/`), ce qu'ils couvrent par thème, et les parties critiques de la fiche anatomique, des éditeurs et du bilan qui ne sont pas couvertes.
## Sources lues
- `vitest.config.ts`, `tests/setup.ts`, les 30 fichiers `tests/unit/*.test.ts` et `*.test.tsx` (en-têtes et noms de cas ; contenu complet pour `anatomy.horse`, `anatomy.svgConvention`, `lib.zoneMatch`, `lib.spineZones`, `pdf.roundtrip`, `pdf.zoneLabels`, `species.equineFindings`, `schema.observation`, `schema.report`)
- `README.md` ("174 tests across 30 files"), `.claude/tasks/TODO.md` ("180/180 tests" après le tour 2026-07-12), `.claude/audits/TOUR.md`
- `.claude/memory/learnings.md` LRN-026, `.claude/memory/journal.md` 2026-05-21
## 1. Décompte
FACTUEL : 30 fichiers dans `tests/unit/`. Comptage par `grep -cE "^\s*(it|test)\("` : 180 cas. La suite n'a pas été exécutée dans cet audit (consigne "ne rien lancer qui modifie"). Le README annonce 174 (état avant le tour 2026-07-12), le TODO annonce 180 après les commits `f58a49f` (restauration du brouillon, 4 cas) et `c484067` (plafond d'inflation, 2 cas). Le comptage statique concorde avec 180.
Environnement : `happy-dom`, `globals: true`, setup `@testing-library/jest-dom` (`vitest.config.ts`, `tests/setup.ts`). Aucun test navigateur réel, aucun test end-to-end.
## 2. Inventaire par thème
### SVG, parsing, convention
| Fichier | Cas | Couvre |
|---|---|---|
| `anatomy.svgConvention.test.ts` | 10 | regroupement par `data-anno-id`, lecture de `opens-detail`, `special`, `lateral`, zones sans nom acceptées, catégorie libre acceptée, erreurs sur `id` vide et `category` absente, `getBoneIdFromEvent` sans annotation |
| `anatomy.horse.test.ts` | 8 | parse des vrais fichiers : `Horse.svg` 18 annotations, 5 `zone-colonne`, 1 déclencheur `head`, 9 `articulations`, 3 `charni-res-vert-brales` ; `Horse_head.svg` 9 annotations, 5 `cadrans-du-cr-ne`, 2 `articulations` |
| `anatomy.svgLoader.test.ts` | 2 | `loadSvg` retourne un `SVGSVGElement`, lève sur réponse non ok |
| `components.AnatomyCanvas.test.tsx` | 2 | SVG injecté inline, `onZoneClick` reçoit le bon id |
### Zones, vertèbres, latéralité
| Fichier | Cas | Couvre |
|---|---|---|
| `lib.spineZones.test.ts` | 11 | `findSpineZoneId` par région, `collectSpineVertebrae` (union, priorité, dédoublonnage), `syncSpineZones` (remplacement, création, élagage, zones non colonne préservées, région sans zone SVG ignorée) |
| `components.VertebraPicker.test.tsx` | 7 | onglets depuis la formule, toggle + confirm, onglet initial par `initialRegion`, `regionFromLabel` FR/EN/inconnu |
| `schema.observation.test.ts` | 19 | enums sévérité et région, `Vertebra`, `Finding` (minimal, vet, chemin vide, zoneId vide), `LateralSide`, `ObservationZone` avec et sans `side`, deux zones même `boneId` côtés différents, observation avec vertèbres et findings |
### Matching SVG ↔ catalogue
| Fichier | Cas | Couvre |
|---|---|---|
| `lib.zoneMatch.test.ts` | 23 | `normalizeLabel` (accents, parenthèses, vides), `levenshtein`, `scorePair` (exact 0, sous-chaîne 1, flou 2+d, infini, vides), `matchZoneFindings` sur un catalogue de 3 zones fictives (`sphenoid`, `ssb`, `atm`) : EN exact, FR seul, abréviation, typos, non-apparié, catalogue vide, non-confusion sphenoid/ssb |
### Catalogue de constats
| Fichier | Cas | Couvre |
|---|---|---|
| `species.equineFindings.test.ts` | 5 | le JSON réel passe `SpeciesFindingsSchema`, `species.id === 'equine'`, disclaimer non vide, au moins une feuille, toutes les feuilles ont FR et EN |
| `species.registry.test.ts` | 3 | `getSpecies('equine')`, inconnu → undefined, `getAllSpecies` contient equine |
| `components.FindingsTreePicker.test.tsx` | 11 | fil d'Ariane, descente dans une catégorie, émission d'un `Finding` avec snapshots, drapeau vet, désélection, retour, compteurs sur nœuds intermédiaires (4 cas), isolement par `zoneId` |
### Bilan et état
| Fichier | Cas | Couvre |
|---|---|---|
| `schema.report.test.ts` | 6 | report minimal, `nextAppointment` date/période, rejet v1 et v3, praticien sans nom |
| `smoke.test.ts` | 7 | id, dates, `ReportSchema` valide/invalide, `assert` |
| `state.reportStore.test.ts` | 10 | `initReport` (version 2, id, createdAt, observation initiale, index 0), `reset`, `addObservation`, `updateObservation`, `removeObservation` (clamp), déplacement haut/bas |
| `state.reportStore.setters.test.ts` | 4 | setters identité, no-op sans report |
| `state.reportStore.restore.test.ts` | 4 | restauration depuis `osteo:draft`, brouillon invalide, absent, effacé après reset |
| `state.draftMirror.test.ts` | 2 | miroir à chaque changement, effacement au reset |
| `state.practitionerCache.test.ts` | 4 | lecture vide, aller-retour, JSON corrompu, clear |
| `state.localeStore.test.ts` | 3 | défaut fr, setLocale, persistance |
| `lib.dates.test.ts` | 7 | formatage fr/en, erreurs |
| `lib.id.test.ts` | 2 | id non vide, distinct |
### PDF export, import, attachement
| Fichier | Cas | Couvre |
|---|---|---|
| `pdf.roundtrip.test.ts` | 7 | rejet de bytes non PDF, aller-retour d'un report **sans observation** en fr et en en, flux non vides, marqueur `(!)` encodable en WinAnsi, rejet d'un PDF v1 avec `foundVersion` |
| `pdf.attachment.test.ts` | 2 | attache et extrait le JSON, erreur sans attachement |
| `pdf.attachment.inflate.test.ts` | 2 | inflation normale, bombe au-dessus de 16 Mo → null |
| `pdf.zoneLabels.test.ts` | 4 | `buildZoneLabels` avec fetch mocké sur les vrais SVG : labels des points de détail (`point-mpbyo7zq`, `point-mpbymcln`), labels du principal, tolérance à un 404 du détail, espèce inconnue |
| `pdf.svgToPng.test.ts` | 2 | PNG valide, repli `toDataURL` |
### i18n et UI
| Fichier | Cas | Couvre |
|---|---|---|
| `i18n.dicts.test.ts` | 2 | parité des clés fr/en, valeurs non vides |
| `i18n.useT.test.tsx` | 3 | clé connue fr/en, clé manquante |
| `components.LanguageSwitcher.test.tsx` | 2 | `aria-pressed`, changement de locale |
| `components.Brand.test.tsx` | 1 | alt du logo |
| `ui.Button.test.tsx` | 2 | clic, disabled |
| `ui.Dialog.test.tsx` | 3 | fermé, ouvert, clic fond |
## 3. Ce que les tests garantissent sur la fiche anatomique (DEDUIT)
- Les deux SVG cheval respectent le minimum du parser (id + catégorie) et leurs comptes par catégorie sont figés par `anatomy.horse.test.ts`. Un changement de nombre de zones casse ce test, ce qui joue le rôle de garde-fou de régression du contenu.
- Le catalogue cheval est structurellement valide et bilingue au niveau des feuilles.
- Le matcher est testé sur un catalogue fictif de 3 zones, pas sur les 26 réelles.
- Le roundtrip PDF prouve l'attachement et la validation Zod, pas la fidélité des observations.
## 4. Parties critiques insuffisamment couvertes
| Zone | Constat (FACTUEL : absence de test) | Risque |
|---|---|---|
| Éditeur SVG | `SvgEditorRoute.tsx` (1 858 lignes) : 0 test. Ni `loadSVG`, `migrateOldAttributes`, `fixDuplicateIds`, `detectCategories`, `addCircleAt`, `finalizePolygon`, `applyEdit`, `deleteSelected`, ni `exportSVG` | l'outil qui produit le SVG source n'a aucune garantie de non-régression ; impossible de refactorer en sécurité |
| Éditeur de constats | `public/pathology-editor.html` : 0 test. La copie inline de `zoneMatch` (`:850-908`) n'est jamais comparée à `src/lib/zoneMatch.ts` ; LRN-026 suggère ce test sans qu'il existe | dérive silencieuse entre l'application et l'outil qui produit le catalogue |
| Chaîne de clic | `EditorRoute.onZoneClick` (`:290-320`) et ses branches `handleSpineZone`, `handleBilateralZone`, `toggleZone`, `activateFallbackObservation`, `handleDetailOpen` : 0 test | comportement central du bilan (toggle, ouverture détail, picker vertèbres, choix de côté, "clear both sides") non protégé |
| `LateralityPicker` | 0 test | sélection gauche/droite/les deux |
| `DetailModal` | 0 test ; le chargement du SVG de détail et `detailBones` (`EditorRoute.tsx:162-181`) non testés | régression type BLK-003 (clics du détail ignorés) possible |
| `ObservationCard.zonesWithTree` | 0 test de la dérivation zones → pickers (dédoublonnage par `tree.id:side`) | une zone de détail ou bilatérale pourrait perdre son picker |
| Cohérence SVG ↔ catalogue réel | aucun test ne parcourt les 27 annotations des SVG cheval contre les 26 zones du catalogue ; l'égalité stricte a été vérifiée à la main (journal 2026-05-21) et dans cet audit | une faute de frappe dans un libellé casse le picker sans alerte, ou le matcher flou rattache à une mauvaise zone |
| Cohérence `opens-detail` ↔ manifeste | aucun test ne vérifie que chaque valeur `data-anno-opens-detail` est une clé de `details` | déclencheur mort silencieux (`EditorRoute.tsx:295` fait un `return` sans erreur) |
| Convention doc ↔ parser | aucun test ne lie `docs/ANATOMY-SVG-CONVENTION.md` au code ; la doc est déjà obsolète (voir `10-current-limitations.md` I5) | |
| Roundtrip PDF réel | `pdf.roundtrip.test.ts` utilise `observations: []` ; aucune observation avec zones, vertèbres, côté, findings, texte libre n'est exportée puis réimportée ; `rasterizeSvg` est mocké (`:8`) | le rendu de `observationPage` (`colorizedSvgString`, sections, pagination) n'est jamais exécuté en test |
| Extraction de secours | `traverseForJsonAttachment` (`attachment.ts:107-132`) non testé ; seul `inflateFlate` l'est | PDF modifiés par un autre outil |
| Snapshots de labels | aucun test ne vérifie qu'un `Finding` reste lisible après modification du catalogue (BDR-010) | la promesse "rapports anciens lisibles" n'est que de principe |
| Findings orphelins | aucun test sur le retrait d'une zone laissant des `Finding` (BDR-019) | |
| `syncSpineZones` avec vrais SVG | testé sur des bones fictifs ; `regionFromLabel` est testé, mais pas la chaîne complète sur `Horse.svg` | |
| `buildZoneLabels` repli | le repli sur `boneId` brut (`observationPage.ts:407`) n'est pas testé | |
| Parité des deux `pathologies.json` | aucun test | divergence silencieuse |
| `AnimalForm` espèces | le libellé EN d'espèce (B-6, `b047d35`) n'a pas de test | |
## 5. Observations complémentaires
- `tests/unit/pdf.zoneLabels.test.ts:81-87` est le seul test exerçant la robustesse à un asset manquant ; il montre que le code est conçu pour tolérer l'absence d'un SVG, ce qui est précisément le mode de dégradation silencieuse décrit en `10-current-limitations.md` C4.
- Aucun test ne lit `public/species/equine/pathologies.json` ; seule la copie `src/` est importée (`species.equineFindings.test.ts:2`).
- Les comptes du README (174) sont périmés ; le TODO (180) concorde avec le comptage statique.
## Points non déterminés
- Le résultat réel de `pnpm test:run` sur `develop` n'a pas été observé dans cet audit ; le TODO rapporte 180/180 verts au 2026-07-12.
- Certains `it(` pourraient être `it.skip` ou paramétrés ; le grep ne le distingue pas. Aucun `skip`/`todo` n'a été repéré dans les fichiers lus en entier.