Files
faunosteo/.claude/tasks/contracts/2026-11-02-v1-2-4-maquettes.md
bchanot 567f27e37d docs(docs): record the V1-2.4 owner graphic approval
V1-2.4 GRAPHICAL APPROVED: twelve boards and the « Accès non autorisé » page, unchanged. Contract §16.5 state, §17.9 (object_conflict FR, L14, L20 EN, L32 EN, messages checked at integration, L15 second sentence open), §3 and §11.3 pointers; REVUE.md labels and status; design README validated with owning steps.
2026-11-02 15:38:42 +01:00

134 lines
10 KiB
Markdown

# Contract: V1-2.4 maquettes (owner briefs of 2026-11-02)
Briefs « Clôture V1-2.3 et lancement V1-2.4 » §4-§6 and « Incident DEV … reprise V1-2.4 » §6. Scope file
`.claude/tasks/contracts/2026-11-01-v1-2-4-wireframes-scope.md`; plan V1-2 contract §16.5, §11.1-§11.3,
§3, §6.3-§6.8, §8.2, §8.4. Deliverable: mockups only, no React, SQL, rule or contract change. Proposals
until the owner validates them. STOP at the graphic checkpoint.
## Criteria
- M1 Identity: existing logo, validated palette (`apps/app/src/styles/tokens.css`), Step 7 principles,
components and spacing (`docs/design/faunosteo-etape7-maquettes-validees.png`, shell as built); no new
design system; functional-mockup level, not a redesign; logo and validated design unchanged.
- M2 Catalogue `/app/anatomy` in its own section: consultation, search and selection along planned
features, links to editor or review only when authorised, consultation vs modification distinct; no
community feature, no permission change.
- M3 Editor desktop from 1 024 px: tabs of the plan, canvas, points and zones, detail-view access,
Vérification tab, errors, warnings and results needing review.
- M4 Narrow screens: read-only mode shown clearly with the reason editing is not available.
- M5 Review desktop and mobile: verification state, attempts, last relevant technical code, failed and
unavailable, groups and acknowledgments, comments, decision, confirmation before publication; actions
match existing capabilities; no mockup suggests a publication without a valid, current verdict.
- M6 One « Administration » entry, desktop sidebar and mobile drawer, shown only to entitled roles, with
access control stated as independent of visibility.
- M7 FR/EN labels with O21, O23 and the 20 closed codes; internal identifier distinct from the user
message; undecided labels submitted for arbitration, not validated implicitly.
- M8 Delivered in `docs/design/` following its conventions (README line), marked as an unvalidated
proposal; the eight presentation items of the brief covered.
## The brief's eight presentation items (owner brief 2026-11-02 §6) and their boards
1. Catalogue in read-only: boards 01, 02, 03.
2. Desktop editor: board 04.
3. Read-only on a narrow screen: board 05.
4. Vérification tab and its main states: board 06.
5. Review screen desktop and mobile: boards 07, 08, 09.
6. Administration navigation desktop and mobile: boards 10, 11.
7. FR/EN labels to arbitrate: board 12.
8. Open UX decisions: listed in the checkpoint to the owner (not a board).
## Item 8: open UX decisions submitted to the owner (checkpoint of 2026-11-02)
1. Every label marked « à arbitrer » or « à confirmer » on board 12, including « Retirée » vs « Soumission retirée ».
2. « Administration » also shown to the owner role (board 10), placed between « Fiches anatomiques » and « Mon compte ».
3. Account without catalogue access (O21): hide « Fiches anatomiques », or show the page with an explanation.
4. Catalogue search by zone name as well as sheet name (board 01), beyond §11.1's « by species ».
5. « Soumettre à la revue » disabled by the in-page check (board 06 A), though the server verdict would refuse anyway.
6. Heading of the unavailable outcome: ratified « Vérification échouée » with an « indisponible » tag, or a distinct heading.
7. « Copie de travail » badge kept on later drafts of the working copy (board 04).
8. Reviewer-only accounts keep the full shell (boards 07, 09).
9. Canvas: selection drawn as a dark dashed outline with its vertices; the boards use the review drawing (every annotation highlighted), not the practitioner rendering.
10. Delivery as a folder of twelve PNGs plus source rather than one file (§16.5 « one file »).
11. For implementation, outside this slice: green badge and amber notice tones, thirteen new icons.
Owner, 2026-11-02 (BDR-094, V1-2 contract §17.8): items 2 to 11 ratified. Item 3: entry hidden without the
catalogue right, « Accès non autorisé » on a direct URL, signed out → login. Item 8 read with the brief's
point 4: a reviewer-only account keeps « Administration » with only the entries its capability allows. Item 1
(labels, now 31 with « Mark as reviewed ») and the visual validation of the twelve boards stay open.
Owner, 2026-11-02 (brief « V1-2.4 : dernières corrections graphiques », after an external review of the
twelve boards): item 4 withdrawn (catalogue search by sheet name only); item 6 settled (distinct headings).
## Final graphic corrections (brief « V1-2.4 : dernières corrections graphiques », 2026-11-02, on fdf0f7f)
Direction accepted, no redesign. Only the boards concerned and their sources change; no application code,
no DEV, no Docker, no merge, no V1-2.5; no definitive graphic approval recorded. STOP at the final graphic
checkpoint.
- F1 Board 01: no search by zone; the field reads « Rechercher une fiche »; REVUE.md follows.
- F2 Board 06: outcome `failed` titled « Vérification échouée » / « Verification failed », outcome
`unavailable` « Vérification indisponible » / « Verification unavailable »; each state keeps its own
explanation and exits.
- F3 Board 03: at opening on mobile the whole horse is visible (initial framing fitted to the screen), zoom
afterwards; the anatomical SVG is not modified.
- F4 Board 05: no device imposed; the notice names the 1 024 px minimum width instead.
- F5 Board 04: vertex wording clarified, level 1 behaviour of §8.2 and §8.3 unchanged (an annotation moves
as a whole, vertices are edited in the list, no vertex drag, no resize on the drawing).
- F6 A complementary board « Accès non autorisé » / « Access denied » (BDR-094, contract §5.3): current
design, nothing reveals whether a sheet exists, a link back to `/app`; kept outside the twelve boards.
- F7 Labels: ratified labels unchanged; the external review's L1-L32 wordings recorded as proposals only,
none as a decision; error codes and business rules unchanged; board 12 touched only where F2, F4, F6
require it.
- F8 Delivery: only the boards concerned regenerated (02, 07 to 11 byte-identical to fdf0f7f); contact
sheet, REVUE.md, SHA-256 (REVUE.md table and the archive's SHA256SUMS) refreshed; a new archive with the
twelve boards, the complementary page, the HTML source and the report; M1 to M8 still hold on the batch.
## Owner arbitrations (brief « arbitrages propriétaire et préparation de validation finale », 2026-11-02, on c2a3147)
The six corrections F1-F6 confirmed. Documentation only: no application code, no DEV, no Docker, no merge, no
deployment, no V1-2.5; no global graphic approval invented. Commit and push only after a conforming check.
- A1 BDR-095 recorded (sheet-name search replacing the zone search of BDR-094's item list; distinct
`failed` / `unavailable` titles; no SQL model or business-rule change); contradicting references updated in
the contract documents.
- A2 Board 05 at 768 px: the whole horse at initial framing, as on board 03; « Lecture seule », narrow-screen
consultation, planned zoom and pan, the historical SVG and the 1 024 px editing threshold kept; the board not
redone, editing rules unchanged.
- A3 `verification_failed` kept as the technical status; for V1-2.7 lists, content failure vs technical
unavailability shown only when existing data establish the cause, else an exact generic label; recorded for
V1-2.7, no migration, no implementation.
- A4 The wordings common to both reviews ratified only once checked identical, compatible with the contract and
true to the code; L30 is a note, not a label. Owner arbitrations applied: L2 « À lire » / « To read »; L3
« Marquer le groupe comme lu » / « Mark group as read »; L14 « Accès et habilitations » / « Access and
permissions »; L15 « L'édition nécessite une largeur d'écran d'au moins 1 024 px. » / « Editing requires a
screen at least 1,024 px wide. », the warning not repeated; L20 « Corriger le brouillon » (content failure),
« Modifier le brouillon » (size limit); L32 « Retour au tableau de bord » / « Back to dashboard » to `/app`;
`size_mismatch` names the file size; both marker codes say « sur mobile »; `object_conflict`: the owner's
wording checked against the code's meaning before any ratification. Technical codes and already ratified
messages unchanged.
- A5 Only the affected images and the contact sheet regenerated; REVUE.md, decisions, contract references and
SHA256SUMS updated; a complete archive rebuilt (12 boards, complementary board, HTML sources and the resources
they need, labels table and decisions, verified sums); an independent check on the final deliverables,
archive included.
Scope note: the §13.1 risk register added to the V1-2 contract in f00d8b4 belongs to the V1-2.3 closure the owner ordered (BDR-093), not to the maquettes; it records accepted risks and changes no rule.
## Owner approval (brief « Validation propriétaire V1-2.4 », 2026-11-02, on 74aa8f6)
**V1-2.4 GRAPHICAL APPROVED** (BDR-096, V1-2 contract §17.9): the twelve boards and the complementary page
« Accès non autorisé », as examined in the archive `faunosteo-v1-2-4-maquettes-arbitrages-3.zip`. Recorded in
the contract, the BDR registry, the TODO and the journal; no board, source or rule changed.
- Last arbitrations: `object_conflict` FR « Le contenu du fichier de l'illustration ne correspond pas à son
empreinte SHA-256 enregistrée. »; L14 « Access and permissions » in the interface, `capability` a technical
term; L20 « Fix the draft » / « Edit the draft »; L32 « Access denied », explanation and link already decided.
- The other technical messages are checked at their integration and do not block the graphic closure; L15's
second sentence, not named by the brief, stays open until V1-2.6.
- Minor documentary remarks may be fixed without a new graphic review, the boards unchanged.
- Next: commit and push on `feature/v1-2-anatomical-sheets`, check the prerequisites of V1-2.5 (§16.6); start
it only if they are VERIFIED, within the existing contract. Kept: no merge into develop, main or a release;
no Supabase DEV operation without its own authorisation; no worker on DEV; tests and an independent review
fit for the step; commits and pushes on the V1-2 branch; STOP at the V1-2.5 checkpoint. The graphic design is
not reopened without a demonstrated defect or a new owner decision.