docs(docs): close R2 after the owner trial, record U2 orientation

This commit is contained in:
bchanot committed 2026-11-14 15:18:06 +01:00
1 parent 791fc03a0d
commit 685a96741b
8 files changed
+246 -49

No files matched your search

+60
View File
@@ -499,6 +499,66 @@ Status: implemented on `feature/v1-2-anatomical-sheets` (lots A to H; Lot I, gat
- Risk: touch and keyboard conflicts (§2 G). Rollback: revert (the core value is additive and unused once reverted).
- Checkpoint: owner tries mouse and tablet.
#### Orientation 2026-11-14 (owner)
Source: owner brief of 2026-11-14, applying to annotations the principle R2 uses for findings and references.
Properties and forms live in modal dialogs; geometry stays a direct manipulation on the drawing. The gestures
validated for U2 stay binding: vertex drag, « + » on a segment, « − » on a vertex, zone move, redraw, a point's
properties. Status: orientation for the U2 design and plan. U2 is not started; its contract, boards and code wait for
the U2 planning and its owner gate. Where the objective above says `PropertiesPanel.tsx` or a side panel, this
orientation replaces it with a dialog.
What goes where:
| On the drawing (no dialog open) | In the properties dialog (ModalDialog, D13) |
|---|---|
| Selection, handles, vertex drag, « + », « − », zone move, redraw, point move | Names FR/EN, category, vertebral region, laterality, findings zone, review mark, delete |
| Point size: the slider with the red minimum mark, in the trace strip | Read mode first; « Modifier » turns it into a transactional form (one undoable operation per save, as R2) |
| Zoom, pan, view switch | « Modifier la forme » closes the dialog and hands over to the drawing with the shape selected |
The point size is geometry, not a property. It needs the drawing visible for its preview and its minimum mark, so it
stays in the fixed trace strip of board 04, beside the selection. A modal over the canvas would hide the preview it
controls.
Interaction rules:
1. A click or tap without movement on an annotation selects it, shows its handles and opens its properties dialog in
read mode. A press that moves beyond the pointer slop is a manipulation and never opens the dialog.
2. Closing the dialog (✕, Échap, « Annuler », Back) returns to the drawing with the selection, zoom and pan
unchanged; the focus returns to the annotation (R2F-2 return target).
3. Once a shape is selected, its handles are dragged directly, no dialog needed. A click without movement on the
selected shape reopens its properties.
4. « Modifier la forme » closes the dialog, keeps the selection and moves the focus to the first handle. Each gesture
stays one undoable operation (owner demo « undo each step »).
5. Touch: a tap is rule 1. The explicit « Déplacer la zone » mode lives in the trace strip, not in the dialog.
6. Keyboard: Entrée on a focused annotation opens its dialog. In geometry mode the §2 G keys apply unchanged (Tab
between handles, arrows to move, Insert and Delete for vertices).
Creation:
1. The user picks « Ajouter un point » or « Ajouter une zone ».
2. They place the point or trace the polygon on the drawing; the strip keeps « Terminer » and « Annuler », and
Backspace removes the last vertex.
3. On completion a « Nouveau point » or « Nouvelle zone » dialog asks for the properties, the traced shape staying
drawn under the backdrop as a ghost.
4. « Créer » writes geometry and properties as one undoable operation. « Abandonner » removes the ghost and asks first
when something was typed (R2 DiscardConfirm). « Reprendre le tracé » returns to the drawing with the shape kept.
5. Laterality: the core requires one (`schema.rs`) and the boards imply a default. The open C25 question (no
preselected laterality) is settled at the U2 gate.
History reuse (R2 parts used as they are: ModalDialog and Dialog, `useDirtyGuard`, `useFormDraft`, FormActions,
DiscardConfirm, the history adapter with its session tag, the leave guard): the properties dialog is a history layer
keyed by element, like the finding dialog (Back closes it, a dirty form asks first). Geometry mode and the trace are
not history entries: Échap ends them.
Mockups: boards 02 to 06 and 13 of `docs/design/v1-2-6/` show a properties side panel next to the drawing. They are
redrawn at the U2 planning: the panel becomes the dialog opened over the drawing, the trace strip gains the point-size
slider, « Déplacer la zone » and « Redessiner », the drawing keeps its full width. The owner validates the redrawn
boards before any U2 code (design-reference rule). Boards 14 and 16 (phone) are unchanged: below 1 024 px the editor
stays read-only (O14 A).
Risks to settle in the U2 plan: the slop threshold for touch versus mouse; a dialog opened by a tap at a canvas edge
on a tablet; focus return after « Modifier la forme »; the ghost's contrast under the backdrop; the handle cap (T18)
with a dialog open.
### U2b · Annotations et constats
- Retained by the owner on 2026-11-06 (brief « Validation de principe U2b et préparation des checkpoints », F1,