docs(docs): R0 boards, U1 corrections plan and trial stack plan

Owner brief of 2026-11-09 after the first U1 trial. Boards 23-30 (proposal), lots R0-R4 with arbitrations A1-A15, persistent trial stack plan. No code.
This commit is contained in:
bchanot committed 2026-11-09 16:13:04 +01:00
1 parent 8cb681e2fa
commit 3d64146164
17 files changed
+1403

No files matched your search

+148
View File
@@ -0,0 +1,148 @@
# V1-2.6 R0 : arbitrages du premier essai propriétaire (proposition de conception, non validée)
Brief propriétaire du 2026-11-09 « Arbitrages du premier essai propriétaire », contrat
`.claude/tasks/contracts/2026-11-09-v1-2-6-trial-arbitrations.md` (critères 1 à 3). Ces planches remplacent la
direction de la planche 11 (`docs/design/v1-2-6/11-constats-references-desktop.png`) et complètent la coquille U1
telle qu'elle est construite. Aucun code d'interface n'est modifié avant leur validation.
| Fichier | Contenu |
|---|---|
| `23-references-onglet-desktop.png` | Éditeur à cinq onglets, onglet Références actif : recherche, « Trier par » (liste native, fermée, focus clavier), compteur, « Ajouter une référence », tuiles fermées et deux tuiles ouvertes (l'une citée par une famille seulement) avec « Modifier », « Supprimer », « Monter », « Descendre » ; en-tête sans bouton « Références », « Défaire » / « Refaire » |
| `24-references-recherche-tri.png` | A : recherche « ostéopathie », tri A → Z, ligne d'aide à la place de la réorganisation ; B : aucun résultat ; C : lecture seule ; D : tuile en modification (vue recadrée), ligne « 2 modifications non enregistrées » ; E : ajout d'une référence, nouvelle tuile en fin de fiche |
| `25-volet-references-constat.png` | Onglet Constats, volet contextuel du constat sélectionné (544 px = 34 rem), « Tout afficher dans l'onglet Références », voile ; déclencheur ; bande de mouvement (0, 90, 180 ms) et variante prefers-reduced-motion ; cas 1 024 px en note ; actions « Modifier » et « Retirer de ce constat » |
| `26-historique-deselection.png` | Onglet Annotations, point sélectionné, info-bulle de « Défaire » au focus clavier, « Désélectionner » à côté de « Supprimer » (info-bulle native au survol) ; A : dialogue de confirmation et son « Annuler » ; B : priorité de la touche Échap ; C : volet en lecture seule |
| `27-telephone-references.png` | 375 px : A menu « Plus » ouvert (Général, Constats, Références) ; B onglet Références ; C une tuile ouverte en consultation |
| `28-liste-fiches-desktop.png` | Administration › Fiches officielles : recherche par nom, tri, quatre filtres, « 12 fiches », date de dernière modification ; encarts recherche « cheval » (« 3 fiches sur 12 ») et recherche sans résultat |
| `29-liste-fiches-telephone-accueil.png` | A : la liste à 375 px, recherche active ; B : accueil Administration, carte « Fiches officielles » avec les cinq dernières modifications |
| `30-catalogue-carte-integrite.png` | Catalogue : une carte en échec d'intégrité, avertie dans la carte, et une carte en échec de chargement (réseau) avec « Réessayer » ; la même carte aujourd'hui ; la page de la fiche avec son message actuel (inchangée) |
| `planche-contact.png`, `planche-contact.html` | Les huit planches sur une page |
| `maquettes.html`, `gen-data.cjs`, `data.js` | Source des planches ; données calculées depuis `document.json` du brouillon équin |
Rendu : `node gen-data.cjs && PW_MODULE=<…>/apps/app/node_modules/@playwright/test node ../v1-2-6/render.cjs maquettes.html .`
puis la même commande sur `planche-contact.html` ; le fichier `all.png` produit est supprimé.
## Conventions
- Styles, icônes, coquille et dessin copiés de `v1-2-6-constats/maquettes.html` (eux-mêmes repris des planches
v1-2-6 validées) : mêmes jetons, aucune nouvelle couleur (la bordure des tuiles ouvertes reprend `--color-border`).
Aucun surlignage du texte trouvé par une recherche. Les lignes « ⋮ … » des listes défilées sont des annotations
de planche (style jaune), pas du texte d'interface. Trois icônes ajoutées dans le même trait : lien externe,
tri, désélection. L'éditeur suit U1 tel que construit : ligne d'enregistrement, « Abandonner les modifications »,
« Enregistrer », boutons d'historique sans bordure à droite de la barre d'onglets, « Plus » sous 640 px
(`tabs.ts`, `SHOWN.small`), volet de propriétés dans l'ordre de `PropertiesPanel.tsx`. Comme les planches
précédentes, la barre latérale est dessinée à 216 px (256 px dans l'application).
- Données calculées (aucune saisie à la main) : 48 références, leurs types, citations, DOI et URL ; les comptes
« Citée N fois » suivent `apps/app/src/editor/references/citations.ts` (familles et constats à toute
profondeur) : 178 citations portées par 83 éléments (2 familles, 81 constats), 15 références non citées sur 48
(dont « Catalogue historique Faunosteo… » et deux articles du Code rural, visibles en 24 A et 27 B). « Jäkel… »
(planche 23) n'est citée que par la famille « Dysfonctions ostéopathiques » de la synchondrose sphéno-occipitale. Seuls les
familles et les constats portent `reference_ids` dans le brouillon. Les listes « Citée par » avec leurs chemins,
le constat du volet (« Restrictions de mobilité articulaire », Articulation sacro-iliaque, 7 références, le plus
cité du brouillon), le point « Grasset » de la planche 26 (noms FR/EN, catégorie, latéralité, zone, centre et
rayon), les 2 vues et 27 zones de la carte du catalogue viennent tous de `data.js`. Recherche « ostéopathie » :
7 résultats (citation, DOI, URL, sans accents ni casse, comme `filter.ts`) ; « radiographie » : 0.
- Mise en scène (aucune donnée de document n'existe) : le fil d'Ariane et le nom « Cheval, squelette et rachis »,
« Brouillon, version 4 », « Révision 11 », les comptes « 3 » et « 2 modifications non enregistrées », « 2 erreurs »,
les noms d'utilisateurs (Bastien Chanot, Camille Laurent), les recherches « mulet » et « cheval » de la liste, toutes les lignes de la liste des fiches (noms,
versions, revues, états, dates), « Cheval (fiche historique) » (repris de la planche 10 v1-2-4), les cartes
« Chien » et « Chat, squelette et rachis » en échec et la version 3 publiée le 28/10/2026 de la carte Cheval (planche 01
v1-2-4). Les espèces des lignes illustratives viennent des lignes `species` des migrations (Cheval, Âne, Chien,
Chat, Bovin, Chèvre, Mouton, Porc, Lapin) ; aucune ligne n'utilise de nom ou de slug de données de test.
## Nouveaux libellés (FR / EN proposé)
| Où | FR | EN |
|---|---|---|
| Onglet (`editor.tab.references`) | Références | References |
| Historique, bouton | Défaire / Refaire | Undo / Redo (inchangés) |
| Historique, nom accessible | Défaire la dernière modification / Refaire la dernière modification défaite | Undo the last change / Redo the last undone change (inchangés) |
| Historique, info-bulle (title, survol) | … (Ctrl+Z ou ⌘Z) / … (Ctrl+Maj+Z ou ⇧⌘Z) | … (Ctrl+Z or ⌘Z) / … (Ctrl+Shift+Z or ⇧⌘Z) |
| Volet de propriétés | Désélectionner | Deselect |
| Recherche, bouton | Effacer la recherche | Clear the search |
| Tri, étiquette (externe, liste native) | Trier par | Sort by |
| Tri, options | Ordre de la fiche · Citation (A → Z) · Nombre de citations · Type | Sheet order · Citation (A → Z) · Number of citations · Type |
| Compteur | {n} références · {n} références sur {total} | {n} references · {n} references of {total} |
| Tuile | Citée {n} fois (texte existant `editor.references.cited_*`, majuscule initiale) · Non citée | Cited {n} times · Not cited |
| Tuile ouverte | Citée {n} fois, par : · Aller à · Aucun (DOI) · Aucune (URL) | Cited {n} times, by: · Go to · None · None |
| Tuile ouverte, marques | famille · ce constat | family · this finding |
| Tuile, actions | Modifier · Terminer | Edit · Done |
| Tuile en modification, titre | Modifier la référence | Edit the reference |
| Volet, action | Retirer de ce constat | Remove from this finding |
| Ajout, aide | Type et citation obligatoires. | Type and citation required. |
| Tuile, vide | Aucun constat ni aucune famille ne cite cette référence. | No finding or family cites this reference. |
| Onglet, bouton | Ajouter une référence | Add a reference |
| Ligne d'aide | Pour réorganiser, affichez l'ordre de la fiche sans recherche. | To reorder, show the sheet order without a search. |
| Aucun résultat | Aucune référence ne contient « {q} ». La recherche porte sur la citation, le DOI et l'URL. | No reference contains “{q}”. The search covers the citation, the DOI and the URL. |
| Volet, titre | Références citées | Cited references |
| Volet, compteur | {n} références citées par ce constat | {n} references cited by this finding |
| Volet, lien | Tout afficher dans l'onglet Références | Show all in the References tab |
| Liste des fiches | Rechercher une fiche par son nom · Dernière modification · Nom · {n} fiches · {n} fiches sur {total} · Modifiée le {date} | Search a sheet by name · Last modified · Name · {n} sheets · {n} sheets of {total} · Modified on {date} |
| Liste, recherche sans résultat | Aucune fiche ne contient « {q} » dans son nom. · Effacer la recherche | No sheet name contains “{q}”. · Clear the search |
| Repli A7 (date de la fiche) | Fiche modifiée le {date} · Fiches modifiées récemment | Sheet modified on {date} · Recently modified sheets |
| Accueil Administration | Dernières modifications · Voir les {n} fiches | Latest changes · See the {n} sheets |
| Carte du catalogue | Contrôle d'intégrité échoué : cette version ne peut pas être affichée. | Integrity check failed: this version cannot be displayed. |
Libellés repris du code sans changement : « Nouvelle référence », « Ajouter la référence », « Choisir… »,
« Connexion au serveur impossible. Vérifiez votre réseau. » (carte en échec réseau), « Plus », « Lecture seule », « Toutes les annotations », « Supprimer »,
« Monter », « Descendre », « Marquer comme relu », les types de référence, les messages de mode, de suppression
(`editor.delete.*`) et d'échec du catalogue, « Réessayer ».
## Ce qui change par rapport aux planches validées
- Planche 11 et en-tête U1 : le bouton « Références » de l'en-tête disparaît ; la bibliothèque devient le cinquième
onglet, entre Constats et Vérification (la structure à quatre onglets des planches 01 à 16 et de U1 passe à cinq).
Le volet secondaire reste, réservé au constat : plus large (34 rem au lieu de 27), filtré, sans réorganisation, ajout ni
suppression (« Retirer de ce constat » à la place), et sans la puce « Citées par … (n) » ni « Tout afficher (48) » de la planche 11, remplacés par le chemin du
constat et « Tout afficher dans l'onglet Références ».
- Les références passent de cartes à champs toujours éditables à des tuiles repliables ; la modification s'ouvre
par « Modifier » dans la tuile (mêmes champs, même application champ par champ ; « Citée … par » et « Aller à »
restent, « Supprimer », « Monter », « Descendre » sont masqués jusqu'à « Terminer »). L'ajout ouvre une tuile vide
en fin de liste, recherche et tri remis à zéro, focus sur « Citation » (24 E).
- Historique : « Annuler » / « Rétablir » deviennent « Défaire » / « Refaire » ; le raccourci (Ctrl ou ⌘) passe dans
l'info-bulle native (survol) ; au clavier et pour les lecteurs d'écran il passe par aria-keyshortcuts, auquel
s'ajoutent Meta+Z / Meta+Shift+Z. Pas de nouveau composant d'info-bulle.
- Volet de propriétés : ajout de « Désélectionner » ; Échap suit une priorité écrite.
- Liste des fiches : recherche, tri et date ajoutés ; filtres, badges et lignes inchangés. Carte d'accueil : cinq
dernières modifications au lieu des cinq premières fiches de la liste, mêmes badges et même ligne de détail que la liste (aucun
nouveau badge), date, lien « Voir les N fiches ». Recherche sans résultat : phrase propre à la recherche et
« Effacer la recherche ».
- Catalogue : un échec d'intégrité est dit dans la carte au lieu de réduire la carte en silence ; un échec d'une
autre nature (réseau) a sa propre ligne, ton d'avertissement, et « Réessayer ». Le badge « Publiée » reste.
## Points soumis au propriétaire
1. Réorganisation : « Monter » / « Descendre » seulement en ordre de la fiche et sans recherche ; ailleurs ils sont
masqués (pas grisés) et une ligne d'aide l'explique (24 A).
2. Tuiles : plusieurs ouvertes à la fois ; l'état ouvert, la recherche et le tri sont gardés tant que l'éditeur reste
ouvert (changement d'onglet compris, 24 D) et remis à zéro à sa réouverture.
3. Volet d'un constat : actions « Modifier », « Retirer de ce constat » (retire la citation, modification ordinaire
annulable) et les lignes « Aller à » ; ni réorganisation, ni ajout, ni « Supprimer » (chaque référence du volet
étant citée par le constat, le cœur le refuserait toujours). « Tout afficher » ferme le volet, ouvre l'onglet
avec recherche et tri remis à zéro et met le focus sur son titre.
4. Touche Échap : dialogue ouvert, puis menu ouvert, puis volet contextuel, puis tracé en cours, puis sélection ; un
champ de saisie garde Échap pour lui (recherche non vide : l'effacer). « Plus » est le seul menu ; « Trier par » est
une liste native, dont le navigateur gère Échap.
5. « Désélectionner » reste disponible en lecture seule (état d'interface), « Supprimer » n'y est pas. Focus après
« Désélectionner » : la ligne de l'annotation dans la liste, par le même chemin que « Toutes les annotations »
(`focusRow`, PropertiesPanel.tsx). À trancher aussi : « Toutes les annotations », en haut du volet, désélectionne déjà ; garder les deux, ou un seul.
6. Source de la date de la liste : la liste lit `anatomical_sheets.updated_at`, que l'enregistrement d'un brouillon
ne touche pas (28 fiches sur 219 de la sandbox ont une version plus récente). Soit une lecture SQL modifiée
(checkpoint dédié), soit une approximation documentée ; dans ce cas la ligne dit « Fiche modifiée le … » et la
carte d'accueil « Fiches modifiées récemment » (note de la planche 28).
7. Format de date : « Modifiée le 9 nov. 2026, 12:06 » (proposé) ou « Modifiée le 9 nov. 2026 à 12:06 ».
8. Carte d'accueil : cinq dernières modifications, badges et ligne de détail de la liste (aucun nouveau badge),
date, « Voir les N fiches ».
9. Carte du catalogue : libellé FR / EN ci-dessus, ton d'erreur, pour un échec d'intégrité (empreinte, illustration
manquante ou altérée, document illisible) ; un autre échec (réseau) a sa propre ligne, texte existant, ton
d'avertissement, avec « Réessayer ». Les échecs de taille (caps) et de vue (view) restent à classer.
## Contrôles
- Rendu avec le Chromium épinglé, aucune erreur de page ; chaque PNG relu, chevauchements et coupures corrigés.
- `impeccable` : aucune commande disponible (ni sur le PATH, ni par `npx --no-install`) ; non exécuté.
- Revue de conception indépendante (2026-11-09) : APPROVE WITH FIXES (3 MUST-FIX, 10 SHOULD, 9 NOTE). Appliqués :
les trois MUST (actions du volet, focus après « Désélectionner », carte en échec réseau), les dix SHOULD (liste
native « Trier par », info-bulle au survol avec ⌘, « Citée N fois » et marque « famille », état d'ajout, recherche
sans résultat de la liste, libellés de repli A7, plus de surlignage, carte d'accueil sans nouveau badge, lignes de
mise en scène en annotation, 24 D recadrée et actions en modification) et les notes 4 à 7. Non dessinés (notes
facultatives 1 et 2) : le dialogue de refus de suppression d'une référence citée, l'arrivée depuis Vérification.