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

Faunosteo : audit technique de l'existant (fiche anatomique, éditeurs, bilan)

Photographie exacte du code au 2026-10-06, branche develop (83e40af, 27 commits devant main). Aucun fichier de production n'a été modifié pour produire cet audit. Le futur SaaS n'est pas conçu ici : ce dossier décrit ce qui existe, afin qu'un travail d'architecture puisse être fait séparément.

Comment lire

Chaque rapport marque le niveau de certitude de ses affirmations :

Marqueur Sens
FACTUEL Présent dans le code ou les données, avec fichier:ligne ou commande de vérification
DEDUIT Conclusion raisonnée à partir du code, non exécutée ou non écrite explicitement
HYPOTHESE Supposition, à confirmer auprès de l'auteur du projet

Le code et les données font foi. Les documents du repo (CLAUDE.md, docs/ANATOMY-SVG-CONVENTION.md, README.md) sont cités, et leurs écarts avec le code sont signalés, jamais pris pour acquis.

Les numéros de ligne renvoient aux fichiers du repo à la révision ci-dessus ; les mêmes fichiers sont copiés dans relevant-files/ pour lecture hors repo.

Rapports

Fichier Contenu
01-repository-map.md Arborescence, rôles, graphe d'imports, fichiers indispensables / optionnels / UI / historiques
02-anatomical-sheet.md Ce qu'est aujourd'hui une fiche anatomique (implicite), arbre logique, exemple complet reconstruit
03-svg-editor.md Éditeur SVG : chaque opération, structures, champs, identifiants, attributs réels
04-detail-svg-generation.md Comment le SVG de détail head existe réellement, ce qui le charge, ce qui manque pour généraliser
05-findings-editor.md Catalogue pathologies.json, schéma Zod, chargement, éditeur autonome, catégories réelles
06-svg-findings-link.md Lien SVG ↔ catalogue par libellé, algorithme, table complète des 27 annotations, exemples
07-special-cases.md Colonne, vertèbres, charnières, latéralité, détail, fallbacks, données invalides, versions
08-report-and-pdf.md Ce que le bilan persiste, pipeline PDF, pièce jointe JSON, réimport, dépendances externes
09-data-model.md Tous les types et schémas, tableau donnée / source / persistée / calculée
10-current-limitations.md Points à surveiller pour une migration SaaS, classés Critique / Important / Faible
11-future-merge.md SVG Editor vs Pathology Editor, couplages, réutilisable / à extraire / à refactorer
12-species-generalization.md Générique vs spécifique cheval, tableau par fonction
13-tests.md Inventaire des tests, zones critiques non couvertes
anatomical-sheet-example.json Fiche anatomique cheval reconstruite sous forme logique (documentation, non consommée par l'app)
relevant-files/ Copies verbatim des fichiers clés, index dans relevant-files/INDEX.md

Chiffres pivots vérifiés

Donnée Valeur Vérification
Annotations uniques Horse.svg 18 (12 points, 5 zones colonne, 1 déclencheur de détail) parseSvgBones, test anatomy.horse.test.ts
Annotations uniques Horse_head.svg 9 idem
Éléments porteurs de data-anno-id (2 fichiers) 48 grep -o
Attributs data-anno-* réellement présents id 48, category 48, name-fr 47, name-en 47, category-name 18, lateral 18, special 5, opens-detail 1 grep -oh | sort | uniq -c
Catégories SVG réelles articulations, os, charni-res-vert-brales, zone-colonne, cadrans-du-cr-ne grep
Horse_head.svg vs Horse.svg diff de 10 lignes : viewBox 60 100 500 380 et groupe osteo-overlays diff
Catalogue schema_version "2.0", 26 zones, 792 nœuds, 612 feuilles, 41 feuilles vétérinaire, 0 sources, 62 description_fr jq
Correspondance SVG ↔ catalogue 26 zones nommées sur 26 en égalité stricte FR et EN comparaison de chaînes
Schéma du bilan Report.version = 2 src/domain/schema/report.ts
Tests 30 fichiers sous tests/unit/, 180 cas it( comptés statiquement (le README du repo dit 174, périmé) ls, grep -c

Méthode

Lecture intégrale de src/, public/species/, public/pathology-editor.html, scripts/, docs/, tests/, .claude/memory/ (décisions BDR, apprentissages LRN, blocages BLK, audits TOUR / BUGS-FOUND) et de l'historique git des SVG. Les comptes sur les SVG et le catalogue ont été produits par grep, diff, md5sum et jq. Le matcher de libellés a été reproduit hors vitest sur les données réelles pour établir la table de 06-svg-findings-link.md ; le code TypeScript lui-même n'a pas été exécuté pendant l'audit, ce qui est signalé comme DEDUIT là où cela compte.

Portée exclue

Pas de proposition de schéma PostgreSQL ni d'architecture Supabase. Pas de refactoring, pas de correction, pas de commit. Les écarts documentés dans 10-current-limitations.md sont des constats, pas des recommandations d'implémentation.