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

77 lines
5.0 KiB
Markdown

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