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.
5.0 KiB
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.