Files
faunosteo/docs/design/v1-2-4/REVUE.md
T
bchanot 98e8403f8b docs(docs): V1-2.4 maquettes G1/G2 corrections and review dossier
Board 06 drops a warning the core cannot raise, board 12 leaves « Mark as reviewed » to arbitrate and states the real fingerprint and verdict_refused behaviour. Adds the contact sheet and REVUE.md. Still a proposal, no graphic approval.
2026-11-02 12:44:16 +01:00

21 KiB
Raw Blame History

V1-2.4 · Revue graphique des maquettes

Branche feature/v1-2-anatomical-sheets. Proposition non validée : le propriétaire n'a pas encore validé visuellement les douze planches, et ce dossier n'est pas une approbation graphique.

Les planches sont celles de a15c35c, avec les corrections G1 et G2 autorisées par le propriétaire le 2026-11-02. Seules 06 et 12 ont été régénérées. Les dix autres PNG sont identiques octet pour octet à a15c35c.

Contenu du dossier

Dans le dépôt (docs/design/v1-2-4/) Dans l'archive de revue (zip transmis hors du dépôt) Rôle
planche-contact.png planche-contact.png Les douze planches réduites, dans l'ordre du parcours, avec numéro et titre
01-…png à 12-…png maquettes/ Les planches en pleine résolution
maquettes.html, render.cjs source/docs/design/v1-2-4/ Source des planches et son outil de rendu. Dans l'archive, le logo et le dessin du cheval sont rangés aux mêmes chemins relatifs, la page s'ouvre telle quelle
planche-contact.html source/docs/design/v1-2-4/ Source de la planche-contact
REVUE.md REVUE.md Ce rapport
index.html, SHA256SUMS Page de consultation hors ligne, empreintes de l'archive

Ordre du parcours : 01, 02, 03 (catalogue), 10, 11 (entrée Administration), 04, 05 (édition), 06 (vérification), 07, 09 (revue), 08 (publication), 12 (libellés).

Corrections appliquées (brief du propriétaire du 2026-11-02)

Seuls des textes de maquettes.html ont changé. Aucun code d'erreur, aucune règle et aucun mécanisme n'a été modifié.

# Planche Avant Après
G1 06 A Encadré « Repère proche du bord du cadre. Point « Grasset droit ». » et badge « 1 avertissement » Retirés tous les deux : le badge ne comptait que cet avertissement. Le cœur n'a que deux avertissements, annotation.no_findings et finding_zone.unreferenced (crates/core/src/domain/sheet/validate.rs:376, :451) ; la règle du cadre est une erreur. Aucune règle ajoutée
G2 12 Ligne « Marquage d'un élément », statut « ratifié (§3, §6.6, §8.2) » « statuts ratifiés (§3, §6.6) ; action : FR du contrat (§8.2), EN « Mark as reviewed » à arbitrer »
Message 12 verification.integrity.fingerprint : « L'empreinte de la fiche ne correspond pas. » / « The sheet fingerprint does not match. » « L'empreinte de la fiche n'a pas pu être calculée. » / « The sheet fingerprint could not be computed. » Le cœur émet ce code quand le calcul échoue, sans comparer (verdict.rs:189, :207)
Message 12 verification.worker.verdict_refused : « …, l'incident est signalé. » / « …, the incident is reported. » « …, l'incident est enregistré. » / « …, the incident is logged. » Le worker écrit une ligne d'erreur (crates/worker/src/verify_job.rs:326) et la RPC garde le code sur la revue et dans l'audit ; rien n'alerte un opérateur

La légende de la planche 06 dans la planche-contact passe à 1 292 × 925 px (47 px de moins).

Note de rendu : régénérer toute la source modifie aussi 07 à 11 de quelques centaines de pixels d'anticrénelage (écart maximal de 27 sur 255 par canal, dimensions identiques). La planche 06 raccourcit et les suivantes remontent dans la page. Leur contenu ne change pas, donc les originaux ont été gardés.

Conformité au contrat

Contrat .claude/tasks/contracts/2026-11-02-v1-2-4-maquettes.md, critères M1 à M8.

  • Premier contrôle indépendant, sur a15c35c : ECARTS(2), G1 et G2, tous deux documentaires.
  • Contrôle indépendant après corrections : CONFORME sur les huit critères, aucun écart compté. Seul écart de présentation relevé : depuis G1, la planche 06 A ne montre plus d'exemple d'avertissement.
Critère Planches Preuve
M1 Identité 01-11 Couleurs et polices de tokens.css reprises valeur pour valeur, logo existant, ordre de la barre latérale de SidebarNav.tsx, tailles de Button et Card. Les deux nouvelles teintes (badge vert, encadré ambre) et les 13 icônes sont déclarées, pas ajoutées en silence
M2 Catalogue 01-03 Entrée propre, sans entrée Administration ni lien d'édition pour une praticienne sans habilitation ; « Ouvrir dans l'administration » pour un éditeur seulement ; versions publiées seules
M3 Éditeur 04, 06 A Les sept onglets, le canevas, les outils point, zone et accès à une vue détaillée, l'onglet Vérification avec erreurs et éléments à confirmer ; G1 corrigé
M4 Écran étroit 05 Badge « Lecture seule », encadré qui donne la raison (1 024 px), aucune action d'édition
M5 Revue 06 B-D, 07, 08, 09 Texte exact de §6.5 (« vérification en attente depuis N min »), tentatives, dernier code, issues failed et unavailable avec leur sortie, groupes et accusés reportés, décision à note obligatoire, confirmation avec version, révision, approbatrice, groupes lus, empreinte. Aucune planche ne propose de décision ou de publication sans verdict valide et à jour
M6 Administration 10, 11 Une seule entrée, bureau et tiroir ; indépendance entre visibilité et contrôle d'accès écrite sur la planche
M7 Libellés 12 Les 20 codes fermés, exactement ceux du cœur et de private.sheet_worker_codes ; identifiant distinct du message ; G2 corrigé, aucun libellé non arbitré présenté comme ratifié
M8 Livraison README Section v1-2-4/ marquée PROPOSITION, correspondance des huit points du brief, dossier de revue décrit

Non-conformités fonctionnelles

Aucune. Chaque action dessinée correspond à une habilitation de §5.2 et §5.5, chaque transition à §6.1.

Écarts de présentation acceptables

Aucun n'a été modifié : le brief n'autorise aucun autre changement graphique.

  • Planche 04 : la légende « ni redimensionnement ni glisser sur l'illustration (niveau 2) » vise les sommets (§8.3), mais lue seule elle contredit l'outil « sélectionner et déplacer » (§8.2). « ni glisser de sommet » lèverait l'ambiguïté.
  • Planche 04 : pas de champ « type » explicite dans le panneau (le titre « Zone » le porte) ; « Enregistrer » sans note de modification (§6.2).
  • Planche 05 : le badge « Copie de travail » de la planche 04 n'y apparaît pas ; à 768 px les onglets sont repliés sous « Plus » ; le texte dit « sur un ordinateur » quand une tablette en paysage peut suffire.
  • Planche 06 A : depuis G1, aucun avertissement n'est montré en exemple. Le compteur « N avertissements » reste documenté sur la planche 12.
  • Planche 09 : le téléphone de droite omet « Approuver » (désactivé sur la 07) et le lien d'aperçu praticien.
  • Planche 10 : la carte « Accès et habilitations », réservée au propriétaire, n'est décrite qu'en texte ; aucune planche ne montre la vue du propriétaire.
  • Planche 11 : le pied du tiroir n'a que « Se déconnecter », le tiroir actuel porte aussi le badge utilisateur.
  • Planche 12 : la colonne « Issue » met « indisponible » sur les cinq codes du worker. Trois sont transitoires (la revue reste en vérification, l'issue unavailable n'arrive qu'à la cinquième tentative) ; les messages le disent (« nouvelle tentative automatique »).
  • Éditeur dessiné à 1 280 px seulement ; refus d'approbation et de publication (verdict.*, publish.*, review.*, rights.*) reportés à V1-2.7, comme la planche l'indique.

Critères bloquants

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 :

  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.
  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).
  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.

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.

Statuts et états

# Emplacement FR proposé EN proposé Rôle Variante recommandée
L1 Badge de version (listes admin, fiche, versions antérieures du catalogue) et badge de revue « Retirée » (version deprecated, ratifié) et « Soumission retirée » (revue withdrawn, ratifié) « Withdrawn » et « Submission withdrawn » Distinguer une version sortie du catalogue d'une soumission annulée Garder les deux libellés ratifiés, avec une règle d'affichage : le badge d'une revue écrit toujours « Soumission retirée » en entier, jamais « Retirée ». Le même croisement existe en anglais, la même règle le résout
L2 Ligne d'un groupe non encore lu (planches 07, 09) « À lire » « To read » État d'un groupe à couvrir sans accusé de lecture « Non lu » / « Not read yet » : forme un couple net avec « Groupe lu ». « À lire » reste acceptable
L3 Bouton sur un groupe (planches 07, 09) « Marquer le groupe comme lu » « Mark the group as read » Enregistre l'accusé de lecture du relecteur pour ce groupe Garder : le mot « groupe » l'éloigne de « Marquer comme relu », l'action de l'éditeur sur un élément

Vérification par le serveur (O23)

# Emplacement FR proposé EN proposé Rôle Variante recommandée
L4 Titre de l'encadré, issue failed (planches 06 C, 09) « La fiche ne passe pas la vérification. » « The sheet fails verification. » Le contenu est en cause, l'éditeur corrige FR inchangé ; EN « The sheet did not pass verification. »
L5 Titre de l'encadré, issue unavailable (planche 06 D) « La vérification n'a pas pu aboutir. » + étiquette « indisponible » « Verification could not complete. » + « unavailable » Pas de verdict, le contenu n'est pas en cause Garder ; le badge d'état relève de la décision 5 ci-dessus
L6 Encadré d'attente (planches 06 B, 09) « Vérification en attente depuis N min » « Verification pending for N min » Texte exigé par §6.5 FR du contrat, à garder
L7 Même encadré « Tentative N sur 5 » « Attempt N of 5 » Montre la progression des reprises automatiques Garder
L8 Même encadré « Dernier incident » « Last incident » Précède le message et le code du dernier échec technique « Dernier incident technique » / « Last technical issue » : précise que le contenu n'est pas en cause

Accès, copie de travail, navigation

# 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
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

Écran étroit (§8.4)

# Emplacement FR proposé EN proposé Rôle Variante recommandée
L15 Encadré au-dessus du brouillon sous 1 024 px (planche 05) « L'édition demande un écran d'au moins 1 024 px de large. » + « Sur cet écran, consultation seule. » (la planche montre « Ici » à 375 px) « Editing needs a screen at least 1,024 px wide. On this screen, read-only. » Explique pourquoi rien n'est modifiable FR : « Sur cet écran, consultation seule. » aux deux largeurs, et « sur un écran plus large » au lieu de « sur un ordinateur ». EN : « Editing needs a screen at least 1,024 px wide. This screen is read-only. »
L16 Badge « Lecture seule » « Read-only » État de la page Garder

Actions

# Emplacement FR proposé EN proposé Rôle Variante recommandée
L17 Onglet Vérification, lien sur la revue « Prévisualiser (comme un praticien) » « Preview (as a practitioner) » Ouvre l'aperçu exact du praticien Bouton « Prévisualiser », lien « Voir comme un praticien » / « View as a practitioner »
L18 Onglet Vérification « Soumettre à la revue » « Submit for review » Ouvre une revue (A5) Garder
L19 Revue en cours, côté éditeur (planche 06 B) « Retirer la soumission » « Withdraw the submission » Annule la revue, dégèle le brouillon, note exigée EN « Withdraw submission »
L20 Issue en échec (planches 06 C, 06 D) « Reprendre le brouillon » « Back to the draft » Retour à l'éditeur pour corriger « Corriger le brouillon » / « Fix the draft » : dit ce que l'éditeur va faire
L21 Issue indisponible (planche 06 D) « Soumettre de nouveau » « Submit again » Nouvelle revue sur le même contenu Garder
L22 Panneau Décision (planches 07, 09) « Demander des modifications » « Request changes » Clôt la revue, note exigée Garder
L23 Panneau Décision « Approuver » « Approve » Clôt la revue en approbation, note exigée Garder
L24 Revue approuvée, puis titre du dialogue (planche 08) « Publier la version N » « Publish version N » Ouvre la confirmation de publication Garder
L25 Fiche du catalogue, pour un éditeur (planche 02) « Ouvrir dans l'administration » « Open in administration » Passage du catalogue à l'espace d'administration Garder
L26 Carte du catalogue (planche 01) « Consulter » « View » Ouvre la fiche publiée Garder
L31 Panneau de propriétés de l'éditeur (planche 04), arbre des constats « Marquer comme relu » (FR du contrat, §8.2) « Mark as reviewed » Passe un élément, une catégorie ou une zone de constats à reviewed (§6.6) Garder l'anglais proposé

Contrôle dans la page (onglet Vérification, planche 06 A)

# Emplacement FR proposé EN proposé Rôle Variante recommandée
L27 Titre de l'onglet et résultat sans problème « Vérification du brouillon » · « Vérification réussie » « Draft verification » · « Verification passed » Contrôle consultatif du cœur dans le navigateur « Contrôle du brouillon » · « Aucun problème détecté » / « Draft check » · « No issues found ». Le mot « Vérification » désigne déjà le verdict du serveur, seul à faire autorité (§6.4) ; le réutiliser pour le contrôle local laisse croire que la page a validé la fiche. L'onglet garde son nom « Vérification »
L28 Compteurs « N erreurs bloquantes » · « N avertissements » · « N éléments à confirmer » « N blocking errors » · « N warnings » · « N items to confirm » Résumé du contrôle Garder
L29 Étiquettes des problèmes « Contenu » · « Règle » « Content » · « Rule » Séparent les codes integrity des codes validation Garder
L30 Refus d'approbation et de publication (verdict.*, publish.*, review.*, rights.*) non maquetté non maquetté Un message par code (§3, §6.5) Reporté à V1-2.7, comme l'indique la planche

Messages des 20 codes fermés

Les 20 identifiants de la planche sont exactement ceux du cœur (15 codes de vérification, crates/core/src/domain/sheet/verdict.rs) et du SQL (5 codes du worker, private.sheet_worker_codes). Tous les messages restent des propositions à arbitrer, y compris les deux corrigés ci-dessus. Trois changements restent recommandés, non appliqués :

Code Message actuel FR / EN Problème Variante recommandée FR / EN
verification.integrity.object_conflict « Une illustration entre en conflit avec un fichier existant. » / « A drawing conflicts with an existing file. » Vague : le fichier stocké ne correspond pas à l'empreinte sha256 enregistrée (verdict.rs:422, §9.3) « Le fichier d'une illustration ne correspond pas à celui enregistré. » / « A drawing's stored file does not match its record. »
verification.integrity.size_mismatch « La taille d'une illustration ne correspond pas. » / « A drawing's size does not match. » Incomplet : à quoi ? « La taille d'une illustration diffère de celle enregistrée. » / « A drawing's size differs from its record. »
verification.validation.marker_too_small et marker_interior_too_small « … trop petit pour être touché. » / « … too small to tap. » Juste pour la règle (mesurée sur l'aperçu 320 × 568), mais « touché » surprend sur ordinateur « … pour être touché sur mobile. » / « … to tap on a phone. »

Empreintes SHA-256

Fichiers de docs/design/v1-2-4/ dans l'état de ce dossier. L'archive porte en plus son propre SHA256SUMS.

Fichier SHA-256
01-catalogue-desktop.png 631608e0713523128736805ff9d3428ae109e177225a51c1a3bcdac8339f90fc
02-fiche-desktop.png fbb3bf5d7fe1ab3044542b7864733481f3b2961ceb7a72fec508fad55ee63dab
03-fiche-mobile.png f37e49c38312df513f564a7676b9eb736774a289dd340d570b9b0760b6cde7be
04-editeur-desktop.png c8cc2a502c67c3b8e78474d3c2674acbb3a2b4bf74550ad35c99fce703072d4b
05-lecture-seule-etroit.png f6518b78456f1b393332ca6775c94ab93477ff23c325ba66745ac0f107b436cb
06-verification-etats.png 4e7e430b46a36e6741ef85c8238d705a490906bd145404d67bfd836178b052c0
07-revue-desktop.png 741abf2ed29db0b2d9be41a64feb3ef359921c2b1f2b6bb0bacb394c5eedc06e
08-revue-publication.png a042d3f2d5e0016e221bf43abdde189bae694f8e3001fbbe9b11ebe1afbdffe5
09-revue-mobile.png acfdd7cc224b8dcefe4c0fa07f9854fa628b7f512f3f377e17cb218687a9cafd
10-administration-desktop.png cbaaef3fec60fd5b57dafe04585b365db60bee378603451e194b9d62496afcfb
11-administration-mobile.png 3dbd828364e5c395fd9f76d910a101cd3436d6164befb7453905754cb1c90c01
12-libelles.png 1e129a2801e887deedf97ce34d6f97782386feaf2960fcb6c5596ef4803bf53f
planche-contact.png 5a442f8beeb47cfed5e1f1b4638718a76cbe73fbb7a1f865620f9edce85113e5
maquettes.html 21864dedcdc1a6aac08f893cbea435517fe9cf7aabadb251a0098d0374487f92
planche-contact.html 388c4b8d6fd90e43e8af6a99b70db786e67e70ac0f0fe2323ababf3ff7c03669
render.cjs f535631a0a357a29f5b189df3fba657d5e7568ba34b0b6fdecca350616abe1fc