Files
faunosteo/docs/design/README.md
T
bchanot a86020d6e3 docs(app): R3 sheet list documents as built, M9 applied
V1-2-6_U1_CORRECTIONS §R3 as built (A7 split superseded by D2, exact
results, deviations), the SQL checkpoint applied with corrections F2 to
F4, the owner's answers and the date limits F7, M9 in §12.3, db:sandbox
migrate, the sheet list spec and its named failures, class C rows, the
design deviations, CLAUDE.md and CHANGELOG. Gates pending.
2026-11-16 17:47:49 +01:00

202 lines
18 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).
Accepted deviation (owner 2026-11-12, brief « V1-2.6 — R1 — Dernier retour utilisateur »): the « Sélection : … »
tag of board `04` (and of board `26` of `v1-2-6-r0/`) over the drawing is no longer shown, in the editor and its
read-only twin. It was redundant with the highlight and the side panel, and moved the drawing at each selection
change. It stays in the DOM as screen-reader-only text (`sr-only`, not a live region), so nothing is announced
twice.
## 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`.
2026-11-13: R2 finish. No new mockup was made. The owner brief « finition R2 » plus the owner's gate of the same day
validated the plan's R2F-9 changes to the ratified R2 screens (boards 23 to 27, `v1-2-6-r0/`). The design reference for
these screens is now the code plus `docs/development/V1-2-6_U1_CORRECTIONS.md` §R2 (« Finition 2026-11-13 »). The six
approved changes:
1. Transactional forms in the finding and reference dialogs: one undoable operation per save (BDR-050 re-planned).
2. The citations panel becomes a modal side sheet over the finding dialog, still opened from a finding only (D2, boards 24
and 25, P16 and P17); its section geometry and the landscape cramped exception are gone. Superseded 2026-11-15
(note below): a references dialog replaces the side sheet.
3. The editor's view layers (tab, section, finding dialog, sheet, reference dialog, filter) live in the browser history,
navigation state only, never typed data, personal searches or drafts (A2).
4. « Tout afficher dans l'onglet Références » filters the tab by the finding, with a removable chip (A3).
5. « Plus » opens as an overlay dropdown (board 27 A), closed first by the Android Back request where the browser
offers it. Superseded 2026-11-15 (note below): a vertical list.
6. No new mockups for such changes: the owner brief and the gate stand as validation.
Not changed: the clients and animals list searches are not kept in browser history (BDR-078 stands).
2026-11-15: R2 follow-up (owner brief after the `db:trial` check, `docs/development/V1-2-6_U1_CORRECTIONS.md` §R2,
« Owner follow-up 2026-11-15 »). No new mockup, the brief stands as validation. Two changes to the ratified screens:
1. Board 25 (the citations side sheet) is replaced by a references dialog stacked over the finding dialog, opened
from « X références ». View mode reads; its own « Modifier » cites, removes, creates a reference or opens a
reference's dialog. The finding dialog keeps only « Références citées » and the « X références » button. Families
get the same dialog.
2. Board 05, phone split (owner decision, 2026-11-15): one tab order everywhere (Général, Annotations, Constats,
Références, Vérification); below 640 px Général and Annotations are shown and the other three sit under « Plus »,
in that order, a vertical list of rows of 48 px at least. The earlier phone split (Annotations and Vérification
shown) and the horizontal « Plus » overlay of board 27 A are replaced. Board 05's read-only mode below 1 024 px is unchanged.
2026-11-14: U2 orientation (owner brief, `docs/development/V1-2-6_UX_PLAN.md` §U2, « Orientation 2026-11-14 »). Under
`v1-2-6/`, boards 02 to 06 and 13 show a properties side panel next to the drawing. They are to be redrawn at the U2
planning: the properties panel becomes a dialog opened over the drawing, and the trace strip gains the point-size
slider, « Déplacer la zone » and « Redessiner ». The owner validates the redrawn boards before any U2 code. Boards 14
and 16 (phone) are unchanged (O14 A). Until then the boards stay the reference for everything else they show.
2026-11-16: R3 built (owner brief « R3 » and validation of plan rev 2b, `docs/development/V1-2-6_U1_CORRECTIONS.md` §R3
« As built 2026-11-16 »). Boards 28 (sheet list, desktop) and 29 (sheet list at 375 px, Administration home card) of
`v1-2-6-r0/` are the reference, labels as `v1-2-6-r0/REVUE.md:82-84`. Built as drawn: the search field with its clear
button, « Trier par », the count line, « Modifiée le … » on each row, the four filters unchanged, the no-result note of
board 28 literally, the card's « Dernières modifications » with at most five sheets. Two deviations from the boards:
1. No magnifier in the search field, although boards 28 and 29 draw one (F14): `Icon` has no such glyph, and the two
search fields already shipped and validated (catalogue, Références tab) show none. Validated by the owner with the
plan (2026-11-16, « Pas de nouvelle icône de recherche »).
2. No info icon in the no-result block, although board 28 draws one: same reason (no glyph in `Icon`, the plan allows
no new icon); the block follows the editor's validated no-result block. A ruling made during the build, to be
confirmed by the owner.
Below two sheets the card's link reads « Toutes les fiches officielles » instead of « Voir les {n} fiches » (owner
decision D6, 2026-11-16). The design review of the two screens against boards 28 and 29 at 1 280 and 375 px is pending
at the time of writing (2026-11-16).