148 lines
13 KiB
Markdown
148 lines
13 KiB
Markdown
# Design references
|
||
|
||
Permanent graphic references for the application, validated by the owner.
|
||
A screen built later follows these before any new proposal; a change of
|
||
direction needs a new validated file here, never a silent drift.
|
||
|
||
## faunosteo-etape7-maquettes-validees.png
|
||
|
||
Validated 2026-10-12 with Step 7 (identity). One image, seven views:
|
||
|
||
1. Connexion (desktop): split layout, brand panel left with a photo and the
|
||
tagline, white card right, Google + Apple under the form.
|
||
2. Inscription (desktop): centred card, password rules shown as a checklist.
|
||
3. Tableau de bord (desktop): sidebar (Tableau de bord, Bilans, Clients,
|
||
Animaux, Agenda, Fiches anatomiques, Mon compte, Paramètres, Réduire),
|
||
top bar with a bell and the user menu, four stat tiles, "Accès rapides"
|
||
and "Derniers bilans".
|
||
4. Profil et paramètres (desktop): "Mon compte" with tabs (Profil, Cabinet et
|
||
activité, Sécurité, Préférences), avatar with "Modifier la photo",
|
||
professional block with activity name, SIRET, activity type, website.
|
||
5. Menu mobile: drawer with the same navigation and "Se déconnecter".
|
||
6. Tableau de bord (mobile): hamburger, bell, avatar, stat tiles, quick
|
||
actions, bottom tab bar (Accueil, Bilans, Agenda, Profil).
|
||
7. Profil (mobile): tabs Profil / Sécurité, bottom tab bar.
|
||
|
||
### What the mockup shows beyond Step 7
|
||
|
||
The mockup is the target for the whole SaaS shell. Items it shows that no
|
||
step has built yet, with the step that owns them:
|
||
|
||
| Element | Owner |
|
||
|---|---|
|
||
| Clients and Animaux entries and screens | roadmap V1-1 (plan Step 12 reduced, `docs/development/V1-1_OWNERS_ANIMALS.md`). Clients built in V1-1.5 (2026-10-26): the entry in the sidebar and the drawer after Tableau de bord, the screens on the existing cards, fields, badges and buttons (the mockup draws no client screen); Animaux built in V1-1.6 (2026-10-26): the entry after Clients, the list, form and page on the same components (the mockup draws no animal screen either), relation actions as bordered buttons and in-page panel |
|
||
| Fiches anatomiques entry and screen | roadmap V1-2 (plan Step 13 reduced) |
|
||
| Bilans entry and screens | roadmap V1-3 (plan Step 14) |
|
||
| Agenda entry and screens | plan Step 20 |
|
||
| Stat tiles (bilans créés, clients, animaux, rendez-vous) and "Derniers bilans" | once the reports and agenda tables exist; never invented numbers |
|
||
| Notification bell | notifications step |
|
||
| Avatar photo and "Modifier la photo" | built in Step 8 (2026-10-13): circle + "Modifier la photo" in Informations personnelles, photo in the sidebar / drawer badge and in the top bar with the name on desktop (link to Mon compte, no dropdown) |
|
||
| Bottom tab bar on mobile | not reproduced in V1-1: owner decision D11 of 2026-10-26, the drawer stays the mobile navigation for V1-1 (Clients and Animaux in it). The mockup's bar (Accueil, Bilans, Agenda, Profil) stays the direction, a later UX subject, at the earliest with Bilans (V1-3); no custom V1-1 bar, the mockup unchanged |
|
||
| Tabs in Mon compte | optional restructuring when "Cabinet et activité" gains fields (activity type, website) |
|
||
| Password rule checklist | the mockup says 8 characters; the server policy is 12 with lower, upper and digit (config.toml); the hint text follows the server |
|
||
|
||
Step 7 as shipped (2026-10-11, validated 2026-10-12): login, signup,
|
||
password recovery, dashboard (profile completeness, local tool, account
|
||
facts), Mon compte as stacked sections, sidebar + drawer, FR/EN. The owner
|
||
accepted that the Home of the local tool (`/`) shows no sidebar while signed
|
||
in, only the "Mon espace" button, until the tool is integrated into `/app`.
|
||
|
||
## v1-2-4/ — V1-2.4 maquettes (validated 2026-11-02)
|
||
|
||
Produced 2026-11-02 for the owner's checkpoint (V1-2 contract §16.5, §11.3; brief « Clôture V1-2.3 et
|
||
lancement V1-2.4 »). Validated by the owner on 2026-11-02 (« V1-2.4 GRAPHICAL APPROVED », BDR-096, V1-2
|
||
contract §17.9): the twelve boards and the complementary page are the reference for V1-2.5 to V1-2.7. Functional
|
||
mockups on the existing identity (logo, `tokens.css` palette and fonts, Step 7 shell, cards, badges,
|
||
buttons, notices): no new design system. Source `maquettes.html`, rendered by `render.cjs` with the
|
||
pinned Chromium into twelve PNGs (the brief's eight items map to them in
|
||
`.claude/tasks/contracts/2026-11-02-v1-2-4-maquettes.md`; item 8, the open UX decisions, goes to the checkpoint):
|
||
|
||
1. `01`–`03` catalogue `/app/anatomy`: list, sheet page (desktop, with « Ouvrir dans l'administration »
|
||
for an editor), sheet page at 375 px;
|
||
2. `04` draft editor at 1 280 px (tabs, tools point / zone / detail view link, canvas, properties);
|
||
3. `05` read-only draft below 1 024 px (768 px and 375 px) with its notice;
|
||
4. `06` Vérification tab: before submission, verifying (attempts, last code), failed, unavailable;
|
||
5. `07`–`09` review screen: reviewer view with groups and acknowledgments, publication confirmation,
|
||
three mobile states;
|
||
6. `10`–`11` single « Administration » entry, desktop sidebar and mobile drawer;
|
||
7. `12` FR/EN labels, ratified or to arbitrate, and the 20 closed codes (identifier vs message).
|
||
|
||
One scenario runs through every board (stated at the top of `maquettes.html`): version 3 published,
|
||
draft version 4 at revision 11 in the editor, round 2 at revision 12 that can only end in « Modifications
|
||
demandées » because a group still holds « À confirmer » elements, and another round at its publication.
|
||
Revised 2026-11-02 after an independent design review (scenario consistency, publication text, editor
|
||
level 1 fields, shell consistency, mobile review actions, labels). Implementation note: the green badge
|
||
and the amber notice tones used here do not exist yet in `Badge.tsx` and `Notice.tsx`.
|
||
Corrected 2026-11-02 on the owner's authorisation (G1, G2 of the conformance check): board 06 no longer
|
||
shows a warning the core cannot raise, board 12 leaves the EN action « Mark as reviewed » to arbitrate and
|
||
states the real behaviour of `verification.integrity.fingerprint` and `verification.worker.verdict_refused`;
|
||
only `06` and `12` were re-rendered. Review dossier (a proposal at the time): `planche-contact.png` (source
|
||
`planche-contact.html`, the twelve boards in journey order) and `REVUE.md` (conformance, FR/EN labels to
|
||
arbitrate, SHA-256 of the files).
|
||
Corrected again 2026-11-02 on the owner's brief « dernières corrections graphiques », after an external
|
||
review: catalogue search by sheet name only (`01`), whole horse at opening on a phone (`03`), vertex
|
||
wording (`04`), the 1 024 px minimum instead of a device (`05`), distinct titles for the `failed` and
|
||
`unavailable` outcomes (`06`), the rows of `12` these touch; `02`, `07` to `11` unchanged.
|
||
`complement-acces-non-autorise.png` draws the « Accès non autorisé » page (BDR-094), outside the twelve
|
||
boards. Then the owner's label arbitrations (BDR-095): board 05 shows the whole horse at 768 px too, and
|
||
`05`, `06`, `07`, `09`, `10`, `12` carry the labels ratified on 2026-11-02 (REVUE.md lists them and those
|
||
still open). Approved as they stand at `74aa8f6`, no file regenerated: board `12` still shows the earlier
|
||
`object_conflict` message and « à arbitrer » marks that the approval settled; REVUE.md and the V1-2 contract
|
||
§17.9 hold the ratified wordings.
|
||
|
||
Owning steps of what the boards show: `01`–`03`, `10`, `11` and the complementary page with V1-2.5
|
||
(catalogue, Administration entry, access page), built on 2026-11-02 on the sandbox, with two deviations:
|
||
no « Sélection : … » tag over the canvas on desktop (`02`), and « Références » shown as a plain card on a
|
||
phone instead of a folded section (`03`); `04`, `05` and board `06` A with V1-2.6 (editor,
|
||
narrow-screen read-only mode, draft check); `06` B–D, `07`–`09` with V1-2.7 (verification states, review,
|
||
publication); the labels of `12` with the step that shows each of them. V1-2.6 built `04`, `05` and `06` A on
|
||
2026-11-04 on the sandbox (`/app/admin/sheets/:sheetId/draft`); the labels it adds beyond the boards are
|
||
proposals listed in `.claude/audits/2026-11-03-v1-2-6-label-proposals.md`, and the owner tries the editor by
|
||
`docs/development/V1-2-6_OWNER_TRIAL.md`.
|
||
|
||
Accepted deviations (owner 2026-11-02, V1-2.5): the boards stay as approved, nothing is redrawn.
|
||
1. The catalogue selection is shown in the zone panel, not in a « Sélection : … » tag over the drawing (`02`).
|
||
Condition: it stays identifiable and accessible (a live region in the panel names the picked zone).
|
||
2. On a phone, « Références » is a plain, non-collapsible card (`03`). Condition: it does not hide the
|
||
anatomical area (it starts at or below the drawing's bottom, checked at 320 and 375 px).
|
||
|
||
## v1-2-6/ — V1-2.6 graphic editor maquettes (validated 2026-11-05)
|
||
|
||
Validated by the owner on 2026-11-05 (brief « V1-2.6 — Validation UX définitive et préparation technique »: the
|
||
sixteen boards of archive V2 and the eleven choices of `ARBITRAGES.md`; confirmed for good by the brief « V1-2.6
|
||
UX — Autorisation U0 uniquement », no graphic arbitration reopened; V1-2 contract §17.12). They replace boards
|
||
`04` and `05` of v1-2-4 as the editing reference; board `05`'s narrow-screen read-only mode stays the reference
|
||
under O14 A (level-1 C16); BDR-096 stays in force for every other v1-2-4 board. The
|
||
« Ouvert » statuses of `ARBITRAGES.md` and the « à arbitrer » notes of `REVUE.md` are superseded by that
|
||
validation; both files are kept as archived. Boards `14` to `16` (phone editing) are the reference of a future
|
||
lot: in V1-2 the editor stays read-only below 1 024 px (O14 A, choice 9). Implementation follows
|
||
`docs/development/V1-2-6_UX_PLAN.md` (sub-steps U1 to U8), each on its own owner authorisation.
|
||
|
||
Produced 2026-11-05 on the owner's brief « V1-2.6 : nouvelles maquettes UX approuvées sur le principe »
|
||
(contract `.claude/tasks/contracts/2026-11-05-v1-2-6-ux-maquettes.md`). Sixteen boards, desktop, tablet and phone:
|
||
four tabs (Général, Annotations, Constats, Vérification), references in a side panel, point and zone tools with
|
||
direct manipulation (vertex handles, « + » on segments, « − » bubble, move and redraw modes, undo/redo), fixed
|
||
categories Os / Articulations / Vertèbres with colour and opacity, detail view drawn as a rectangle, vertebral
|
||
regions from the Vertèbres category, editor states, touch variants. Same identity and components as v1-2-4; the
|
||
drawing and every geometry come from the equine draft. Source `maquettes.html` and `planche-contact.html`,
|
||
rendered by `render.cjs`; `REVUE.md` holds the journey, the choices to arbitrate, the contradictions with
|
||
ratified decisions (§8.3 level 2, §8.4 O14 A, §8.2 numeric fields, §7.4 templates, BDR-096) and the feasibility
|
||
against the Rust core (detail: `.claude/audits/2026-11-05-v1-2-6-ux-feasibility.md`).
|
||
Direction accepted in principle by the owner on 2026-11-05; final graphic corrections the same day after an external
|
||
review (contract `.claude/tasks/contracts/2026-11-05-v1-2-6-ux-corrections.md`): trace commands in a fixed strip
|
||
(`04`), undo / redo as global header commands on every tab (owner-confirmed), board `07` split into one state per
|
||
interaction, counters computed from the draft data; boards `12` and `15` unchanged. `ARBITRAGES.md` separates the
|
||
owner-confirmed choices from the open ones; `ETUDE-TECHNIQUE.md` lists the prerequisites before any development.
|
||
|
||
`v1-2-6-constats/` (proposition de conception U2b, 2026-11-06; principe approuvé par le propriétaire le 2026-11-06, planches non validées graphiquement): boards 17-22, annotations ↔ findings complement; study and decisions F1-F22 `docs/development/V1-2-6_UX_FINDINGS_NAV.md`, boards shown with their decisions in its section 7.4.
|
||
|
||
`v1-2-6-r0/` (lot R0, 2026-11-09; owner graphic verdict the same day, BDR-109: direction APPROVED WITH THREE TARGETED
|
||
CORRECTIONS, boards 23, 24 and 26 corrected, 25, 27 and 30 approved as drawn, 28 and 29 approved for their state after
|
||
the SQL checkpoint of `docs/development/V1-2-6_R3_SQL_CHECKPOINT.md`; then three last corrections authorised (24 A uncited
|
||
reference, 26 A6 note, 28 A7 note), independent counter-check CONFORME; R0 GRAPHICALLY VALIDATED 2026-11-09, BDR-110): boards 23-30 after the owner's first U1 trial (brief
|
||
« V1-2.6 UX — Arbitrages du premier essai propriétaire », BDR-107): fifth tab « Références » with tiles, search and
|
||
view-only sort; contextual references panel opened from a finding only (34 rem, slide); « Défaire » / « Refaire »;
|
||
« Désélectionner » and the Escape priority; phone « Plus »; generic admin sheet list and home card; catalogue card in
|
||
integrity failure. Once validated they replace board 11 of `v1-2-6/` as the references reference. Plan and open
|
||
arbitrations: `docs/development/V1-2-6_U1_CORRECTIONS.md`; review, labels and points: `v1-2-6-r0/REVUE.md`.
|