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