Files
faunosteo/docs/design/v1-2-6-r0/REVUE.md
T
bchanot 3d64146164 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.
2026-11-09 16:13:04 +01:00

15 KiB
Raw Blame History

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.