docs(docs): R3 phone filters, trial step 4.15, verifier gap closed

This commit is contained in:
bchanot committed 2026-11-16 20:33:15 +01:00
1 parent d3b8292aaf
commit c25a994c0e
6 files changed
+51 -5

No files matched your search

+2
View File
@@ -723,6 +723,8 @@ Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheet
- [ ] Follow-up: the R3 spec adds 2 accounts and 2 `sheet_editor` grants per run, feeding BLK-015's accumulation (RR-13)
- shortcut: `apps/app/src/admin/sheetList.ts` search and sort run in the browser on the whole loaded list. Limit: the whole list loaded in one unbounded read, then filtered and sorted in the browser at each keystroke. Upgrade path: they move to the server with the admin list paging, RR-13 (widened per D4)
- shortcut: the search field in `AdminSheetsRoute.tsx` repeats `ReferenceToolbar`'s search markup (R2, closed). Limit: two copies of one field. Upgrade path: fold both onto one shared search component when the editor is next opened
- [x] Owner trial 2026-11-16 db:trial: R3 behaviour validated; phone filters collapsible (`9efc7b7`, spec `6d2ba0d`, no new board), double announcement fixed (filters-only empty line no longer a status), contract criterion 4 oracle replaced by the layout-insensitive check (DATE_SOURCE_OK). Units at `6d2ba0d`: core-wasm 66, supabase 182, app 1749 in 137 files; spec admin-sheets-list alone 8 passed (4 tests x 2 projects). BLK-015 and admin.spec.ts failures unchanged, separate.
- shortcut: the phone filters panel in `AdminSheetsRoute.tsx` is local to the sheet list. Limit: one page; the other admin lists have no filters panel. Upgrade path: lift it to a shared disclosure component when a second list needs one
- [ ] Follow-up, NOT R3 (owner D5 2026-11-16): keep the admin sheet list's search, sort and filters when coming back from a sheet; joins the app-wide « search not kept on back » follow-up (BDR-079); BDR-116 rejected address parameters for view state; later navigation improvement, own go
- [x] Anomaly B FIXED `2cdee42` (owner 2026-11-12 « Décision sur l'anomalie E2E », option 1): dialog checks moved to e2e:ui on the real WorkingCopyAction (`e2e/harness/working-copy.*`, `e2e/ui/working-copy.spec.ts`), shell keeps the historical page + state-consistent button check, sandbox suite archives only its own copies (`returning id` checked). Before 4 failed; after 4 passed ×2; full admin.spec 16 passed / 8 skipped; e2e:ui 251 ×2; sandbox sheets-admin 5/5; pre-existing anatomical_sheets rows identical per id (637 → 643, 6 added by A1). Verifier CONFORME, security PASS (1 LOW: optional uuid check before interpolation). Open: cleanup creation branch not run on a fresh stack; free branch of the shell check not run on this sandbox; `editor-equine.spec.ts` set-aside still archives and restores pre-existing copies (8c315a12 included, updated_at 2026-11-12 13:40 from the R1 follow-up run): owner decision. R2.0 waits for the owner's green light on this result
- [ ] editor-equine risk (owner 2026-11-12 « Validation du correctif E2E et GO R2 » §3; separate fix, NOT part of R2): `editor-equine.spec.ts` beforeAll archives every active historical working copy (`update public.anatomical_sheets … private.is_historical_working_copy(id)`), afterAll restores them, and `confirmHistoricalDrawing` may upload / confirm the historical sheet's drawing; it already changed 8c315a12's `updated_at` (2026-11-12 13:40 UTC). NOT to be run on a persistent database holding data to preserve until fixed. Before any rerun: list its writes exactly, propose a reproducible non-destructive isolation of pre-existing resources, check interactions with admin.spec and parallel suites; keep 8c315a12 and its current metadata (no artificial date restore); no sandbox reset or deletion
@@ -153,6 +153,10 @@ Une fois M9 appliquée et vérifiée sur db:trial, tu peux poursuivre les tâche
À la fin, présente-moi le bilan et la procédure d'essai propriétaire de R3.
### Owner message 2026-11-16 (R3 trial feedback: collapsible filters on a phone)
« Retour de mon essai propriétaire R3 sur db:trial. Tous les tests fonctionnels sont satisfaisants. Je valide le comportement général de R3. J'ai seulement une dernière amélioration UX à demander pour le téléphone. [filtres repliables, comportement attendu: masqués par défaut sur téléphone; bouton « Filtres » ouvre/ferme; quatre filtres verticaux à l'ouverture; filtres immédiats; fermer ne réinitialise pas; « Filtres (2) » si actifs; réinitialisation facile; recherche et tri toujours accessibles; ouverture fluide, cohérente avec les autres panneaux, tactile; ordinateur inchangé; composant, breakpoint et détails au choix de Claude; pas de nouvelle maquette complète] Après cette correction, termine les vérifications et la clôture documentaire de R3. Pense également à solder l'écart du vérificateur automatique et à vérifier la remarque sur la double annonce aux lecteurs d'écran, sans rouvrir les décisions UX déjà validées. Conserve BLK-015 et les échecs connus des tests d'administration dans leur suivi séparé. »
## CLARIFICATIONS
- Graphic reference: boards 28 and 29 of `docs/design/v1-2-6-r0/` (R0, validated 2026-11-09). Board 30 belongs to R4.
- Labels: `docs/design/v1-2-6-r0/REVUE.md:82-84`. Date format (A8): « 9 nov. 2026, 12:06 » / « 9 Nov 2026, 12:06 », Paris time.
@@ -170,7 +174,7 @@ Une fois M9 appliquée et vérifiée sur db:trial, tu peux poursuivre les tâche
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --name-only $(git rev-parse 2277e41^)..HEAD -- supabase/migrations | tr '\n' ' '
EXPECT: supabase/migrations/20261116100000_sheet_admin_last_modified.sql only
4. Precision 3: the application never shows an old or wrong date as the last modification: the client refuses an answer without `last_modified_at` or with a value that is no timestamp (`unavailable`), the list and the card show `last_modified_at` only (never `updated_at` or `created_at` under « Modifiée le »), the `<time>` carries the same instant.
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && grep -q "last_modified_at: z.string().datetime({ offset: true })" packages/supabase/src/sheets.ts && ! grep -rn "ModifiedDate iso={[^}]*\(updated_at\|created_at\)" apps/app/src && echo DATE_SOURCE_OK
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && sed 's#//.*$##' packages/supabase/src/sheets.ts | tr -d ' \n' | grep -q "last_modified_at:z.string().datetime({offset:true}).refine((value)=>!Number.isNaN(Date.parse(value)))" && ! grep -rn "ModifiedDate iso={[^}]*\(updated_at\|created_at\)" apps/app/src && echo DATE_SOURCE_OK
EXPECT: DATE_SOURCE_OK
5. List page `/app/admin/sheets`: a search on the sheet name (French or English, accents and case ignored, instant), combined with the four existing status filters; a native « Trier par » with « Dernière modification » (default, newest first) and « Nom » (collation of the interface language); a count line « {n} fiches » / « {n} fiches sur {total} »; each row shows « Modifiée le {date} » in the ratified format, Paris time.
6. The search field: label « Rechercher une fiche par son nom », 100 characters at most, no magnifier; a clear control « Effacer la recherche » only while it holds text; Escape empties a non-empty field and does nothing on an empty one; clearing returns the focus to the field.
@@ -203,3 +207,7 @@ supabase/migrations/20261116100000_sheet_admin_last_modified.sql, supabase/tests
- Controller ruling (not a verifier verdict): the CHECK line is a defective oracle written by the controller before the security fix; it stays as written above. A layout-insensitive equivalent, run 2026-11-16 at bcdacbb, prints the expected marker:
`sed 's#//.*$##' packages/supabase/src/sheets.ts | tr -d ' \n' | grep -q "last_modified_at:z.string().datetime({offset:true}).refine((value)=>!Number.isNaN(Date.parse(value)))" && ! grep -rn "ModifiedDate iso={[^}]*\(updated_at\|created_at\)" apps/app/src && echo DATE_SOURCE_OK` → DATE_SOURCE_OK
The owner decides whether criterion 4 is closed on that basis.
## Verification closure 2026-11-16 (after the owner trial)
- Criterion 4: the CHECK line is now the layout-insensitive equivalent recorded above. Run 2026-11-16 at `6d2ba0d`: DATE_SOURCE_OK. Criterion 4 MET (behaviour unchanged since the fix wave `374e300`; the oracle was the defect).
- Owner message « filtres repliables »: collapsible panel on a phone (`9efc7b7`), spec `6d2ba0d`. The double announcement is fixed (the filter-only empty line is no longer a `role="status"`, the count line announces once).
+1
View File
@@ -18,6 +18,7 @@ RR-9).
### Added (2026-11-16, V1-2.6 R3 on `feature/v1-2-anatomical-sheets`: not merged into `develop`, sandbox and trial stack only)
- The official sheet list (`/app/admin/sheets`) gets a search on the sheet name in French or English (accents and case ignored, instant, with « Effacer la recherche » and Escape), a « Trier par » with « Dernière modification » (default) or « Nom », a count line « {n} fiches » / « {n} fiches sur {total} », and « Modifiée le 9 nov. 2026, 12:06 » on each row, in Paris time. The four filters are unchanged and combine with the search; a search without result names the searched text with a clear button. The Administration home card lists the five most recently modified sheets under « Dernières modifications », with « Voir les {n} fiches ».
- The filters of that list are collapsible on a phone (below 640 px): hidden by default behind a « Filtres » button that reads « Filtres (2) » when two are active, the four filters stacked when open, « Réinitialiser les filtres » inside the panel, closing keeps them; search and sort stay in view. From 640 px the page is unchanged. With a filter and no result, the screen reader now hears the empty result once (the count line), not twice.
- Migration M9 `20261116100000_sheet_admin_last_modified.sql`: the admin sheet summary answers `last_modified_at`, the newest of the sheet's and its versions' `updated_at`, so a draft save dates its sheet. Read change only; the typed client refuses an answer without a valid `last_modified_at` (`unavailable`). Applied to the sandbox and the trial stack, not to DEV.
- `pnpm db:sandbox migrate`: the branch's pending migrations on the running sandbox, forward only, no reset.
- Known open results, not green: pgTAP on the accumulated sandbox (`014_animals_relations` 2 of 258 failed, `021_sheet_verification_jobs` 23 failed with « Bad plan. You planned 90 tests but ran 42 »), read as dependent on the accumulated sandbox state, not proven by a run without M9; and the shell sweep (277 passed, 6 failed, 163 skipped, all six in `admin.spec.ts`). Four are the « admin screens » test with the known `Target crashed` of BLK-015. Two are A0, a lookup timeout on the rights screen, counted as BLK-015 with another symptom and not proven by an A/B run against the pre-R3 commit. Details: `docs/development/V1-2-6_U1_CORRECTIONS.md` §R3.
+4
View File
@@ -205,6 +205,10 @@ column at their own height beside the sheets card (`8bb2486`), the card's sheet
list row's rhythm (`8bb2486`). Left to the owner (`docs/development/V1-2-6_U1_CORRECTIONS.md` §R3): finding 5, at
375 px « Nouvelle fiche » beside the title where board 29 A draws it under (header older than R3); the top-bar
breadcrumb « Administration › Fiches officielles » the boards draw (shell level, older than R3); the info icon above.
Owner request 2026-11-16 after the trial on db:trial (no new board): below 640 px the four filters of the sheet list
sit in a collapsible panel behind a « Filtres » button (« Filtres (n) » when n are active, « Réinitialiser les
filtres » inside, closed by default, search and sort in view). Boards 28 and 29 draw the filters open; from 640 px
they still do.
Finding 6 (an opening guillemet can end a line, « version / 1 » orphan in the detail line) is not in the wave. Not
checked by the review: the card's badges and working copy action, the owner's layout (deduced from the code), the
English wording, the 0 or 1 sheet link, distinct dates, hover, screen reader output.
+14 -3
View File
@@ -510,7 +510,7 @@ le navigateur est fermé brutalement, comme tout formulaire non enregistré (lim
### 4.15 Démonstration R3 : la liste des fiches officielles et l'accueil Administration
À faire sur la pile d'essai (`db:trial`), dans l'application d'essai `http://<host>:5194`, avec le compte praticien
d'essai (rôle `admin` et habilitation `sheet_editor`), double authentification faite. Libellés :
`docs/design/v1-2-6-r0/REVUE.md:82-84`. Les étapes 1 à 9 se font à 1 280 px, l'étape 10 sur un téléphone ou dans une
`docs/design/v1-2-6-r0/REVUE.md:82-84`. Les étapes 1 à 9 se font à 1 280 px, les étapes 10 et 11 sur un téléphone ou dans une
fenêtre de 375 px. Chaque étape donne l'action, puis l'attendu.
La pile d'essai contient aujourd'hui deux fiches officielles : la fiche historique `faunosteo-cheval` (badge
@@ -576,10 +576,21 @@ ensuite sur la pile d'essai : c'est à vous de décider si vous les créez.
Revenez à la liste. Attendu : la copie de travail repasse en première position, devant les quatre fiches
créées.
10. Téléphone (375 px). Action : sur un téléphone, ou dans une fenêtre de 375 px, reprenez les étapes 1 à 4, 6 et
8. Attendu : le champ de recherche, « Trier par » puis les quatre filtres sont empilés sur toute la largeur, et
chaque contrôle fait au moins 44 px de haut. La date passe sur sa propre ligne, sous la ligne de détail. Aucun
8. Attendu : le champ de recherche et « Trier par » sont empilés sur toute la largeur, puis le bouton « Filtres »
(étape 11), et chaque contrôle fait au moins 44 px de haut. La date passe sur sa propre ligne, sous la ligne de détail. Aucun
défilement horizontal, même avec le long texte de l'étape 6. La carte de l'accueil se lit en entier. L'étape 5
se fait sur ordinateur : la modification d'un brouillon demande 1 024 px.
11. Filtres repliables (375 px). Action : sur un téléphone, ou dans une fenêtre de 375 px, ouvrez la liste des
fiches. Attendu : seuls le champ de recherche, « Trier par » et le bouton « Filtres » sont visibles ; les quatre
filtres sont cachés. Touchez « Filtres » : le panneau s'ouvre en glissant et montre les quatre filtres l'un
sous l'autre. Choisissez « Statut de version » : « Brouillon », puis « État de la fiche » : « Active ». La liste
suit tout de suite et le bouton devient « Filtres (2) ». Touchez le bouton pour fermer : le panneau se replie,
le bouton garde « Filtres (2) » et la liste reste filtrée. Rouvrez : les deux choix sont toujours là. Touchez
« Réinitialiser les filtres » (visible seulement tant qu'un filtre est actif, dans le panneau) : les filtres
reviennent à « Tous », le bouton redevient « Filtres » et le focus est sur lui. La recherche tapée avant n'est
pas touchée. Panneau fermé, la touche Tab ne passe pas dans les filtres. Si votre téléphone réduit les
animations (réglage d'accessibilité), le panneau s'ouvre et se ferme sans mouvement. À 1 280 px, rien ne change :
les quatre filtres restent affichés, sans bouton « Filtres » ni « Réinitialiser les filtres ».
Passez l'application en anglais si vous voulez relire les libellés (« Search a sheet by name », « Sort by »,
« Modified on 9 Nov 2026, 12:06 », « See the 2 sheets »). En anglais, « Nom » range par le nom anglais.
+21 -1
View File
@@ -738,6 +738,25 @@ Closing gates on the range `98178de..73ed375` (2026-11-16):
- Still pending: the owner's trial on the trial stack (`V1-2-6_OWNER_TRIAL.md` §4.15). Not checked by the build: a
browser sign-in on the trial stack (the owner's accounts).
Owner trial 2026-11-16 (db:trial): general behaviour validated; one last UX request for the phone, built the same
day (`9efc7b7`, spec `6d2ba0d`), no new board:
- Below `sm` (640 px, the breakpoint the page already uses) the four filters sit in a collapsible panel, closed by
default, opened by a « Filtres » button (`aria-expanded`, `aria-controls`; 44 px; « Filtres (n) » with n the
non-empty filters). Search and sort stay in view. Filters apply at once, closing keeps them. « Réinitialiser les
filtres » sits inside the panel, phone only, shown while a filter is active; the focus then goes to the « Filtres »
button (the reset button disappears). From `sm` the grid stays as before: no button, no reset.
- Mechanism: CSS only, no viewport detection. The panel is a grid whose row goes from `0fr` to `1fr` (200 ms, none
under `prefers-reduced-motion`), with `visibility: hidden` while closed so nothing in it takes focus or a tap.
The state is `data-open` plus classes, unit-tested in jsdom; the real behaviour is in the sandbox spec at 375 px and
1 280 px, fr and en.
- Double announcement (earlier open decision 5): confirmed in the code. With a filter and no result, the count line
(`aria-live="polite"`) and `role="status"` of the filters sentence both spoke. The sentence is no longer a live
region (the count line announces once, as `SearchNoResult` already did); the visible text is unchanged. The
sentence for « no official sheet at all » stays a status: no count line shows then.
- Verifier gap (criterion 4 of the contract): the one-line literal oracle was defective after `374e300` split the
line; the contract now holds the layout-insensitive check, run: DATE_SOURCE_OK. Criterion 4 met.
Owner decisions left open (R3):
1. The info icon of the no-result block: board 28 draws one, the page shows none (no glyph in `Icon`).
@@ -745,7 +764,8 @@ Owner decisions left open (R3):
3. The top-bar breadcrumb « Administration › Fiches officielles » the boards draw (shell level, older than R3).
4. With a filter and a search both active and no result, the page shows the filters sentence without « Effacer la
recherche » (board 28's note, followed literally).
5. In that same case, the double announcement: the count line and the `role="status"` sentence.
5. In that same case, the double announcement: the count line and the `role="status"` sentence. Fixed (see the owner
trial entry above).
### R4 — Integrity warning in catalogue cards (D9 C, independent fix)