Files
faunosteo/docs/design/v1-2-6-r0/REVUE.md
T

24 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 et citées (l'une par une famille seulement) avec « Modifier », « Monter », « Descendre » et la ligne d'aide de suppression, sans « Supprimer » ; 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, une référence non citée ouverte avec « Supprimer » ; 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 tel que U1 l'a construit (puces de vues, ligne d'outil, étiquette de sélection, colonne d'outils en icônes, boutons d'ajout au clavier), point sélectionné, info-bulle de « Défaire » au survol, « 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. Deux icônes dessinées, dans le même trait : lien externe, désélection (une icône de tri est définie dans la source mais n'apparaît sur aucune planche). 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
Tuile ouverte, intitulé URL URL
Volet, action Retirer de ce constat Remove from this finding
Annonce accessible après « Désélectionner » Aucune annotation sélectionnée. No annotation selected.
Tuile ouverte d'une référence citée, aide (à la place de « Supprimer ») Pour supprimer cette référence, retirez d'abord chacune de ses citations : « Aller à », puis « Retirer » dans le détail du constat ou de la famille. To delete this reference, first remove each of its citations: “Go to”, then “Remove” in the finding's or family's detail.
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
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 ».
  • Suppression (décision du propriétaire, 2026-11-09) : une référence encore citée n'affiche jamais « Supprimer » ; sa tuile ouverte porte à la place la ligne d'aide ci-dessus (« Retirer » est le libellé existant du détail d'un constat ou d'une famille, ce qui couvre aussi une citation par une famille, comme Jäkel). Une référence non citée garde « Supprimer » et le dialogue de confirmation existant : planche 24 A, où la première référence, non citée, est ouverte avec « Supprimer » (dialogue existant cité dans la note, pas redessiné). Aucune règle de suppression ne change.
  • 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 si elle existe encore, par le même chemin que « Toutes les annotations » (focusRow, PropertiesPanel.tsx), sinon le dessin ; rendre le focus ne crée jamais de sélection ; une annonce accessible dit « Aucune annotation sélectionnée. ». À trancher aussi : « Toutes les annotations », en haut du volet, désélectionne déjà ; garder les deux, ou un seul.
  6. Date de la liste (règle finale) : la liste lit aujourd'hui 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). Avant le checkpoint SQL (docs/development/V1-2-6_R3_SQL_CHECKPOINT.md) : aucune date de dernière modification présentée comme fiable et aucun tri par cette date (recherche et tri par nom seulement). Après validation et application du checkpoint : la vraie date et son tri, comme dessiné sur les planches 28 et 29. Pas de repli « Fiche modifiée le … ».
  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 : voir la section « impeccable detect » (lancé par le propriétaire).
  • 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 (retirés depuis), 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.

Contre-vérification indépendante (2026-11-09)

Vérificateur neuf, critère 3 du contrat seulement, sur 9500906 : les deux corrections non revérifiées sont closes (« Modifier la référence » listé en FR et EN ; plus aucune couleur hors jetons, #d8cdb9 absent ; les huit PNG rendus à nouveau sont identiques octet pour octet). Il relevait deux écarts mineurs, traités dans ce fichier sans toucher aux planches :

  • « URL » seul comme intitulé de la tuile ouverte : ajouté au tableau des libellés.
  • Planche 24 D, la ligne « Chaque champ s'applique au brouillon quand il perd le focus, comme aujourd'hui. » est dessinée comme une aide d'interface. C'est une note de maquette qui décrit le comportement actuel, pas un libellé à construire ; elle n'entre pas dans le tableau.

Hors critère, relevé par le même contrôle : la barre d'outils de l'onglet Annotations de la planche 26 reprend celle des planches v1-2-6 validées (« Sélectionner », « Ajouter un point », « Ajouter une zone », « Créer une vue détaillée »), alors que U1 a construit une colonne d'icônes (ToolColumn.tsx). Cet écart existait avant R0 ; R1 ne touche pas à cette barre. Corrigé depuis (corrections du propriétaire ci-dessous) : la planche 26 dessine la colonne d'outils de U1, et la ligne de 24 D est maintenant une annotation de maquette (style jaune), hors de l'interface.

Corrections du propriétaire (2026-11-09)

Direction graphique R0 approuvée avec trois corrections ciblées. Les planches 25, 27 et 30 sont approuvées et inchangées : leurs PNG sont identiques octet pour octet (sha256 vérifiés avant et après le rendu). Pour cela, le cadre de la planche 23 a perdu 78 px (liste défilante, seule la dernière tuile partiellement visible disparaît) afin que la nouvelle note jaune ne décale pas les planches suivantes dans la page de rendu.

  • Planche 23 : plus de « Supprimer » sur les tuiles ouvertes citées (White SA, Jäkel), remplacé par la ligne d'aide de suppression (libellé dans le tableau) ; note jaune : une référence non citée garde « Supprimer » ; la note du tri ne parle plus du dialogue de refus. « Modifier », « Monter », « Descendre » et la marque « famille » restent. Écart de formulation assumé : la proposition citait « Retirer de ce constat », action du seul volet d'un constat ; le texte retenu nomme « Retirer », l'action existante du détail d'un constat ou d'une famille, exacte aussi pour Jäkel, citée par une famille.
  • Planche 24 D : « Chaque champ s'applique au brouillon quand il perd le focus, comme aujourd'hui. » sort de l'interface et devient une annotation de maquette. Rien d'autre ne change sur 24.
  • Planche 26 : la zone d'outils suit U1 (EditableAnnotations.tsx, AnnotationCanvas.tsx, ToolColumn.tsx, EditorGlyph.tsx) : puces de vues (« Vue latérale gauche » active), ligne « Outil : sélectionner et déplacer · Échap annule un tracé », étiquette « Sélection : point « … » », colonne verticale de boutons de 44 px en icônes (Sélectionner et déplacer, actif ; Point ; Zone ; Accès à une vue détaillée ; séparateur ; Zoom arrière ; Zoom avant ; Ajuster), noms accessibles = attribut title, puis le dessin, et sous lui les trois boutons d'ajout au clavier de U1 (« Ajouter un point », « Ajouter une zone », « Ajouter un accès », KeyboardAdd.tsx, chemin C7). Ce ne sont pas l'ancienne barre de texte : ils créent un élément au centre du cadre pour une saisie au clavier.
  • Planches 28 et 29 : les annotations disent que la date « Modifiée le … », le tri « Dernière modification » et la carte des cinq fiches les plus récentes montrent l'état après le checkpoint SQL (docs/development/V1-2-6_R3_SQL_CHECKPOINT.md). Avant lui, R3 offre la recherche et le tri par nom seuls, sans date, et la carte d'accueil liste les cinq premières fiches par nom, sans parler de « récent ».

Dernières corrections autorisées (2026-11-09), limitées au strict nécessaire ; 25, 27 et 30 restent identiques octet pour octet à a8c9b83 :

  • Planche 28 (A7) : la note de repli « Si la date reste celle de la fiche » est supprimée, ainsi que la ligne « Repli A7 » du tableau des libellés ; le point 6 donne la règle finale. Rien d'autre ne change sur 28.
  • Planche 26 (A6) : la note « Désélectionner » est complétée (focus sur la ligne si elle existe encore, sinon sur le dessin ; jamais de nouvelle sélection ; annonce « Aucune annotation sélectionnée. », EN « No annotation selected. »). La table Échap et le reste ne changent pas. La note gagne une ligne (17,39 px) : le cadre de l'éditeur passe de 800 à 782,609375 px et le dessin de 460 à 443 px, pour que la planche garde sa hauteur et que les planches suivantes gardent leur position dans la page de rendu.
  • Planche 24 A : la première référence, « Code rural… art. L. 243-3 », non citée, est ouverte avec « Supprimer » ; la liste montre quatre résultats puis une ligne « ⋮ 3 autres résultats en dessous » ; une note jaune sous la vignette oppose les deux cas (citée : ligne d'aide, planche 23 ; non citée : « Supprimer » et le dialogue de confirmation existant). La note est hors du cadre et la hauteur de la planche ne change pas.

impeccable detect

Lancé par le propriétaire : npx --offline impeccable@4.1.0 detect docs/design/v1-2-6-r0/maquettes.html. Résultat : 2 observations esthétiques.

  • overused-font : Inter. C'est le jeton de l'application --font-sans (apps/app/src/styles/tokens.css:25). Décision du propriétaire : garder Inter pour R0.
  • cream-palette : #ECE6DA. Ce n'est que le fond de présentation des maquettes (body et [data-board] de maquettes.html, planche-contact.html), repris des planches v1-2-6 validées ; le fond de l'application est --color-bg #fbf9f5 (tokens.css:2). Décision du propriétaire : ne pas changer la palette globale.

Les deux observations sont documentées, sans chercher zéro avertissement.

Nouvelle exécution après les corrections (2026-11-09, même commande, depuis le cache et sans réseau) : les deux mêmes observations, overused-font (Inter) et cream-palette (rgb(236, 230, 218) = #ECE6DA), code de sortie 2 ; aucune nouvelle observation. Conservées et documentées, conformément aux décisions du propriétaire. Troisième exécution après les trois dernières corrections (2026-11-09, maquettes.html modifié, même commande hors ligne) : les deux mêmes observations, code de sortie 2, aucune nouvelle. planche-contact.html n'a pas changé.

Validation graphique finale (2026-11-09)

Contre-vérification indépendante de clôture (vérificateur neuf, sur a8c9b83 et les six fichiers modifiés) : CONFORME sur les trois dernières corrections (28 A7, 26 A6, 24 A référence non citée cr-l243-3), l'écart de périmètre précédent (couvert par la clarification BDR-109 du contrat), les corrections déjà approuvées, l'identité des sources et des rendus (9 empreintes sur 9), les libellés, les jetons et le périmètre. Planches 25, 27 et 30 identiques depuis 45f1cce. Le propriétaire avait conditionné la clôture à ce verdict : les planches 23 à 30 sont la référence graphique validée des lots R1 à R4 (BDR-110) ; 28 et 29 montrent l'état après le checkpoint SQL.