Files
faunosteo/docs/design/README.md
T

148 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`.