# 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.