docs(docs): V1-2.4 catalogue access UX and verdict_refused divergence

Records BDR-094 in the V1-2 contract (§5.3 hidden entry and « Accès non autorisé » page, §11.1 reviewer-only Administration content, §6.5 no operator notification, §17.8) and in REVUE.md. Boards unchanged, still a proposal.
This commit is contained in:
bchanot committed 2026-11-02 12:53:28 +01:00
1 parent 1a68cd8351
commit 7979506f35
2 files changed
+46 -6

No files matched your search

+9 -6
View File
@@ -74,24 +74,26 @@ Aucun.
## Décisions UX
Le brief du propriétaire du 2026-11-02 demande de conserver les dix décisions UX déjà ratifiées ; ce dossier n'en modifie aucune. Pour référence, les dix décisions de la liste du checkpoint, hors libellés :
Les dix décisions UX de la liste du checkpoint, hors libellés, sont ratifiées par le propriétaire (briefs du 2026-11-02, BDR-094, contrat V1-2 §17.8). Ce dossier n'en modifie aucune.
1. « Administration » visible aussi pour le rôle propriétaire, entre « Fiches anatomiques » et « Mon compte ».
2. Compte sans accès au catalogue (O21) : masquer « Fiches anatomiques », ou afficher la page avec une explication. Aucune planche ne dessine l'une ou l'autre option.
2. Compte connecté sans accès au catalogue (O21) : l'entrée « Fiches anatomiques » est masquée ; une URL directe affiche une page « Accès non autorisé » avec une explication et un lien de retour vers `/app`, que la fiche existe ou non. Un visiteur non connecté va à la connexion, jamais sur cette page. Les contrôles serveur, les habilitations et la RLS ne changent pas. Aucune planche ne dessine cette page.
3. Recherche du catalogue par nom de zone en plus du nom de fiche (planche 01).
4. « Soumettre à la revue » désactivé par le contrôle dans la page (planche 06 A).
5. Titre de l'issue indisponible : « Vérification échouée » ratifié avec l'étiquette « indisponible » (dessiné, planche 06 D), ou un titre distinct.
6. Badge « Copie de travail » conservé sur les brouillons suivants de la copie (planche 04).
7. Les comptes uniquement relecteurs gardent toute la coquille (planches 07, 09).
7. Les comptes uniquement relecteurs gardent toute la coquille (planches 07, 09), y compris l'entrée « Administration » pour atteindre leurs revues, avec seulement les entrées et actions que leur habilitation permet : ni « Nouvelle fiche », ni « Créer une copie de travail », ni « Accès et habilitations », ni création ou activation d'espèce.
8. Canevas : sélection en contour sombre pointillé avec ses sommets ; les planches utilisent le dessin de revue.
9. Livraison en dossier de douze PNG plus la source, au lieu d'« un fichier » (§16.5).
10. Pour l'implémentation, hors de cette tranche : teintes badge vert et encadré ambre, treize nouvelles icônes.
La décision restante, les libellés, fait l'objet du tableau suivant.
Le « reported to the operator » de §6.5 pour `verification.worker.verdict_refused` est consigné comme divergence (§6.5, BDR-094) : l'incident est journalisé et audité, aucune notification n'existe, aucune n'est ajoutée.
Restent en attente : la validation visuelle des douze planches et les libellés, objet du tableau suivant.
## Libellés FR/EN en attente (planche 12)
Seuls les libellés marqués « à arbitrer » ou « à confirmer » figurent ici. Les libellés ratifiés de §3 (états de revue, statuts de version, statuts d'un élément, « Groupe lu ») ne sont pas rediscutés. « Variante recommandée » est une proposition : aucun libellé n'est approuvé avant la décision du propriétaire. Les lignes L1 à L30 sont celles du premier checkpoint ; L31 s'y ajoute avec la correction G2.
Seuls les libellés marqués « à arbitrer » ou « à confirmer » figurent ici. Les libellés ratifiés de §3 (états de revue, statuts de version, statuts d'un élément, « Groupe lu ») ne sont pas rediscutés. « Variante recommandée » est une proposition : aucun libellé n'est approuvé avant la décision du propriétaire. Les lignes L1 à L30 sont celles du premier checkpoint ; L31 s'y ajoute avec la correction G2, L32 avec la décision BDR-094 (titre français fixé par le propriétaire, anglais à arbitrer).
### Statuts et états
@@ -115,12 +117,13 @@ Seuls les libellés marqués « à arbitrer » ou « à confirmer » figurent ic
| # | Emplacement | FR proposé | EN proposé | Rôle | Variante recommandée |
|---|---|---|---|---|---|
| L9 | Droits (`/app/admin/access`), éventuellement message d'un compte sans accès | « Accès au catalogue » | « Catalogue access » | Nom du droit `catalog_reader` (O21) | Libellé de §3, à garder ; l'endroit où il s'affiche dépend de la décision 2 ci-dessus |
| L9 | Droits (`/app/admin/access`), éventuellement message d'un compte sans accès | « Accès au catalogue » | « Catalogue access » | Nom du droit `catalog_reader` (O21) | Libellé de §3, à garder ; l'entrée est masquée sans ce droit (décision 2 ci-dessus) |
| L10 | Badge de fiche, carte Administration, en-tête de l'éditeur (planches 04, 10) | « Copie de travail » | « Working copy » | Signale la fiche issue de la fiche historique (O17) | Libellé de §3, à garder |
| L11 | Carte Fiches officielles (planche 10) | « Fiche historique (pipeline Git) » | « Historical sheet (Git pipeline) » | Désigne la fiche en lecture seule issue du dépôt | Libellé de §3 ; en interface, « Fiche historique » seul suffit, la parenthèse peut passer en infobulle |
| L12 | Bouton sur la fiche historique (planche 10) | « Créer une copie de travail » | « Create a working copy » | Lance l'opération serveur §14.3 | Garder |
| L13 | Barre latérale et tiroir (planches 10, 11) | « Administration » | « Administration » | Entrée unique de l'espace d'administration | Décidé le 2026-11-02 ; à garder |
| L14 | Cartes de la page Administration | « Fiches officielles » · « Espèces » · « Accès et habilitations » | « Official sheets » · « Species » · « Access and capabilities » | Les trois listes de §11.1 | Garder. EN « Access and permissions » se lit mieux, mais « Capability » est le terme ratifié en §3 |
| L32 | Page affichée sur une URL directe sous `/app/anatomy` sans le droit (décision 2, non dessinée) | « Accès non autorisé » (texte du propriétaire, BDR-094) | « Access denied » | Titre de la page ; suivi d'une explication et d'un lien de retour vers `/app` | EN « Access not authorised » colle au français ; « Access denied » est plus courant. Le texte de l'explication et du lien reste à écrire avec l'écran (V1-2.5) |
### Écran étroit (§8.4)
@@ -286,6 +286,15 @@ platform role.
`updated_at` and `working_copy_source_version_id`.
- The predicate gates the catalogue list, the published and deprecated
versions by id, archived sheets included (O8), and their drawings.
- Screens (owner, 2026-11-02, BDR-094): a signed-in account without the
right sees no « Fiches anatomiques » entry in the sidebar or the drawer; a
direct URL under `/app/anatomy` shows a page « Accès non autorisé » with an
explanation and a link back to `/app`, the same whether the sheet exists or
not. A visitor who is not signed in goes to `/login?next=` (`RequireAuth`),
never to that page. The hidden entry protects nothing: the predicate, the
capabilities and RLS decide. The entry's visibility may read the caller's own
grant rows (select policy `user_id = auth.uid()`); the page acts on the
server's answer, never on that hint.
- Definitive rights belong to the entitlement engine of plan Step 11 (offers,
`has_active_entitlement`), which does not exist. Nothing in V1-2 simulates
it. Switch conditions: Step 11 ships a catalogue capability (proposed name
@@ -988,6 +997,12 @@ did not pass; the closed codes keep the categories apart.
- Audit: submitted, verification passed or failed (outcome, codes), attempt
failed, withdrawn, decided, published.
- No partial publication: §6.8 is one transaction.
- Divergence recorded (owner, 2026-11-02, BDR-094): the « reported to the
operator » exit of « Verdict refused » is not implemented. The worker writes
an error line (`complete_malformed`, `crates/worker/src/verify_job.rs`) and
`fail_sheet_verification` keeps the code on the round and in the audit; no
notification is sent. No alert mechanism is planned in V1-2; the user
message says « l'incident est enregistré » / « the incident is logged ».
### 6.6 Element statuses, keys and coverage (O3 B, O7 A)
@@ -1570,6 +1585,14 @@ A drawing never blocks authoring: only the round waits for its verdict.
| `/app/admin/species` | E, V, P, O | catalogue species, active and inactive; creation (E), activation and renaming (O) |
| `/app/admin/access` | O | rights: grant, revoke, expiry |
Navigation (owner, 2026-11-02, BDR-094): « Fiches anatomiques » shows only to
catalogue readers (§5.3). One « Administration » entry shows to holders of a
capability and to the owner role; inside it, each account sees only the
entries and actions its capabilities allow. A reviewer-only account keeps the
entry to reach its rounds (R1) and sees no « Nouvelle fiche », « Créer une
copie de travail », « Accès et habilitations », species creation or
activation. Visibility never replaces the server checks.
### 11.2 Journeys
- A0 bootstrap: the owner enrols two factors, steps up, grants itself editor
@@ -2483,6 +2506,20 @@ Briefs « V1-2.2 : décisions et poursuite des corrections », « fermeture du d
| Accepted LOWs, still tracked | fully overlapping marker discs (human review finds them before publication; no claim that each marker stays selectable); arc rotation sub-pixel error; an arc tangent to the frame refused; the `f32` arc margin a bounded estimate; verification cost of an all-arc sheet (about 1.8 s natively); relative path commands accumulated in `f32`. Not fixed, never declared fixed; the duration of complex sheets is watched during the editor validations on real devices | RUST.md §12.13, §12.14, TODO |
| Chromium touch | taps up to about 10 px around a point's disc went to the point in the Chromium touch bench, not under WebKit: an observation (LRN-108), never a basis of the selection contract | RUST.md §12.14 |
### 17.8 V1-2.4 maquettes, decisions so far (owner, 2026-11-02)
Briefs « corrections G1/G2 et préparation de la validation propriétaire » and « validation de la
décision UX n° 3 » (BDR-094). The maquettes stay a proposal: the visual validation of the twelve
boards and the 31 FR/EN labels are still pending.
| Item | Decision | Where |
|---|---|---|
| G1, G2 | corrections validated: no warning the core cannot raise on board 06, « Mark as reviewed » left to arbitrate, fingerprint and `verdict_refused` messages true to the code; conformance check 8/8 acknowledged | `docs/design/v1-2-4/REVUE.md` |
| UX decisions | items 2 to 11 of the checkpoint list ratified; item 1 (labels) open | contract `2026-11-02-v1-2-4-maquettes.md` |
| Catalogue access (item 3, O21) | entry hidden without the right, « Accès non autorisé » on a direct URL, signed out → login, server checks unchanged | §5.3 |
| Administration for a reviewer-only account | entry kept to reach its rounds, only the entries and actions its capability allows | §11.1 |
| `verdict_refused` exit | « reported to the operator » not implemented: logged and audited, no notification, none planned | §6.5 |
---
## 18. Documents touched by V1-2.0