docs(docs): R0 owner decisions, A1-A15 table, R3 SQL checkpoint proposal

This commit is contained in:
bchanot committed 2026-11-09 16:27:46 +01:00
1 parent 95009069ca
commit 84aba41b7d
5 files changed
+196 -32

No files matched your search

+30 -19
View File
@@ -69,7 +69,8 @@ reference of R1 to R4.
first (it has no explicit handler today).
- Unit tests: deselect leaves the document text and the history length unchanged; undo after a deselect undoes the
previous edit; the Escape matrix (dialog, menu, panel, tracing, nothing open) with one consumer each time; focus
after « Désélectionner » on the annotation's list row (arbitration A6); accessible names of both history buttons in FR and EN; read-only modes
after « Désélectionner »: the annotation's list row if it still exists, else the drawing, with no new selection
and a polite announcement (A6 as ratified); accessible names of both history buttons in FR and EN; read-only modes
show « Désélectionner » and no « Supprimer ».
- E2E: the journeys that name « Annuler » / « Rétablir » rewritten one for one; a new desktop spec for the button and
Escape; axe on Annotations with a selection.
@@ -98,7 +99,8 @@ reference of R1 to R4.
- Unit tests (about 15 files today assert the four-tab structure or the panel): five tabs and the « Plus » tier at
500 px; each sort, stable, document untouched (text compared before and after); reorder commands present only in
document order without search; clear button; tile disclosure and focus; « Aller à » from Vérification opens the
tab, the tile open and focused; « Aller à » from a tile reaches the finding; the panel from a finding: filtered,
tab, the tile open and focused; « Aller à » from a tile reaches the finding; the panel from a finding: filtered, « Retirer de ce constat » removes only that citation (the reference
stays in the document) and one undo restores it,
« Tout afficher » opens the tab with search and sort reset and focus on its heading, close returns focus to the
finding's button; unsaved edits in a tile form survive a tab change (kept-mounted places); no edit control in any
read-only mode or without the editor right; the reduced-motion class.
@@ -120,7 +122,9 @@ reference of R1 to R4.
the sandbox, 28 of 219 official sheets have a version newer than the sheet row. A true « dernière modification »
needs one read change in SQL (a `last_modified_at` field, greatest of the sheet's and its versions' `updated_at`,
in `private.official_sheet_admin_summary`; no table, policy or privilege change), hence an SQL checkpoint, pgTAP,
regenerated types, and its application to the sandbox, which needs the owner's go for that operation.
regenerated types, and its application to a stack, which needs the owner's go for that operation. Ratified (A7):
the dedicated checkpoint is `V1-2-6_R3_SQL_CHECKPOINT.md`; R3 ships in two steps, search and name sort with no date
first, the date, the date sort and the « most recent » card only once the SQL change is authorised and applied.
- Search and sort run in the browser on the full list: `shortcut:` until RR-13 pages the list on the server, where
search and sort move with it.
- Tests: unit for search (accents, both languages, empty, clear), sort (date ties by name, collation), date format
@@ -141,7 +145,7 @@ reference of R1 to R4.
## 4. Order and dependencies
R0 first (validation). R1 is independent of R2 and can ship first. R2 depends on the validated boards 23 to 27. R3
depends on arbitration A7; with the SQL option, its migration goes through its own checkpoint before the UI part.
ships search and name sort first; its date part waits for the SQL checkpoint (A7 ratified).
R4 is independent and may run any time after its board (30) is validated. Anomaly B (section 5) should land before
the gates of R2 and R3 are read, since its taken slot fails four admin specs on every run.
@@ -153,19 +157,26 @@ the gates of R2 and R3 are read, since its taken slot fails four admin specs on
| B. Working copy never archived | `packages/supabase/tests/sandbox/sheets-admin.sandbox.ts:181-195` creates the historical sheet's working copy (`8c315a12-…`, 2026-11-08 21:00:30) and never archives it; the single slot then disables « Créer une copie de travail » (`WorkingCopyAction.tsx:88`) and fails `admin.spec.ts:717` four times. | Make the suite independent (its own cleanup, or a precondition it creates and removes); the existing copy is not touched before the owner authorises it. |
| C. Silent card failure | Section 3, R4. | Show the failure, never hide or route around it. |
## 6. Arbitrations for the owner
## 6. Arbitrations
| # | Question | Recommendation |
|---|---|---|
| A1 | Reorder commands with a search active in document order | Hidden, as checkpoint choice 10 already rules (moving among a hidden subset is ambiguous); one hint line. |
| A2 | Tiles open at once; how long open state, search and sort last | Several open at once; kept while the editor stays open (kept-mounted tab), reset when it reopens. |
| A3 | Actions in the contextual panel | Modifier, « Aller à »; no add, no reorder. Every reference in the panel is cited by the finding, so « Supprimer » would always be refused by the core (no dangling reference): offer « Retirer de ce constat » (removes the id from the finding's citations, an ordinary undoable edit) instead, or nothing. « Tout afficher » opens the tab with search and sort reset, focus on its heading. |
| A4 | Closed tile content | Citation on two lines at most, type, « Citée par N constats » or « Non citée ». |
| A5 | Escape priority | Dialog, then open menu, then contextual panel, then tracing in progress, then selection. |
| A5b | « Toutes les annotations » (top of the properties panel) already clears the selection | Keep both: « Désélectionner » sits where the eye is after acting on an annotation, as decided (D6); the top entry keeps its role of returning to the list. Alternative: rename the top entry. |
| A6 | Focus after « Désélectionner » (the button leaves with the selection) | The annotation's row in the list, as « Toutes les annotations » already does (`PropertiesPanel.tsx:92-102`, `focusRow`). |
| A7 | Source of the last-modification date | SQL read change `last_modified_at` with its own checkpoint (recommended). Without it, label the row « Fiche modifiée le » and accept that draft saves do not move it. |
| A8 | Date format | Absolute, « 9 nov. 2026, 12:06 » (EN « 9 Nov 2026, 12:06 »). |
| A9 | Administration home card | The five most recently modified sheets with species, status and date, then « Voir les N fiches ». |
| A10 | Catalogue warning wording | FR « Contrôle d'intégrité échoué : cette version ne peut pas être affichée. », a distinct line for a load that failed for another reason. |
| A11 to A15 | Trial stack: names, ports, old trial commands, account roles, key lifetime, backups | `TRIAL_STACK.md` section 6. |
Status as of the brief « R0 — Décisions propriétaire et dernière validation graphique » (2026-11-09, BDR-108).
The owner-facing table with consequences, in French: `docs/design/v1-2-6-r0/ARBITRAGES.md`.
| # | Question | Recommendation | Status |
|---|---|---|---|
| A1 | Reorder commands with a search active in document order | Hidden, as checkpoint choice 10 already rules (moving among a hidden subset is ambiguous); one hint line. | open |
| A2 | Tiles open at once; how long open state, search and sort last | Several open at once; kept while the editor stays open (kept-mounted tab), reset when it reopens. | open |
| A3 | Actions in the contextual panel | « Modifier », « Retirer de ce constat », « Aller à »; no add, no reorder, no « Supprimer » (always refused by the core there). « Tout afficher » opens the tab with search and sort reset, focus on its heading. | RATIFIED: « Retirer de ce constat » removes only the finding's citation of the reference, never the reference; undoable through the editor history |
| A4 | Closed tile content | Citation on two lines at most, type, « Citée N fois » or « Non citée » (the count includes families). | open |
| A5 | Escape priority | Dialog, then open menu, then contextual panel, then tracing in progress, then selection. | open |
| A5b | « Toutes les annotations » already clears the selection | Keep both (D6). | open |
| A6 | Focus after « Désélectionner » | The annotation's row in the list. | RATIFIED with precision: the row if it still exists, else the drawing; focus never selects again; an accessible announcement |
| A7 | Source of the last-modification date | SQL read change `last_modified_at`, own checkpoint. | RATIFIED: dedicated SQL checkpoint `V1-2-6_R3_SQL_CHECKPOINT.md`; until then no creation date shown as a modification date and no misleading sort |
| A8 | Date format | Absolute, « 9 nov. 2026, 12:06 » (EN « 9 Nov 2026, 12:06 »). | open |
| A9 | Administration home card | The five most recently modified sheets with species, status and date, then « Voir les N fiches ». | open (needs A7 first) |
| A10 | Catalogue warning wording | FR « Contrôle d'intégrité échoué : cette version ne peut pas être affichée. », a distinct line with « Réessayer » for a load that failed for another reason. | R4 ACCEPTED as an independent display fix, the fingerprint check unchanged; wording open |
| A11 | Trial stack command | `pnpm db:trial`, prefix `faunosteo_trial_`, ports 58xxx and 5194. | RATIFIED: `pnpm db:trial`; prefix and ports open |
| A12 | Old `db:sandbox trial*` commands | Remove once the trial stack is validated. | DECIDED otherwise: kept for now, neither removed nor silently redirected |
| A13 | Trial accounts | `admin` with catalogue rights, `owner` if needed. | DECIDED: two accounts, an owner/admin account and a practitioner account with the editing rights (see `TRIAL_STACK.md` §3.5 on rule O1) |
| A14 | Key lifetime and secret renewal | One year, `rotate-keys`. | Renewal RATIFIED (`TRIAL_STACK.md` §3.3); lifetime open |
| A15 | Backup before every `migrate` | Automatic, kept, never pruned without the owner. | open (volumes preserved: ratified) |