Files
faunosteo/.claude/tasks/contracts/2026-11-06-v1-2-6-findings-nav-design.md
bchanot 212126c6ce docs(docs): V1-2.6 annotations-findings complement, boards 17-22, study
Owner brief: bidirectional navigation between annotations and findings.
Relations audit (one finding_zone_id link, no new association), six
boards from the equine draft data, placement U2b, risks, tests, owner
decisions F1-F16. Design only; U1 plan untouched.
2026-11-06 13:15:15 +01:00

7.5 KiB

CONTRACT — v1-2-6-findings-nav-design

  • date: 2026-11-06 | flow: design complement (docs and mockups only) | branch: feature/v1-2-anatomical-sheets
  • status: active
  • worktree: /home/bchanot/Documents/faunosteo-v1-2 (every command from this absolute path; never DEV: the supabase_*_faunosteo containers are DEV; no sandbox needed for this track)
  • base: 2e46c14 (U1 contract and challenged plan, awaiting the owner's plan checkpoint). Commit in place, push; no merge, no gitflow.sh finish.
  • context: the U1 plan .claude/tasks/plans/2026-11-06-v1-2-6-ux-u1.md stays as committed; this track may only PROPOSE a named amendment to it, applied after the owner's approval.

REQUEST (verbatim — IMMUTABLE)

avant, demande de modification ou detail a apporter :

FAUNOSTEO — Nouvelle exigence UX : navigation bidirectionnelle entre annotations et constats

Le propriétaire ajoute une exigence fonctionnelle aux maquettes validées.

Cette demande ne doit PAS interrompre le plan U1 actuellement en cours, ni provoquer une implémentation prématurée.

Fonctionnement souhaité

A. Depuis le schéma anatomique

Lorsqu'un utilisateur sélectionne un point ou une zone du SVG :

  • Afficher les constats associés à cette annotation anatomique.
  • Permettre d'ajouter un constat depuis cette sélection.
  • Permettre de modifier les constats existants.
  • Permettre de gérer leur association anatomique.
  • Conserver les familles de constats du modèle existant.

Exemple : sélectionner le grasset affiche les constats associés au grasset.

B. Depuis l'onglet Constats

Ajouter :

  • Une barre de recherche avec filtrage instantané.
  • Un compteur de résultats.
  • Un bouton « Filtrer sur le schéma ».
  • Un volet permettant de choisir une ou plusieurs vues anatomiques.
  • La sélection graphique de points ou de zones pour filtrer les constats.
  • La combinaison du filtre visuel et de la recherche textuelle.
  • Une action pour réinitialiser les filtres.

Les filtres sont des états d'interface : ils ne doivent pas modifier ni sauvegarder le document.

C. Correspondance anatomique

Auditer les relations existantes entre annotations, vues, zones de constats et constats.

Éviter les doublons lorsque plusieurs annotations représentent une même région anatomique.

Ne pas inventer de nouvelles associations dans le modèle sans démontrer qu'elles sont nécessaires.

D. Contraintes

  • Respecter les autorisations existantes.
  • Préserver le mode lecture seule sur téléphone en V1-2.
  • Préserver le fonctionnement du cœur Rust et la compatibilité historique.
  • Rendre les sélections et filtres accessibles au clavier.
  • Ne pas modifier la structure documentaire sans validation spécifique.

Travail demandé

Après finalisation du plan U1 actuel :

  1. Examiner si l'architecture U1 doit prévoir des points d'intégration pour cette fonctionnalité.
  2. Identifier dans quelle sous-étape UX elle doit être implémentée, ou proposer une sous-étape dédiée.
  3. Produire un complément de maquettes ciblé sur ces interactions.
  4. Documenter les risques techniques et les tests nécessaires.
  5. S'arrêter à la validation de cette conception complémentaire.

Aucun code ne doit être modifié pour cette nouvelle fonctionnalité avant approbation.

Ne pas toucher à DEV, ne pas fusionner et ne pas commencer V1-2.7.

CLARIFICATIONS

(none yet; owner questions are listed in the study's « Décisions à prendre » section, never answered by the implementer)

ACCEPTANCE CRITERIA

  1. Audit (request C): the study docs/development/V1-2-6_UX_FINDINGS_NAV.md states, with file:line references, every existing link between annotations, views, finding zones, finding categories (families), findings, vertebral regions and references, which side holds it and its cardinality, the core rules that check it, and counts from the equine draft document (annotations per zone, zones without annotation, annotations without zone, zones shown by several annotations); a new association in the model is proposed only with a demonstrated need, and flagged as requiring the owner's specific validation.
  2. Duplicates (request C): the study and the boards say how findings are shown once when several annotations name the same finding zone (both directions: from the drawing and in the schematic filter).
  3. U1 integration (work item 1): the study says whether U1 needs integration points; any needed one is a named amendment proposal for .claude/tasks/plans/2026-11-06-v1-2-6-ux-u1.md, not applied; the U1 plan and contract are unchanged by this track.
  4. Placement (work item 2): the study names the sub-step that implements the feature (or a dedicated one), with its dependencies on U1-U6, the files it would touch, whether it needs a Rust core operation (BDR-043, « Rust computes, TypeScript reads ») and the wasm budget effect.
  5. Boards (work item 3): a targeted complement in docs/design/v1-2-6-constats/ (HTML source + one PNG per board, rendered with the project's pinned Chromium through the v1-2-6 render.cjs pattern), in the validated v1-2-6 visual language, covering: A — an annotation selected on the drawing shows its findings by family, add from the selection, edit, manage the association; B — Constats tab with instant search, result count, « Filtrer sur le schéma », a panel choosing one or more views, graphical selection of points or zones, combined text and visual filter, reset; and the states: read-only (rights, frozen) and narrow read-only below 1 024 px, keyboard alternative to the graphical selection, no result, an annotation without finding zone, a zone shown by several annotations. Names and counts come from the equine draft document, computed in the source, never typed.
  6. Risks and tests (work item 4): the study lists the technical risks (with probability and mitigation) and the tests per kind (unit, core if any, e2e, accessibility, regression) for the feature.
  7. Constraints: no change under apps/, crates/, supabase/, packages/, scripts/, docs/design/v1-2-6/; filters described as interface state only (no document change, no save); permissions, phone read-only (O14 A), the core and the historical documents unchanged by the design; no V1-2.7 control; the untracked faunosteo-v1-2-6-revue-ux-chatgpt.md never staged. CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 2e46c14..HEAD -- apps crates supabase packages scripts docs/design/v1-2-6 && git diff --quiet -- apps crates supabase packages scripts docs/design/v1-2-6 && ! git ls-files --error-unmatch faunosteo-v1-2-6-revue-ux-chatgpt.md >/dev/null 2>&1 && echo FN_SCOPE_OK EXPECT: FN_SCOPE_OK EVIDENCE: MET exit=0 marker-found :: FN_SCOPE_OK
  8. Every visible choice the design makes beyond the request is listed in the study for the owner (« Décisions à prendre »), with a recommendation; none is presented as decided.
  9. A fresh independent review of the boards (design) and a fresh verifier against this contract; justified gaps fixed; exact verdicts reported. STOP at the validation of this complementary design.

FILE SCOPE

  • docs/design/v1-2-6-constats/** (new: maquettes.html, PNG boards, contact sheet, REVUE.md)
  • docs/development/V1-2-6_UX_FINDINGS_NAV.md (new study)
  • docs/design/README.md (one pointer line to the complement, marked « proposition, non validée »)
  • .claude/tasks/TODO.md, this contract, .claude/memory (through memory.sh)
  • NOT in scope: apps/, crates/, supabase/, packages/, scripts/, docs/design/v1-2-6/, the U1 plan and contract, the V1-1 checkout