docs(docs): V1-2.6 U2 boards 02-06, 13, 31-33, review and arbitrations
This commit is contained in:
1 parent
c42c65509b
commit
bc19481b93
18 files changed
+1335
No files matched your search
@@ -743,6 +743,7 @@ Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheet
|
||||
- [x] Final fix wave (FX1-FX16, `.superpowers/sdd/2026-11-16-r4-card-integrity-2337/final-fix-list.md`): b378cf0 retry ending with no retry left keeps the polite region and moves focus to « Consulter », busy look on « Réessayer », engine stopped for good in the error tone, one attempt for two calls in one tick, rendered tests (engine stopped, two cards on the core, no blob URL after unmount); 2930f49 lines over 100 columns wrapped; 1e50585 board 30 deviation fixed (failure row `*:px-3`, both buttons on one row at 1280 and 375, e2e checks it); 3bea19f spec reads each own sheet's name by id before archiving, `seedGrant` account id through `capturedId`. App 1775 tests in 138 files; typecheck, lint, build exit 0. `catalogue-integrity.spec.ts` alone 6 passed 0 failed 0 skipped 0 flaky (twice: once with temporary screenshot lines, once as committed); `catalogue.spec.ts` alone 8 passed. Guard: 0 removed, 0 changed, 81 added (27 sheets, 43 versions, 11 grants), the runs' own; 8 R4 sheets archived, 4 grants revoked, read back. `pnpm check:all` then run at `2c9d837` (line above)
|
||||
- [ ] Follow-up: seed owner row in `private.catalog_write_budgets` is R4's own (none before R4; its first run created it, later runs update that same row, 4 archives per run; 8 of 300 per hour after the final wave, outside the data guard); `catalogue.spec.ts` still leaves its published sheets listed, warm-up its sheet and `sheet_editor` grant per invocation (BLK-015, RR-13)
|
||||
- [ ] owner arbitrations A1-A15 (`V1-2-6_U1_CORRECTIONS.md` §6, `TRIAL_STACK.md` §6)
|
||||
- [ ] V1-2.6 UX U2 design: boards 02-06, 13 redrawn + extras from 31 (owner brief 2026-11-17 « R4 est terminé … préparer U2 », orientation 2026-11-14 BDR-117; contract `.claude/tasks/contracts/2026-11-17-u2-design-boards.md`; docs only, no code, no DEV, no merge). [ ] audit as built · [ ] boards + REVUE + ARBITRAGES in `docs/design/v1-2-6-u2/` · [ ] fresh design review · [ ] fresh conformity check · [ ] STOP owner visual validation before any U2 plan or code
|
||||
- [ ] Test anomaly A (owner 2026-11-09, separate from U1/U2): fictitious fingerprints `'a'.repeat(64)` from worker stand-ins (`packages/supabase/tests/sandbox/sheet-fixtures.ts:115` openRound, `sheets-concurrency.sandbox.ts:168`, `sheets-perf.sandbox.ts:169`); 7 published/deprecated sandbox versions fail `check_published`. Fix: real fingerprint through the core (as e2e `fingerprintOf`, `apps/app/e2e/support/catalogue.ts:88`); never weaken the publish gate or the reader check. Needs its own go. Census 2026-11-17 (R4 Task 3, read-only): 4 of 164 catalogue entries fail, the four current « Cheval sandbox » versions (2 at v1, 2 at v2), all `fingerprint_mismatch`; R4 cards show them with the integrity line.
|
||||
- [ ] Test anomaly B (owner 2026-11-09, separate from U1/U2): `packages/supabase/tests/sandbox/sheets-admin.sandbox.ts:181-195` creates the historical working copy and never archives it; slot taken → `admin.spec.ts:717` fails x4. Fix test independence and cleanup; the existing copy `8c315a12-20d4-4432-9db3-7cb88b27a5b4` stays untouched until the owner authorises. Linked: RR-13, the admin.spec confirmation line above.
|
||||
- [x] Test anomaly C (owner 2026-11-09, separate from U1/U2): CLOSED 2026-11-17 with R4's owner validation. Integrity failure invisible in catalogue cards; implemented as lot R4; failure shown, never hidden or bypassed. Built 2026-11-17 (R4 Task 1-3 and final fix wave, `V1-2-6_U1_CORRECTIONS.md` §5 row C: built by R4, closes on the owner's validation); checked off with R4's owner validation.
|
||||
|
||||
@@ -0,0 +1,118 @@
|
||||
# CONTRACT — u2-design-boards
|
||||
- date: 2026-11-17 | flow: design and documentation only (U2 boards, review, arbitrations, tracking) | branch: feature/v1-2-anatomical-sheets
|
||||
- status: open
|
||||
- worktree: /home/bchanot/Documents/faunosteo-v1-2 (every command from this absolute path; never DEV: the
|
||||
`supabase_*_faunosteo` containers are DEV). The sandbox and the trial stack are not read nor written by this lot.
|
||||
- base: c42c655. Commit in place, push; no merge, no `gitflow.sh finish`.
|
||||
- untracked file kept: `faunosteo-v1-2-6-revue-ux-chatgpt.md`.
|
||||
|
||||
## REQUEST (verbatim — IMMUTABLE)
|
||||
|
||||
### Owner brief 2026-11-17 (R4 closed, U2 design start)
|
||||
|
||||
Je confirme avoir terminé mes tests manuels de R4 sur la sandbox.
|
||||
|
||||
Tous les tests fonctionnent correctement et le résultat me convient.
|
||||
|
||||
Je valide officiellement R4.
|
||||
|
||||
Je confirme également les deux décisions restantes :
|
||||
|
||||
1. Nettoyage des fiches de test :
|
||||
Je valide leur archivage plutôt que leur suppression.
|
||||
|
||||
Les règles métier concernant les fiches ayant eu une version publiée doivent rester inchangées.
|
||||
|
||||
2. Fichiers supplémentaires :
|
||||
J'accepte les modifications de Card.tsx et de l'utilitaire de validation des identifiants SQL.
|
||||
|
||||
Tu peux maintenant procéder à la clôture documentaire de R4 :
|
||||
- Enregistrer ma validation propriétaire.
|
||||
- Mettre à jour les contrats, le TODO et le suivi.
|
||||
- Enregistrer les décisions et apprentissages pertinents.
|
||||
- Conserver les résultats exacts des tests.
|
||||
- Committer et pousser les modifications documentaires.
|
||||
|
||||
BLK-015, RR-13 et l'anomalie A restent des chantiers séparés.
|
||||
|
||||
R4 est terminé.
|
||||
|
||||
Nous pouvons maintenant préparer U2 : la refonte de la manipulation graphique des annotations.
|
||||
|
||||
Je souhaite commencer par la conception graphique, conformément à notre méthode habituelle.
|
||||
|
||||
Reprends les maquettes validées et les nouvelles décisions UX concernant les modales de propriétés des annotations.
|
||||
|
||||
Les objectifs restent :
|
||||
- Création d'un point directement sur le schéma.
|
||||
- Création d'une zone en traçant son polygone.
|
||||
- Déplacement des sommets avec la souris ou le doigt.
|
||||
- Ajout d'un sommet avec « + » sur un segment.
|
||||
- Suppression d'un sommet avec « − ».
|
||||
- Déplacement et redessin d'une zone.
|
||||
- Modification de la taille d'un point.
|
||||
- Consultation et modification des propriétés dans une modale.
|
||||
- Ouverture de la modale de création après le placement du point ou la fin du tracé.
|
||||
|
||||
Les interactions graphiques doivent rester possibles sans que les modales gênent les gestes.
|
||||
|
||||
Prépare les nouvelles maquettes U2, notamment les planches 02 à 06 et 13, ainsi que les éventuels écrans supplémentaires nécessaires.
|
||||
|
||||
Je te laisse autonome pour auditer l'existant, proposer les meilleures interactions et organiser les relectures.
|
||||
|
||||
Présente-moi les maquettes pour validation visuelle avant toute implémentation de U2.
|
||||
|
||||
Aucune fusion ni intervention sur DEV.
|
||||
|
||||
## CLARIFICATIONS
|
||||
- « Les nouvelles décisions UX concernant les modales de propriétés des annotations » = the owner orientation of
|
||||
2026-11-14 (BDR-117), recorded in `docs/development/V1-2-6_UX_PLAN.md` §U2 « Orientation 2026-11-14 »,
|
||||
`docs/development/V1-2-6_UX_DECISIONS.md` row « U2 orientation » and `docs/design/README.md` note of 2026-11-14.
|
||||
- « Les maquettes validées »: `docs/design/v1-2-6/` boards 01 to 16 (approved for good, not reopened, except boards
|
||||
02 to 06 and 13 which the orientation sends back for redrawing), the R0 boards `docs/design/v1-2-6-r0/` 23 to 30
|
||||
(validated 2026-11-09, BDR-110; board 26 draws the Annotations tab as U1 built it), the constats boards
|
||||
`docs/design/v1-2-6-constats/` and the step 7 shell.
|
||||
- Ratified rules that bind the drawing (`V1-2-6_UX_DECISIONS.md`, `v1-2-6/ARBITRAGES.md`, `V1-2-6_UX_PLAN.md` §U2):
|
||||
choice 1 (a) a selected zone drags directly with the mouse, an explicit « Déplacer la zone » mode by touch; choice 3
|
||||
(b) the point size slider snaps to the sizes used in the view, no number shown, red minimum mark (core
|
||||
`marker_too_small`); choice 10 (b) the app sidebar hidden in the editor below 1 280 px; O14 A below 1 024 px the
|
||||
editor is read-only (boards 14 and 16 unchanged); T15 wording « Abandonner » for a form, « Défaire » / « Refaire »
|
||||
for the history (R0); T18 handle cap per shape; §2 G keyboard (Tab between handles, arrows, Maj by 10, Inser,
|
||||
Suppr, Entrée, Échap); 44 px touch targets; no coordinate field in the normal journey; curves excluded (curves lot).
|
||||
- What is open and goes to the owner as an arbitration: any deviation from the 2026-11-14 interaction rules that the
|
||||
request's « sans que les modales gênent les gestes » leads to, the dialog placement over the drawing, the laterality
|
||||
default at creation (C25), and any other visible choice the boards make.
|
||||
|
||||
## ACCEPTANCE CRITERIA
|
||||
1. Boards: a new folder `docs/design/v1-2-6-u2/` holds `maquettes.html`, its data generator and generated data, one
|
||||
PNG per board rendered with the pinned Chromium (`docs/design/v1-2-6/render.cjs`), a contact sheet (PNG and HTML)
|
||||
and `REVUE.md` in French. Boards 02 to 06 and 13 are redrawn under their numbers; extra boards, if any, are
|
||||
numbered from 31.
|
||||
2. Objectives: each of the nine objectives of the request is drawn on at least one board, and `REVUE.md` holds a
|
||||
table objective → board(s) → what is shown.
|
||||
3. Dialogs: properties are read and edited in a modal dialog (read mode first, then a form whose actions reuse the R2
|
||||
wording); the creation dialog opens after the point is placed or the trace is finished, the new shape staying
|
||||
visible; no board shows a gesture on the drawing while a dialog is open, and no dialog covers the shape it
|
||||
concerns. The rule for when a dialog opens (and when it does not) is written in `REVUE.md`.
|
||||
4. Geometry on the drawing: point move and size (slider in the fixed strip with the red minimum mark and the snap
|
||||
marks), vertex drag, « + » on a segment, « − » on the chosen vertex, zone move (mouse direct, touch explicit mode),
|
||||
redraw keeping the old shape until accepted, each undoable in one step through « Défaire »; no coordinate field.
|
||||
5. Touch: board 13 at 1 180 px with 44 px targets, the sidebar hidden (choice 10 b), the explicit touch move mode, and
|
||||
a dialog opened by touch.
|
||||
6. Keyboard: the alternative to every drag (WCAG 2.5.7) and the focus path into and out of the dialogs (return target)
|
||||
are drawn or written on the boards.
|
||||
7. Identity and truth: tokens, shell (five tabs, « Défaire » / « Refaire », save line as built after R2), components and
|
||||
icons reused from the validated boards with no new colour; annotations at their real coordinates from the equine
|
||||
draft `document.json` through the generator; every new visible label listed in `REVUE.md` with FR and EN.
|
||||
8. Arbitrations: `docs/design/v1-2-6-u2/ARBITRAGES.md` lists every choice that needs the owner, each with what the
|
||||
boards draw, the alternatives, the consequences and a recommendation; any deviation from the 2026-11-14 orientation
|
||||
is named as such.
|
||||
9. Reviews: a fresh design review and a fresh conformity check against this contract, their exact results written in
|
||||
`REVUE.md` (or a `CONTROLE-CONFORMITE.md`), and `impeccable detect` on `maquettes.html` run or its absence stated.
|
||||
10. Restrictions: the branch diff from c42c655 touches only `docs/`, `.claude/tasks/`, `.claude/memory/`; nothing under
|
||||
`apps/`, `packages/`, `crates/`, `supabase/`, `scripts/`; no stack started, stopped or written; no merge; DEV
|
||||
unchanged; the untracked review file still present.
|
||||
|
||||
## FILE SCOPE
|
||||
docs/design/v1-2-6-u2/**, docs/design/README.md, docs/development/V1-2-6_UX_PLAN.md (U2 note only),
|
||||
.claude/tasks/TODO.md, .claude/tasks/contracts/this file, .claude/memory/*
|
||||
Reference in new issue
Block a user