Owner brief « Ratification finale U1 et autorisation conditionnelle d'implémentation » (BDR-105): study §6 tests, §7 table, 7.2, 7.3, UX plan U2b entry, REVUE and decisions pointer. No implementation.
55 KiB
V1-2.6 UX complement: navigation between annotations and findings
Status: PRINCIPLE APPROVED by the owner, 2026-11-06 (brief « Validation de principe U2b et préparation des
checkpoints », after the brief « Nouvelle exigence UX : navigation bidirectionnelle entre annotations et constats »):
sub-step U2b retained (F1); F2, F6, F8 and the zone preselection (F22) approved, F7 approved for the term
« Famille », F3 and F4 approved in part; then the brief « U1 / U2b — Derniers arbitrages avant implémentation »
decided F2 (leaves), F3, F4 (model A), F8 and F22 (BDR-104); the brief « V1-2.6 UX — Ratification finale U1 et
autorisation conditionnelle d'implémentation » (2026-11-06, BDR-105) ratified F5 and F9 to F21 as recommended and
settled the F3, F8 and F22 details, with precisions on F11 to F14 (section 7): every decision F1 to F22 is taken.
Design only: no application, Rust, SQL or worker change; nothing here authorises code, and U2b (after U2, before U3)
starts only on its own owner authorisation.
The U1 plan (.claude/tasks/plans/2026-11-06-v1-2-6-ux-u1.md, commit 2e46c14) is unchanged by this track.
Contracts: .claude/tasks/contracts/2026-11-06-v1-2-6-findings-nav-design.md (design),
.claude/tasks/contracts/2026-11-06-v1-2-6-findings-nav-decisions.md (decisions). Boards:
docs/design/v1-2-6-constats/ (17 to 22, after the 16 validated v1-2-6 boards), kept as the U2b design proposal;
section 7.4 shows them with the decisions of section 7.
Paths: core/ stands for crates/core/src/, app/ for apps/app/src/.
1. Audit of the existing relations (request C)
1.1 Links and who holds them
| Link | Held by | Cardinality | Core rule |
|---|---|---|---|
| annotation → view | view_id on every annotation (core/domain/sheet/schema.rs:421, :447) |
many to one | error annotation.view.missing (validate.rs:266-280) |
| detail view → parent view | parent_view_id (schema.rs:270-271) |
many to one | errors view.parent.missing, view.parent.cycle, view.unreachable (validate.rs:146-223) |
| detail trigger → view it opens | opens_view_id (schema.rs:460-461) |
many to one: a trigger opens exactly one view, a detail view is opened by 1 to N triggers | error annotation.opens_view.invalid (validate.rs:298-328, the target is a direct child of the trigger's view); view.unreachable asks for at least one trigger per detail view (validate.rs:200-223); no uniqueness rule; a trigger has no finding zone and no region by type (schema.rs:439-462) |
| annotation → annotation category | category_id (schema.rs:423, :449) |
many to one | error annotation.category.missing (validate.rs:282-296); the category has no link to findings |
| observable annotation → finding zone | finding_zone_id: Option (schema.rs:432-433) |
an annotation names 0 or 1 zone; a zone is named by 0 to N annotations | error annotation.finding_zone.missing when it dangles (validate.rs:330-346); warning annotation.no_findings when null (:367-386); warning finding_zone.unreferenced when no annotation names a zone (:437-457); no uniqueness rule, and docs/development/ANATOMICAL_SHEET_MODEL.md:102-103 says several annotations may share a zone |
| observable annotation → vertebral region | vertebral_region_code (schema.rs:434-435) |
many to one | error annotation.region.missing (validate.rs:348-365); a region has no link to findings, it opens the practitioner's vertebra picker (core/domain/editor/zone.rs:101-103) |
| finding zone → families → findings | categories (schema.rs:592), FindingCategory with kind (:568-583), recursive FindingNode (:538-556) |
tree, depth ≤ 8 (edit.rs:397-420) |
ids unique among siblings (finding.id.duplicate, validate.rs:410-435); a finding is addressed by (zone, path) (keys.rs:42-46) |
| family kind | FindingCategoryKind = dysfunction / consultation_reason / anamnesis / custom (schema.rs:558-566) |
on the category, never on nodes | no rule per zone (no « one of each ») |
| findings → references | reference_ids on categories and nodes (schema.rs:578-579, :550-551) |
many to many | error finding.reference.missing (validate.rs:466-499) |
| laterality | annotation only (unpaired / bilateral / left / right, schema.rs:393-402) |
none on zones or findings | the side exists only in reports, for bilateral annotations (zone.rs:104-112) |
There is no reverse link (zone → annotations) in the document, in the core index (core/domain/sheet/index.rs:25-33,
index_data.rs:19-45, preview.rs:330-342) or in the editor. The only core computation that returns the annotations
of a zone is sheet.dependents (edit.rs:894-977, relation links_zone), a free op over the whole document text,
used for delete confirmations. BDR-031 already rejected an annotation_finding_map array.
1.2 Equine draft data (supabase/seed/anatomical-sheets/equine/draft/document.json)
- 2 views (main, head detail), 28 annotations (22 points, 5 zones, 1 detail trigger), 27 finding zones, 811 families and findings (81 families, 730 findings, every zone with exactly one family of each of the three kinds, no custom family), depth 3, 48 references.
- Every finding zone is named by exactly one annotation; no observable annotation lacks a zone; zone ids equal
annotation ids; no left/right pair, no main + detail duplicate, no point + polygon on one zone. The duplicate cases
of the request do not exist in this sheet; they exist only in synthetic core fixtures (
crates/core/tests/oracles/r3/highlight.json, hip ×5;crates/core/tests/conformance/annotation-id-duplicate.json, atm ×2). - Labels repeat: 283 distinct French labels over 811 elements; the family name « Anamnèse / facteurs rapportés » is shared by all 27 zones, with three distinct subtrees (8 cranial zones, 9 spinal zones, 10 limb and pelvic zones), and « Restriction en flexion » appears 15 times. A search result without its zone would be ambiguous.
- Grasset: annotation
stifle(point, main view, bilateral) names zonestifle: 3 families, 29 findings (16, 7, 6), 3 with a veterinary referral flag, one reference cited.
1.3 What the editor and the core already offer
- Editor: one
selectedIdon the canvas (app/editor/annotations/uiState.ts:14-67), one marked annotation (useCanvasBuild.ts:70-83); « Zone de constats » select in the annotation properties (AnnotationFields.tsx:162-187) and at creation (CreationFields.tsx:141-161); the Constats tab as an ARIA tree overbuildItems(app/editor/findings/tree.ts:161-196), creation of zones, families and findings (FindingCreateForm.tsx); no search, no filter, no link between the two tabs; the Annotations tab cannot create a finding zone. - Read-only precedents: the catalogue's
ZonePanel(app/components/catalogue/ZonePanel.tsx:62-133) shows the findings of the selected annotation's zone by family; the report editor de-duplicates by zone and side (app/components/observation/ObservationCard.tsx:78-93) and marks several annotations at once (app/components/canvas/AnatomyCanvas.tsx:79-85). - Core: no search op, no reverse map; the composed canvas tags every annotation with
data-anno-zone(core/anatomy/layer.rs:176-208, contractdocs/ANNOTATION-RENDERING.md:50-66).
1.4 Conclusion of the audit
The request needs no new association: an annotation already names its finding zone, the findings belong to the zone,
and « the findings of an annotation » are the findings of that zone. « Gérer l'association anatomique » is the existing
finding_zone_id field. Duplicates are handled by grouping on the zone id: findings are listed and counted once per
zone, whatever the number of annotations naming it. No document structure change is proposed.
2. Design (boards 17 to 22)
| Board | Content |
|---|---|
| 17 | Annotations tab, an annotation selected: the side column gains a « Constats · n » segment beside « Propriétés »: the zone (with « Changer » and the other annotations that show it), the families of the zone in document order with their counts, « Ajouter un constat », « Ouvrir dans Constats » |
| 18 | From the selection: A, add a finding in the zone (family, parent, FR/EN names; « Ajouter » / « Abandonner »); B, edit a finding with the same fields and component as the Constats tab detail (C9) |
| 19 | Association: A, change the finding zone (searchable list, current zone first, « n annotations » per zone, the rule « no finding moves »); B, an annotation without zone (link to an existing zone, or create one for it); C, a detail trigger has no findings (segment disabled with its reason); D, a zone shown by two annotations (illustrative, absent from the equine draft) |
| 20 | Constats tab: instant search, result count over the total, « Filtrer sur le schéma », « Réinitialiser les filtres »; results shown in their tree (zone, family, ancestors in grey); each zone row links to the drawing (« Sur le schéma ») |
| 21 | « Filtrer sur le schéma »: non-modal right panel; views chosen as chips (one or more); click on points or zones to add or remove them; selection chips; the tree on the left updates at each click and combines with the text |
| 22 | States: no result (with the count outside the drawing filter and « Retirer le filtre du schéma »); keyboard list of the annotations with checkboxes; read-only (rights, frozen, historical); below 1 024 px, consultation with the list only |
Bidirectional path: drawing → « Ouvrir dans Constats » (focus request on the zone or finding key); Constats → « Sur le schéma » (focus request on the annotation key, Constats segment open). Filters are interface state: kept while the page lives (U1 keeps the Constats tab mounted), never written to the document, never saved, never arming the leave guard.
3. U1 integration points (work item 1)
No integration point has to be added to U1, and no amendment of the U1 plan is proposed. The seams the feature needs are already in the plan:
navigate(target)withzone,findingandannotationkeys (targetOfKey, U1 plan §1) gives both directions of the jump;PropertiesPanelreceivesnavigatefrom Lot B1 (its unmeasured-view link is retargeted there).- The Constats tab stays mounted (U1 plan §2), so search and drawing filters survive tab changes without any store.
usePlaceVisible()and the « one composed copy of a view » rule (U1 plan §2) cover the filter panel's drawing: it detaches while its place is hidden, and the Annotations drawing is hidden while Constats is shown.foldedexported in Lot C (case- and accent-insensitive match) serves the findings search.- The secondary panel slot of the references panel (U1 plan §5) is where the filter panel goes; the reducer gains a
second panel kind when this feature lands, a local change (owner precision 10: no global navigation rebuilt). Watch
item for the U2b executors: the filter panel is a variant, not a copy: no scrim and no
inerton the tab panels (under F5 (a): the tree stays live), unlike the references panel.
One watch item for the U1 executors, with no plan change: keep the Constats tab's selection, expansion and future
filter state local to the kept-mounted FindingsTab (as the plan already does), not in the navigation reducer.
Re-checked on 2026-11-06 against the plan at 2e46c14 (owner: « Ne pas modifier le plan U1 si les points
d'intégration déjà prévus suffisent réellement »), line numbers of the plan file:
- Jump to Constats:
targetOfKeysendszoneandfindingkeys to the findings tab (:93-95);go_tosets a focus request with a serial (:103-104), applied once byuseFocusRequest(:105-110). - Jump to the drawing: an
annotationkey goes to Annotations, sectiondrawing(:93-95). Opening the « Constats » segment on arrival is U2b's own handling of that request, not a U1 field. - Filters kept across tabs: every visited tab stays mounted in a
KeptPlace(:135-150). - Drawing inside the filter panel:
usePlaceVisible()detaches a hidden canvas (:150-153), so one composition of a view is live at a time. - Search fold:
foldedexported in Lot C (:439). - Second panel: the references panel's container and reducer actions (:102, :233-262).
What U2b adds to U1's code, in its own commits: under F5 (a), a second panel kind beside references in navigationReducer and
EditorTarget, and the segment choice carried by its focus handling. Both are additions that leave U1's behaviour
unchanged, so neither is a U1 amendment. Conclusion unchanged: no U1 integration point to add.
4. Placement (work item 2)
Retained by the owner on 2026-11-06 (F1): a dedicated sub-step U2b · Annotations et constats, after U2 and
before U3, with its own contract, tests and checkpoint, on its own owner authorisation (V1-2-6_UX_PLAN.md §3).
Not started.
- Why after U2: U2 rewrites the selection, pointer and keyboard model of the same canvas and the same
PropertiesPanel; the Constats segment sits in that panel and the drawing filter reuses the pointer rules (§2 G of the UX plan: a second pointer cancels, arrows pan only on the canvas box). - Why before U3-U6: none of them changes the zone link or the findings tree; U3 and U6 touch
AnnotationFields(colour, roles, region picker), not the zone field nor the Constats tab; U4 and U5 add views, which the view chips list by construction; U6's internalcat-accessand the detail triggers never carry findings, so they never appear as filter choices. - Alternative: after U6 (less rework risk in
AnnotationFields, later delivery). - Files:
app/components/editor/annotations/{PropertiesPanel,EditableAnnotations,ConstatsSegment (new), ZoneLink (new)}.tsx,app/components/editor/tabs/FindingsTab.tsx,app/components/editor/findings/{FindingTree, FindingDetail,FindingContent,FindingCreateForm,FindingsSearch (new),SchemaFilterPanel (new)}.tsx,app/editor/findings/{tree,filter (new)}.ts,app/editor/annotations/zoneIndex.ts(new), the canvas marking state,docs/ANNOTATION-RENDERING.md(new page state for filter marks, updated first), i18n. - Rust ops: none. Wasm budget: unchanged (margin 7 857 B kept for U2, U5, U6, LRN-118).
- Boundary (BDR-043, EVAL-034): the zone → annotations map is a group-by on a field the document already holds, and
the search filters what the page displays; neither decides validity, accepts a change or computes a rule. Same kind
of read as
citationCounts(U1) and the catalogue's sheet-name search (filterCatalog, BDR-095). Every change made from the new surfaces goes through the existingsheet.editcommands (finding insert and update, annotation update), so the core keeps the last word. A core op would be justified only if a measure on a large sheet showed the page-side derivation over the 500 ms budget. - Acceptance (proposal): boards 17-22 built; A and B work with mouse, touch from 1 024 px and keyboard; every finding change undoable as one entry; filters never change the document; read-only modes show no edit control; axe clean.
- Owner demo: select the grasset, read its 25 findings (leaves, F2), add one, undo it; search « restriction »; filter on grasset and jarret; reset; jump both ways.
- Rollback: revert of the sub-step's commits (no data, no schema).
5. Technical risks (work item 4)
| Risk | Probability | Mitigation |
|---|---|---|
| Editing findings from annotation A changes them for every annotation naming the zone | medium | the segment names the zone and lists the other annotations (board 17, 19 D); edits go to the zone, never copied |
Changing an annotation's zone changes what practitioners are offered and turns the annotation to_confirm (edit.rs:495-509) |
medium | the change goes through the existing field and its review rule; old reports keep their zone id and path (core/domain/report/rebase.rs:148-157, BDR-010) |
| Search results ambiguous (repeated labels across 27 zones) | high | results always shown under their zone and family; the count names zones too |
| Count unit undefined (zones, families, findings, leaves) | high | F2 decided: leaves only, each zone once, identity never by label (section 7.1) |
| Multi-annotation marking needs a new page state on the composed canvas | medium | page-side restyle only (BDR-053), ANNOTATION-RENDERING.md updated before the code |
| A third composition of a view in the page (filter panel) | medium | U1's detach-while-hidden rule; one visible composition per view at a time |
| Kept-mounted Constats tab recomputing filters on each commit | low | memoised on the parsed document and the filter state; measured with the U1 commit-to-paint check (500 ms budget) |
| Duplicates never exercised by the equine data | high | unit and e2e fixtures with two annotations on one zone (main + detail, left + right), modelled on the core's synthetic fixtures |
| Terminology: « zone » is an annotation kind and a finding zone; « catégorie » is an annotation category and a family | high | « Famille » approved (F7), « Zone de constats » proposed, kept apart from « Zone » (shape) and « Catégorie » (colour category) |
| Creating a zone from an annotation is two changes (zone, link) | medium | one batch commit, all or nothing, one undo entry (decision F8) |
| Rework if U2, U3 or U6 change the panel structure afterwards | medium | placement after U2 (section 4) |
| Laterality: a left and a right annotation on one zone show the same findings | low | expected (findings carry no side; the report adds it); stated in the segment's help |
| Wasm budget | low | no core op (section 4) |
6. Tests (work item 4)
- Unit: zone index (zone → annotations, annotation → zone, triggers and null zones excluded); findings filter (text in FR and EN, accents and case, zone names, ancestors kept, counts per unit, combination with the drawing filter, empty result, reset); de-duplication with two annotations on one zone (main + detail, left + right); the Constats segment (families in order, counts, add and edit through the existing commands, one undo entry each, change of zone, null zone, detail trigger disabled with its reason, read-only in every read-only mode); « Ouvrir dans Constats » and « Sur le schéma » focus requests (found, kept, none); filters absent from the document text and from the leave guard; filter state kept across tab changes and pruned when an undo removes a filtered zone or annotation; the rules of sections 7.2 and 7.3 as decided (words in any order, ancestor names, both languages, views with and without picks, a view deselected with picks on it, annotations without zone), the F3 equivalences and the F16 trigger rule (decisions of the ratification brief, below).
- Unit, decisions of 2026-11-06 (BDR-104): F2, counts on leaves only (grasset 25: 13, 6, 6; whole draft 627), a group never counted, a zone named by two annotations (main + detail, left + right) counted once, two findings with the same label in two zones counted twice; F3, every word matched in any order across zone, family, group and leaf names, French and English (« restriction flexion » 23 leaves in 16 zones, « grasset flexion » 1, « anamnèse » 162, « restriction » 140 in 26 zones on the equine draft), accents and case ignored; F4 model A, views alone restrict to their zones (head view with « restriction »: 48 leaves in 8 zones under the decided F2 and F3 rules; grasset, jarret and vertèbres lombaires ticked, with « restriction »: 17), the first tick switches to the picked zones, union without duplicate, text AND drawing, a view deselected drops its picks; F8, an annotation without zone offers « link an existing zone » and « create », nothing created without an explicit action, a typed name equal (folded) to an existing zone's name names it and proposes to link it, creating a distinct zone with that name needs an explicit confirmation (cancelling it creates nothing), creation is one undo entry and removes nothing, no merge on equal labels, two zones with the same name accepted; F22, the add form opened from an annotation starts on its zone, shown preselected; the zone changes only through « Changer la zone associée »; another zone chosen places only the new finding, the annotation's link and the existing findings unchanged; « Changer » (F19) moves no finding.
- Unit, decisions of the ratification brief (BDR-105): F3,
foldedmaps œ → oe, æ → ae, ’ → ' before the accent and case folding, so « oedeme » finds « Œdème » and « l'articulation » finds « l’articulation », and the catalogue search gains the same equivalences (its test updated, nothing lost); a row matched only in the other language shows its interface-language name and the matched name; F5, the filter panel opens without scrim and withoutinert, the tree stays operable, Escape and ✕ close it with focus back to « Filtrer sur le schéma », opening « Références » closes it and keeps the filter chip; F9, the side column renders the sharedFindingDetail(no copy), one commit per field on blur; F10, filters kept across tab changes, cleared by « Réinitialiser les filtres » and by a reload; F11, « Sur le schéma » on a zone with two annotations selects the first in document order and offers the other at once, choosing it moves the selection; F12, the picked mark sets the outline and check-disc state (no colour-only change) and the chip names the zone; F13, opening the filter panel hides the detail without unmounting it: typed text in its field survives a close, a focused field is committed first (one undo entry); F14, the keyboard list groups by annotation category with the category name as visible text and each checkbox labelled with annotation and zone; F15, choosing a zone another annotation shows displays the notice naming it before the change, cancelling changes nothing; F16, a detail trigger's « Constats » segment isaria-disabledwith its reason as description; F17, each chip ✕, « Effacer la sélection », « Retirer le filtre du schéma » and « Réinitialiser les filtres » clear exactly their part; F18, no result with the drawing filter shows the count without it and the offer to remove it; F19, picker order: current zone with « zone actuelle », then document order, annotation count per zone; F20, the other annotation of a picked zone dashed, its zone counted once (synthetic fixture); F21, the tree with folded branches, ancestors greyed and highlights, the compact list while the filter panel takes the width. - E2E, same decisions: grasset segment shows « Constats · 25 »; search « restriction flexion »; filter head view only, then tick one zone; annotation without zone (synthetic fixture): link, then create with an existing name (reuse offered, then the confirmation), undo each; add a finding from the grasset with its preselected zone, then once more after « Changer la zone associée »; a zone with two annotations (synthetic fixture): « Sur le schéma » then the other annotation offered on arrival; filter panel open with the tree still operable and the detail hidden then back with its state.
- E2E (sandbox): grasset journey (select, read, add, undo, edit, change zone and back); search with count; drawing filter with mouse and touch at 1 024 and 1 180 px; keyboard-only filter through the list; reset; both jumps; narrow read-only at 375 px (search and list filter, no edit control); no horizontal scroll at 1 024, 1 180, 1 280, 375 px.
- Accessibility: axe on the segment, the search, the filter panel open, the narrow mode; count in a polite live region
after a typing pause; checkboxes named with annotation and zone; focus after each jump on its target, never
body. - Regression: C9 (findings detail), C13 (recovery), C14 (history bound), C16 (narrow read-only), the U1 suites; the
core suites unchanged (no core change);
pnpm r5:import-equine --checkunchanged.
7. Decisions F1 to F22 (owner)
Owner brief « Validation de principe U2b et préparation des checkpoints » (2026-11-06): principle of the
bidirectional navigation approved; F1, F2, F6 and F8 approved, F7 approved for the term « Famille », F3 and F4
approved in part; the zone preselection added as F22. Owner brief « U1 / U2b — Derniers arbitrages avant
implémentation » (2026-11-06, BDR-104): F2 (leaves), F3 (fields), F4 (model A), F8 and F22 decided. Owner brief
« V1-2.6 UX — Ratification finale U1 et autorisation conditionnelle d'implémentation » (2026-11-06, BDR-105, below
« the ratification brief »): F5 and F9 to F21 approved as recommended (a), the F3, F8 and F22 details decided, F11 to
F14 with precisions. An owner brief sent earlier the same day and interrupted before any work (below « the
interrupted brief ») worded F3, F8, F11 to F14 and F22 a little differently; both wordings are quoted where they
differ, the ratification brief prevails. Owner sentences are quoted verbatim. The « Question » column keeps the study's wording of commit
567da67; a recommendation changed since that commit says « changed 2026-11-06 ». Counts come from the equine draft
document.json (a finding = a finding node at any depth; a leaf = a node without children).
| Id | Question | Boards | Alternatives | Recommendation | Technical consequences | State |
|---|---|---|---|---|---|---|
| F1 | Sub-step | 17-22 | (a) dedicated U2b after U2, before U3; (b) after U6: less rework in AnnotationFields, later delivery; (c) inside U2: one larger sub-step mixing gestures and findings |
(a) | Own contract, tests (section 6) and owner checkpoint; depends on U1 (navigation, kept-mounted Constats tab, folded) and U2 (selection, pointer and keyboard model of the canvas and of PropertiesPanel); no Rust op, wasm budget unchanged; U3 to U6 unaffected (section 4); listed in V1-2-6_UX_PLAN.md §3 |
approved: « F1 : placement U2b approuvé. » and « Retenir une sous-étape U2b « Annotations et constats », après U2 et avant U3, avec son propre contrat, ses tests et son checkpoint. » Implementation not authorised |
| F2 | What the counters count | 17, 20, 21, 22 | (a) every finding node at any depth, groups included (boards: grasset 29, « restriction » 108 of 730); (b) leaves only, the findings a practitioner can tick (grasset 25, 81 of 627); (c) families or zones | (b), decided 2026-11-06 (was (a) in commit 567da67) |
One counting function over buildItems for the segment, the search count, the filter count and, under F18 (a), the no-result count; a finding counts when it is a leaf (no children, the picker's test, app/components/observation/FindingsTreePicker.tsx:35); identity is the zone id and the node path, never the label, so a zone shown by several annotations counts once and two findings with the same label count twice (F8); the boards show (a) and stay as they are until U2b |
approved: « F2 — Compter uniquement les feuilles sélectionnables de l'arbre des constats, sans les groupes intermédiaires. Les doublons dus à plusieurs annotations d'une même zone doivent être éliminés. » (second brief, completing « F2 : les compteurs portent sur les constats réels à toute profondeur, sans compter les conteneurs de familles et sans doublonner les constats associés à une même zone par plusieurs annotations. ») |
| F3 | Search scope | 20 | Per field, language and word rule: section 7.2 | changed 2026-11-06: names of zones, families and findings at every level, French and English; a name match on a zone, family or group keeps everything under it; every typed word must match, in any order; descriptions, references, ids, annotation names, kind labels, status and flags not searched (7.2). Was: finding names in French and English, a zone name match showing all its findings, descriptions and references not searched | A page filter over buildItems and folded (no core op; same boundary as filterCatalog, BDR-043, BDR-095), memoised on the parsed document and the query; folded gains œ → oe, æ → ae and ’ → ' (7.2) at U2b, shared with the catalogue search (U1 Lot C only exports it); a row matched only in the other language shows its interface-language name and, beside it, the matched name |
approved: « F3 — Recherche en français et en anglais, sur les noms des zones, familles, groupes et feuilles. Recherche insensible aux accents et à la casse. Tous les mots doivent correspondre, dans n'importe quel ordre, y compris lorsqu'ils apparaissent à différents niveaux de l'arbre. » (first brief: « F3 : recherche instantanée, insensible aux accents et à la casse. »). Details decided (ratification brief): « F3 : recherche normalisée entre catalogue et constats, avec équivalence œ/oe, æ/ae et apostrophes droites/typographiques. Une correspondance trouvée uniquement dans l'autre langue doit afficher aussi le libellé correspondant. » (interrupted brief: « F3 : harmoniser la recherche avec le catalogue. Équivalence œ/oe, æ/ae, apostrophes droites/typographiques, accents et casse. Si une correspondance n'existe que dans l'autre langue, afficher également le libellé correspondant. ») |
| F4 | Drawing filter semantics | 21, 22 | Model A (facets, board 21) or model B (picks only): section 7.3 | changed 2026-11-06: model A with the rules of 7.3, decided (was: views give all their zones until a pick, text AND drawing, applied at each click) | Filter state = chosen views and picked annotation ids, held by the kept-mounted Constats tab; zone set derived at each render from the current document; text AND drawing; picked zones by union, each once; no core op | approved: « F4 — Valider le modèle A. Sans annotation cochée, les vues sélectionnées filtrent les zones représentées. Dès qu'une annotation est cochée, les zones explicitement sélectionnées déterminent le filtre anatomique. Combiner ce filtre avec la recherche textuelle par intersection. » (first brief: « F4 : filtres texte et anatomiques combinés par intersection ; plusieurs zones anatomiques sélectionnées produisent une union sans doublon. »). Rules of 7.3 that name F10, F16, F17 or F20 follow those decisions once taken |
| F5 | Filter panel | 21 | (a) non-modal right panel without scrim, the tree live (board 21); (b) modal dialog over the tab (ModalDialog, D13), the tree hidden while choosing; (c) a section above the tree, no panel (small drawing, long scroll) |
(a) | A second panel kind beside references in U1's navigation reducer (an addition, section 3); unlike the references panel, no scrim and no inert on the tab panels; one secondary panel at a time; Escape and ✕ close it, focus back to « Filtrer sur le schéma »; opening « Références » closes it and the filter stays active as a chip (unchanged since 567da67); one live composition of a view at a time (U1 plan §2) |
approved (ratification brief): « F5 : volet de filtre non modal à droite, sans bloquer l'arbre. » |
| F6 | Below 1 024 px | 22 | (a) consultation: search and filter, zones chosen in a list with 44 px targets, no selection on the drawing; (b) search only, no drawing filter; (c) picks on the drawing by touch as well | (a) | The same filter state with the list renderer only; O14 A unchanged; e2e at 375 px; no edit control | approved: « F6 : sous 1 024 px, consultation et filtres par liste, aucune édition graphique. » |
| F7 | Labels | 17, 18, 19, 20 | For a finding category: (a) « Famille »; (b) « Catégorie de constats », today's label; (c) « Groupe », which clashes with the intermediate groups | a detail trigger keeps the core's display name (its own, else the name of the view it opens, core/domain/sheet/index_data.rs:39, core/domain/sheet/index.rs:167-179), « Constats » for the segment, « Zone de constats » for the link, « Famille » for a finding category, « Filtrer sur le schéma », « Réinitialiser les filtres » |
U2b renames the Constats tab's « Catégorie de constats », « Ajouter une catégorie », « Nouvelle catégorie dans la zone « {zone} » », « Type de catégorie », the required-fields message « … le type d'une catégorie » and « Créez d'abord une zone pour ajouter une catégorie. » (app/i18n/fr.ts:1475, :1478, :1481, :1483, :1488-1489, :1491-1492) and their English pairs, and checks the Vérification label « catégories et nœuds de constats » (:1609); unit and e2e selectors on these texts follow; « Catégorie » stays for annotation categories (colour) |
approved for the term « Famille »: « F7 : « Famille » désigne les familles de constats, distinctes des catégories anatomiques. » The other labels of the row stay proposals for the label review (C44) |
| F8 | Creating a zone from an annotation without one | 19 | (a) allowed from the segment: one batch creating the zone named after the annotation (editable) and the link, one undo entry; (b) link to an existing zone only, creation stays in the Constats tab; (c) two steps, two undo entries | changed 2026-11-06: (a), with an explicit choice between an existing zone and a creation, decided (was: (a) alone) | The segment of an annotation without zone offers two explicit actions: link an existing zone (the F19 picker) or create one (board 19 B); nothing is created on its own. Creation goes through commitBatch (app/editor/state/editorEdit.ts:40-62, already used by app/editor/repair.ts:307): the core applies the zone insert and the link on a scratch text and the store keeps the end text only when the core accepts it, one history entry, nothing kept on refusal, nothing removed; no core op. The core refuses a duplicate id at insertion (core/domain/sheet/edit.rs:309-310, :370; issue code finding_zone.id.duplicate, validate.rs:405), not a duplicate name: when the typed name folds to an existing zone's name, the form names that zone and offers to link it; the form proposes to reuse that zone, and creating a distinct zone with the same name needs an explicit confirmation (decided, ratification brief); no uniqueness rule on names. No zone or finding is ever merged with another because their labels are equal. Linking a zone another annotation already shows goes through F15's notice (F15 (a), approved); the annotation turns to_confirm as on any change (core/domain/sheet/edit.rs:495-509) |
approved: « F8 — Ne jamais créer automatiquement une zone de constats redondante. Une annotation sans zone doit permettre une association explicite à une zone existante ou une création validée. L'opération doit être cohérente, annulable et non destructive. Ne pas fusionner deux constats distincts sur la seule égalité de leurs libellés. » (second brief; first brief: « F8 : l'association d'une annotation dépourvue de zone passe par une opération logique atomique, validée et annulable, sans doublon silencieux. »). Precision (ratification brief): « F8 : lorsqu'une zone de même nom existe, proposer sa réutilisation. Autoriser une nouvelle zone distincte après confirmation explicite, sans imposer une unicité basée sur le nom. » (interrupted brief: « F8 : proposer la réutilisation d'une zone dont le nom correspond, sans imposer une unicité par libellé. La création volontaire d'une autre zone portant le même nom exige une confirmation. ») |
| F9 | Editing a finding from the drawing | 18 | (a) in the side column, with the shared detail component (board 18 B); (b) always in the Constats tab, through « Ouvrir dans Constats »; (c) names only, inline in the segment | (a) | FindingDetail and FindingContent reused, not copied (C9); one commit per field on blur (BDR-050); width measured at 1 024 px before any CSS (LRN-094); its references button opens the U1 panel |
approved (ratification brief): « F9 : édition d'un constat depuis le dessin dans la colonne latérale, en réutilisant le composant de détail. » |
| F10 | Filter lifetime | 20 | (a) while the page lives, tab changes included; cleared by « Réinitialiser les filtres » and on reload; (b) also kept per sheet in session storage across reloads; (c) cleared at each tab change | (a) | State local to the kept-mounted FindingsTab (U1 plan §2), never in the navigation reducer, the document, the recovery copy or the leave guard; pruned at render from the current document |
approved (ratification brief): « F10 : filtres conservés pendant la vie de la page, effacés au rechargement ou par réinitialisation. » |
| F11 | « Sur le schéma » from a zone named by several annotations | 19, 20 | (a) the first in document order, the others listed in the segment; (b) a chooser before the jump; (c) all of them selected, which U2's single selection does not allow | (a) | navigate with the annotation key (U1 plan §1); a zone index (zone → annotations in document order) gives the first; the canvas switches to that annotation's view. On arrival the other annotations of the zone are offered at once (one button each, document order, named with its view), with no second action to reveal them; where they sit (segment or properties panel) is left to the U2b contract |
approved (ratification brief): « F11 : première annotation dans l'ordre du document, autres annotations immédiatement proposées. » (interrupted brief: « F11 : si plusieurs annotations représentent une même zone de constats, ouvrir la première dans l'ordre documentaire, mais proposer immédiatement de choisir une autre annotation. ») |
| F12 | Multi-annotation marking in the filter panel | 21 | (a) accent outline and check disc (board 21); (b) a change of fill colour; (c) no mark on the drawing, chips only | (a) | A new page state written in docs/ANNOTATION-RENDERING.md before any code; page-side restyle (BDR-053), no core change; stroke contrast measured by hand (axe does not check SVG strokes). The mark never relies on colour alone: the outline width and the check disc are shapes, the picked zones are also named in the filter chips and checked in the keyboard list (F14) |
approved (ratification brief): « F12 : contour d'accent et pastille cochée, avec identification accessible. » (interrupted brief: « F12 et F14 : préserver une identification accessible sans dépendre uniquement de la couleur. ») |
| F13 | Finding detail while the filter panel is open | 21 | (a) hidden, the tree takes the width; (b) kept, the panel narrower; (c) the panel over the detail | (a) | Layout derived from the panel state; the selection is kept and the detail comes back when the panel closes. The detail is hidden under U1's kept-mounted rule (hidden, never unmounted), so its state and any typed text stay; a field focused when the panel opens is committed first by U1's commitFocusedField() (one undo entry, nothing discarded) |
approved (ratification brief): « F13 : détail masqué pendant le filtrage, sans perdre son état. » (interrupted brief: « F13 : masquer le détail pendant le filtrage sans effacer les modifications en cours. ») |
| F14 | Grouping of the keyboard list of annotations | 22 | (a) by annotation category (colour), with a caption; (b) by view; (c) one flat alphabetical list | (a); a finding family cannot group annotations, since each family belongs to one zone | Native checkboxes on the same state as the drawing, each with a visible label naming the annotation and its zone; each group headed by the category name as text, the swatch never the only cue | approved (ratification brief): « F14 : liste clavier regroupée par catégorie anatomique, avec nom visible. » (interrupted brief: « F12 et F14 : préserver une identification accessible sans dépendre uniquement de la couleur. ») |
| F15 | Choosing a zone already shown by another annotation | 19 | (a) allowed, with a notice naming the other annotation before the change; (b) allowed silently; (c) refused | (a) | The page reads the zone index; the core accepts several annotations per zone (no uniqueness rule, docs/development/ANATOMICAL_SHEET_MODEL.md:102-103); (c) would be a new model rule, a document change that request C rules out without a demonstrated need |
approved (ratification brief): « F15 : association de plusieurs annotations à une zone autorisée, avec avertissement. » |
| F16 | « Constats » segment of a detail trigger | 19 | (a) shown disabled with its reason; (b) hidden | (a) | aria-disabled with the reason as its description; the same panel layout for every annotation |
approved (ratification brief): « F16 : segment Constats indisponible affiché désactivé et expliqué. » |
| F17 | Partial clears beside the general reset | 21, 22 | (a) « Effacer la sélection », « Retirer le filtre du schéma », a ✕ on each filter chip and « Réinitialiser les filtres »; (b) the general reset only; (c) the chips only | (a) | Four actions on one state (7.3, rule 10), one test each | approved (ratification brief): « F17 : effacement individuel, effacement de sélection et réinitialisation générale. » |
| F18 | No-result state | 22 | (a) the count outside the drawing filter and an offer to remove it (board 22 A); (b) « Aucun résultat » only | (a) | A second pass of the same filter without its drawing part | approved (ratification brief): « F18 : état sans résultat indiquant les résultats hors filtre anatomique. » |
| F19 | Zone picker of « Changer » | 19 | (a) current zone first with « zone actuelle », then document order, with the number of annotations per zone; (b) alphabetical; (c) search only | (a) | List built from the zone index, searchable with the F3 fold | approved (ratification brief): « F19 : zone actuelle en premier, puis ordre documentaire et nombre d'annotations. » |
| F20 | Other annotation of a picked zone in the filter | 19, 21 | (a) dashed outline, the zone counted once (board 19 D); (b) the same mark as the picked one; (c) no mark | (a) | A third marking state in docs/ANNOTATION-RENDERING.md; never exercised by the equine draft, so synthetic fixtures (section 6) |
approved (ratification brief): « F20 : annotations liées indiquées en pointillé, constats comptés une seule fois. » |
| F21 | How search results are shown | 20, 21 | (a) the tree with branches folded, ancestors in grey, highlights, a count and « Sur le schéma » per zone, and a compact list per zone while the filter panel takes the width (boards 20, 21); (b) the tree always; (c) a flat list always | (a) | Two renderers of one result set; the tree keeps its WAI-ARIA tree keyboard model; the compact list is a plain list of links | approved (ratification brief): « F21 : arbre filtré, liste compacte lorsque l'espace manque. » |
| F22 | Zone of a finding added from a selected annotation (owner, 2026-11-06) | 18 | (a) the annotation's zone, with no zone field in the form (board 18 A); (b) the zone preselected in a field the user may change | (b) with the explicit action « Changer la zone associée », decided (ratification brief; was (a), then (b) as this study's reading of « par défaut ») | FindingCreateForm opened from the segment shows the annotation's zone preselected, with the family list of that zone; the zone changes only through the explicit action « Changer la zone associée », which opens the zone choice; choosing another zone places only the new finding there, says that it will not appear under this annotation, and changes neither the annotation's link nor any existing finding; the annotation's own link changes only through « Changer » (F19), which moves no finding (board 19 A); the Constats tab's form unchanged |
approved: « F22 — Lorsqu'on ajoute un constat depuis une annotation, utiliser sa zone existante comme rattachement par défaut. Toute modification de l'association anatomique passe par une action explicite, sans déplacement silencieux des constats existants. » (second brief; first brief: « Lorsqu'une annotation est sélectionnée et que l'utilisateur ajoute un constat, préselectionner sa zone de rattachement. Ne pas imposer une seconde sélection inutile. »). Precision (ratification brief): « F22 : la zone de l'annotation est préselectionnée, mais l'utilisateur peut la modifier via « Changer la zone associée ». Aucun déplacement silencieux des constats. » (interrupted brief: « F22 : la zone de l'annotation est présélectionnée, mais modifiable par une action explicite « Changer la zone associée ». Aucun changement silencieux des associations existantes. ») Reading flagged: « Changer la zone associée » is read as the add form's action on the new finding's zone; the annotation's own link keeps « Changer » (F19), which moves no finding either; the U2b contract fixes both labels (C44) |
7.1 F2: the groups between a family and its findings
Decided 2026-11-06: (b), leaves only. Kept below as the record of the choice.
The draft holds 730 finding nodes: 627 leaves and 103 groups, a group being a node with children (« Restrictions de
sutures » over five sutures, for example). A practitioner ticks leaves only: the picker draws a checkbox for a leaf
and opens a group (app/components/observation/FindingsTreePicker.tsx:35, :195-203, :239-246), and the report records the
node clicked (core/domain/editor/finding.rs:50-63). The boards count groups (note of board 17: « les groupes oui »).
| Count | (a) every node | (b) leaves only |
|---|---|---|
| whole draft | 730 | 627 |
| grasset, board 17 (dysfunctions, consultation, anamnesis) | 29 (16, 7, 6) | 25 (13, 6, 6) |
| « restriction », boards' rule (board 20) | 108 in 26 zones | 81 in 26 zones |
| « restriction », rule recommended in 7.2 | 167 in 26 zones | 140 in 26 zones |
| grasset, jarret and vertèbres lombaires with « restriction », boards' rule (board 21) | 15 | 12 |
| « abduction » in grasset and jarret, then outside (board 22 A) | 0, then 2 | 0, then 2 |
Recommendation (changed 2026-11-06): (b). « Constats réels » reads as what a practitioner can record, and a group is a container like a family. Alternative (a) keeps the boards' figures. Either way families are not counted and a zone shown by several annotations counts once, as approved. The boards stay as they are (owner, request 5); their figures follow (a) and change at U2b if (b) is chosen.
7.2 F3: the fields searched
Decided 2026-11-06: the recommended fields (names of zones, families, groups and leaves, French and English), the word rule and accent and case folding. Decided by the ratification brief (2026-11-06, BDR-105): the œ/oe, æ/ae and ’/' equivalences, in one normalisation shared by the catalogue search and the findings search, and a row matched only in the other language shows the corresponding name as well. The space rule of the first bullet below stays this study's recommendation, for the U2b contract.
Approved: instant search (each keystroke, no minimum length, a blank query is no text filter), accents and case
ignored. The boards compute their figures on French finding names only
(docs/design/v1-2-6-constats/maquettes.html:253-258), although the note of board 20 says French and English; on the
draft both give the same figures for « restriction » and « abduction ». Fields, with the effect on the draft in
leaves:
| Field | Source | Recommended | Alternative | Effect on the equine draft |
|---|---|---|---|---|
| Finding name, French | FindingNode.name.fr (core/domain/sheet/schema.rs:545) |
searched | none | « restriction »: 81 |
| Finding name, English | FindingNode.name.en |
searched | the interface language only | « stifle »: 0 with French only, 1 with English |
| Group name (a node with children), French and English | the same field on a parent node | searched; a match keeps all its descendants | a match keeps the group alone, as the boards do | « restriction »: the 27 « Restrictions… » groups (mobility, fixations, sutures) bring their children, 81 → 140 |
| Family name, French and English | FindingCategory.name (schema.rs:575) |
searched; a match keeps the family's findings | not searched | « anamnèse »: 0 → 162 in 27 zones |
| Zone name, French and English | FindingZone.name (schema.rs:591) |
searched; a match keeps the zone's findings | not searched | « grasset »: 1 → 26 in 2 zones |
| Descriptions, French and English (82 nodes, 28 families) | description (schema.rs:547, :577) |
not searched | searched | « douleur »: 5 → 16; « flexion »: 30 → 40 |
| References (citation, DOI, URL) | reference_ids, then the references |
not searched | searched | 81 finding nodes and 2 families cite references; the references panel has its own search (U1 plan §5) |
| Stable ids | id |
not searched | searched | « stifle » by id reaches 25 leaves in 1 zone, which the English zone name « Stifle joint » already reaches |
| Annotation names | name of an observable annotation (schema.rs:431) |
not searched | searched | 26 of the 27 draft zones carry exactly their annotation's name, the ssb zone extends it; the drawing filter covers annotations |
| Family kind label (« Dysfonction »…) | FindingCategoryKind and the i18n labels |
not searched | searched | the family names already carry these words |
| Review status, vet referral flag | review_status, requires_vet_referral |
not searched (not text) | a later filter | none |
Rules recommended with the list:
- Normalisation:
folded(app/catalogue/useCatalogue.ts:53: NFD, diacritics removed, lower case), plus œ → oe, æ → ae, ’ → ' and runs of spaces, non-breaking ones included, as one space. The draft holds no œ, æ or ’ today (291 straight apostrophes), but French authoring (« œdème ») and phone keyboards (’) bring them. Sharing the extension changes the catalogue search the same way (BDR-095), with nothing lost: decided (alternativefoldedunchanged, dropped). U1 Lot C only exportsfolded; the extension lands at U2b. - Words: the query is split on spaces and every word must appear in the finding's name or in one of its ancestors' names (group, family, zone), in either language, in any order. « restriction flexion » finds 23 leaves in 16 zones, « grasset flexion » 1. Alternative: the whole query as one substring, as the catalogue does, which finds 0 for both.
- Language: both languages whatever the interface language; a row matched only in the other language shows its interface-language name and, beside it, the matched name (decided). Alternative, dropped: the interface language only (an English name is then searchable only in English).
- Results under their zone and family, counted in the F2 unit, each zone once.
7.3 F4: the drawing filter, complete semantics
Decided 2026-11-06: model A. Rules 10, 6, 7 and 12 cite F17, F20, F16 and F10, approved as recommended by the ratification brief (BDR-105).
Approved: text and drawing combine by intersection; several zones picked give their union, each zone once. Decided with model A:
what the chosen views do. The state is interface state only (never in the document, the save, the recovery copy or
the leave guard): views, the views chosen in the panel, and picked, the annotation ids ticked on a drawing or in
the list. The zone set is derived from them at each render, from the current document.
Model A, recommended (facets; the note of board 21 describes it):
- Views without a pick: no view chosen, or all chosen, restricts nothing; some views chosen keep the zones named by an observable annotation of those views.
- Picks: from the first ticked annotation, the zone set is the zones of the ticked annotations, by union, each zone once. Ticking happens on the chosen views' drawings (on every view when none is chosen).
- Text: a finding shows when its zone is in the zone set and it matches the text; without text, every finding of the zone set shows. Applied at each click or keystroke, with no « Appliquer » button.
- Deselecting a view drops the picks made on it; its chip says beforehand how many it holds (« Tête · 2 choisies »).
- One chosen view is drawn at a time (one live composition, U1 plan §2); « Dessin affiché » switches it, and the picks on the other views stay.
- A zone shown by several annotations: ticking one puts the zone in the set once and draws the others dashed (F20); ticking another changes no result; unticking one keeps the zone while another ticked annotation names it.
- Detail triggers have no findings (F16): not tickable, and inert in the panel (views are chosen with their chips). Alternative: a click on a trigger shows its view.
- Annotations without a finding zone: not tickable, drawn faint, named « sans zone de constats » in the list and on hover.
- Zones named by no annotation (warning
finding_zone.unreferenced) belong to no view: a view restriction or a pick hides them; with neither they stay. The draft has none. - Clears (F17): « Effacer la sélection » empties the picks and keeps the views; « Retirer le filtre du schéma » and the chip's ✕ empty both; « Réinitialiser les filtres » empties text, picks and views.
- The keyboard list (board 22 B) and the narrow list below 1 024 px (F6) act on the same picks: one checkbox per observable annotation of the shown view.
- Document changes: an undo that removes a picked annotation, its zone link or a chosen view drops it silently and updates the chips (F10); a picked annotation whose zone changes moves the zone set with it.
- Read-only modes (rights, frozen, historical) and widths below 1 024 px keep the filter: it changes nothing in the sheet.
Model B, alternative (picks only): the views only choose which drawings the panel offers; nothing is restricted until an annotation is ticked; rules 2 to 13 unchanged. Simpler, and each tick only widens the set, but the findings of a whole view take one tick per annotation (18 on the draft's main view) or an extra « Tout cocher dans cette vue ».
Why A: it is the usual facet convention (nothing ticked means everything in scope), it gives the findings of one view in one click, and board 21 already shows it. Its cost is the jump at the first tick, from all the zones of the chosen views to a single zone, which the panel's help sentence states.
Examples on the draft with « restriction », boards' rule (leaves in brackets; under the decided F2 and F3 rules the same filters give 140 in 26 zones, 48 in 8 for the head view, 92 in 18 for the main view, 17 for the three ticked zones, and still 0 then 2 for « abduction »):
| Drawing filter | Model A | Model B |
|---|---|---|
| head view chosen, nothing ticked | 24 (16) in 8 of its 9 zones | 108 (81) in 26 zones, no restriction |
| main view chosen, nothing ticked | 84 (65) in 18 zones | 108 (81) in 26 zones |
| both views chosen, nothing ticked | 108 (81), no restriction | the same |
| grasset, jarret and vertèbres lombaires ticked | 15 (12) in 3 zones (board 21) | the same |
| grasset and jarret ticked, « abduction » instead | 0, and 2 outside the drawing filter (board 22 A) | the same |
7.4 Boards with their decisions
The six boards of docs/design/v1-2-6-constats/, unchanged, kept as the U2b design proposal (not graphically
validated). Each lists the decisions whose « Boards » column names it; any Markdown preview (the forge, an editor)
shows the images. Their figures follow the boards' rules (7.1, 7.2).
Board 17: F1, F2, F7.
Board 18: F1, F7, F9, F22.
Board 19: F1, F7, F8, F11, F15, F16, F19, F20.
Board 20: F1, F2, F3, F7, F10, F11, F21.
Board 21: F1, F2, F4, F5, F12, F13, F17, F20, F21.
Board 22: F1, F2, F4, F6, F14, F17, F18.
8. Out of scope
Findings attached to several zones, moving findings between zones, drag and drop in the tree, bulk import (all level 2, contract §8.3 and §16.12); practitioner-side search (V1-3 reports); the catalogue (BDR-095 keeps its search to sheet names); any core op, schema change or V1-2.7 control.





