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

11 KiB

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.