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.
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 fichierstests/unit/*.test.tset*.test.tsx(en-têtes et noms de cas ; contenu complet pouranatomy.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.mdLRN-026,.claude/memory/journal.md2026-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-87est 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 en10-current-limitations.mdC4.- Aucun test ne lit
public/species/equine/pathologies.json; seule la copiesrc/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:runsurdevelopn'a pas été observé dans cet audit ; le TODO rapporte 180/180 verts au 2026-07-12. - Certains
it(pourraient êtreit.skipou paramétrés ; le grep ne le distingue pas. Aucunskip/todon'a été repéré dans les fichiers lus en entier.