diff --git a/docs/design/README.md b/docs/design/README.md index a0124473..2b21ebcb 100644 --- a/docs/design/README.md +++ b/docs/design/README.md @@ -136,7 +136,9 @@ owner-confirmed choices from the open ones; `ETUDE-TECHNIQUE.md` lists the prere `v1-2-6-constats/` (proposition de conception U2b, 2026-11-06; principe approuvé par le propriétaire le 2026-11-06, planches non validées graphiquement): boards 17-22, annotations ↔ findings complement; study and decisions F1-F22 `docs/development/V1-2-6_UX_FINDINGS_NAV.md`, boards shown with their decisions in its section 7.4. -`v1-2-6-r0/` (lot R0, proposal of 2026-11-09, NOT validated): boards 23-30 after the owner's first U1 trial (brief +`v1-2-6-r0/` (lot R0, 2026-11-09; owner graphic verdict the same day, BDR-109: direction APPROVED WITH THREE TARGETED +CORRECTIONS, boards 23, 24 and 26 corrected, 25, 27 and 30 approved as drawn, 28 and 29 approved for their state after +the SQL checkpoint of `docs/development/V1-2-6_R3_SQL_CHECKPOINT.md`; awaiting the final R0 checkpoint): boards 23-30 after the owner's first U1 trial (brief « V1-2.6 UX — Arbitrages du premier essai propriétaire », BDR-107): fifth tab « Références » with tiles, search and view-only sort; contextual references panel opened from a finding only (34 rem, slide); « Défaire » / « Refaire »; « Désélectionner » and the Escape priority; phone « Plus »; generic admin sheet list and home card; catalogue card in diff --git a/docs/design/v1-2-6-r0/23-references-onglet-desktop.png b/docs/design/v1-2-6-r0/23-references-onglet-desktop.png index 21aac7b5..4c261208 100644 Binary files a/docs/design/v1-2-6-r0/23-references-onglet-desktop.png and b/docs/design/v1-2-6-r0/23-references-onglet-desktop.png differ diff --git a/docs/design/v1-2-6-r0/24-references-recherche-tri.png b/docs/design/v1-2-6-r0/24-references-recherche-tri.png index a4db456f..842de7a7 100644 Binary files a/docs/design/v1-2-6-r0/24-references-recherche-tri.png and b/docs/design/v1-2-6-r0/24-references-recherche-tri.png differ diff --git a/docs/design/v1-2-6-r0/26-historique-deselection.png b/docs/design/v1-2-6-r0/26-historique-deselection.png index f9db682c..b4f99924 100644 Binary files a/docs/design/v1-2-6-r0/26-historique-deselection.png and b/docs/design/v1-2-6-r0/26-historique-deselection.png differ diff --git a/docs/design/v1-2-6-r0/28-liste-fiches-desktop.png b/docs/design/v1-2-6-r0/28-liste-fiches-desktop.png index a3b76798..37b64ebf 100644 Binary files a/docs/design/v1-2-6-r0/28-liste-fiches-desktop.png and b/docs/design/v1-2-6-r0/28-liste-fiches-desktop.png differ diff --git a/docs/design/v1-2-6-r0/29-liste-fiches-telephone-accueil.png b/docs/design/v1-2-6-r0/29-liste-fiches-telephone-accueil.png index 32e3f277..73bc91e7 100644 Binary files a/docs/design/v1-2-6-r0/29-liste-fiches-telephone-accueil.png and b/docs/design/v1-2-6-r0/29-liste-fiches-telephone-accueil.png differ diff --git a/docs/design/v1-2-6-r0/ARBITRAGES.md b/docs/design/v1-2-6-r0/ARBITRAGES.md index 9d6d77ba..cd5059e7 100644 --- a/docs/design/v1-2-6-r0/ARBITRAGES.md +++ b/docs/design/v1-2-6-r0/ARBITRAGES.md @@ -1,6 +1,7 @@ # Arbitrages A1 à A15 du lot R0 -État au 2026-11-09, après le brief « R0 — Décisions propriétaire et dernière validation graphique » (BDR-108). +État au 2026-11-09, après le brief « R0 — Décisions propriétaire et dernière validation graphique » (BDR-108) et le +verdict « R0 — Verdict de revue graphique propriétaire » (BDR-109) : les quinze arbitrages sont tranchés. Sources : `docs/development/V1-2-6_U1_CORRECTIONS.md` §6 (A1 à A10), `docs/development/TRIAL_STACK.md` §6 (A11 à A15), `docs/development/V1-2-6_R3_SQL_CHECKPOINT.md` (A7). Les planches citées sont celles de ce dossier. @@ -11,17 +12,17 @@ retenu une autre option que la recommandation), **Ouvert** (recommandation en at | # | Question | Recommandation exacte | Conséquences | Statut | |---|---|---|---|---| -| A1 | Flèches de réorganisation quand une recherche est active en ordre de la fiche | Masquées, comme le prévoit déjà le choix 10 du checkpoint U1 (déplacer parmi des références cachées est ambigu) ; une ligne d'aide les remplace : « Pour réorganiser, affichez l'ordre de la fiche sans recherche. » | « Monter » et « Descendre » n'apparaissent qu'en ordre de la fiche sans recherche (planches 23, 24 A). Un test vérifie leur absence dans les autres cas. | Ouvert | -| A2 | Plusieurs tuiles ouvertes ; durée de l'état ouvert, de la recherche et du tri | Plusieurs tuiles ouvertes à la fois ; état gardé tant que l'éditeur reste ouvert (onglet maintenu monté), remis à zéro à sa réouverture. | Rien n'est enregistré dans le document ni dans le navigateur. Revenir dans l'onglet retrouve la même vue ; rouvrir l'éditeur repart de l'ordre de la fiche, tuiles fermées. | Ouvert | +| A1 | Flèches de réorganisation quand une recherche est active en ordre de la fiche | Masquées, comme le prévoit déjà le choix 10 du checkpoint U1 (déplacer parmi des références cachées est ambigu) ; une ligne d'aide les remplace : « Pour réorganiser, affichez l'ordre de la fiche sans recherche. » | « Monter » et « Descendre » n'apparaissent qu'en ordre de la fiche sans recherche (planches 23, 24 A). Un test vérifie leur absence dans les autres cas. | **Ratifié** le 2026-11-09 (verdict graphique R0), selon la recommandation exacte | +| A2 | Plusieurs tuiles ouvertes ; durée de l'état ouvert, de la recherche et du tri | Plusieurs tuiles ouvertes à la fois ; état gardé tant que l'éditeur reste ouvert (onglet maintenu monté), remis à zéro à sa réouverture. | Rien n'est enregistré dans le document ni dans le navigateur. Revenir dans l'onglet retrouve la même vue ; rouvrir l'éditeur repart de l'ordre de la fiche, tuiles fermées. | **Ratifié** le 2026-11-09 (verdict graphique R0), selon la recommandation exacte | | A3 | Actions dans le volet d'un constat | « Modifier », « Retirer de ce constat », lignes « Aller à » ; ni ajout, ni réorganisation, ni « Supprimer » (toujours refusé par le cœur ici). « Tout afficher dans l'onglet Références » ouvre l'onglet, recherche et tri remis à zéro, focus sur son titre. | Planche 25. « Retirer de ce constat » est une modification ordinaire du document, comptée dans les modifications non enregistrées. | **Ratifié** : l'action retire seulement l'association de citation avec le constat, jamais la référence du document ; elle s'annule par l'historique de l'éditeur (« Défaire »). | -| A4 | Contenu d'une tuile fermée | Citation sur deux lignes au plus, type, « Citée N fois » ou « Non citée ». | Le nombre compte les familles et les constats qui citent, comme aujourd'hui (`citations.ts`) ; la tuile ouverte nomme une famille comme famille (planche 23). | Ouvert | +| A4 | Contenu d'une tuile fermée | Citation sur deux lignes au plus, type, « Citée N fois » ou « Non citée ». | Le nombre compte les familles et les constats qui citent, comme aujourd'hui (`citations.ts`) ; la tuile ouverte nomme une famille comme famille (planche 23). | **Ratifié** le 2026-11-09 (verdict graphique R0), selon la recommandation exacte | ## Historique et désélection (lot R1) | # | Question | Recommandation exacte | Conséquences | Statut | |---|---|---|---|---| -| A5 | Priorité de la touche Échap | Dialogue ouvert, puis menu ouvert, puis volet contextuel, puis tracé en cours, puis sélection. | Un seul appui ne fait qu'une chose ; la désélection ne vient qu'en dernier (planche 26). Chaque consommateur marque la touche comme traitée. | Ouvert (ordre conforme au brief) | -| A5b | « Toutes les annotations » désélectionne déjà | Garder les deux : « Désélectionner » est là où se porte le regard après une action sur l'annotation ; l'entrée du haut garde son rôle de retour à la liste. Autre option : renommer l'entrée du haut. | Deux commandes produisent le même état ; aucune ne modifie le document ni l'historique. | Ouvert | +| A5 | Priorité de la touche Échap | Dialogue ouvert, puis menu ouvert, puis volet contextuel, puis tracé en cours, puis sélection. | Un seul appui ne fait qu'une chose ; la désélection ne vient qu'en dernier (planche 26). Chaque consommateur marque la touche comme traitée. | **Ratifié** le 2026-11-09 (verdict graphique R0), selon la recommandation exacte | +| A5b | « Toutes les annotations » désélectionne déjà | Garder les deux : « Désélectionner » est là où se porte le regard après une action sur l'annotation ; l'entrée du haut garde son rôle de retour à la liste. Autre option : renommer l'entrée du haut. | Deux commandes produisent le même état ; aucune ne modifie le document ni l'historique. | **Ratifié** le 2026-11-09 (verdict graphique R0), selon la recommandation exacte (les deux commandes gardées) | | A6 | Focus après « Désélectionner » | La ligne de l'annotation dans la liste, comme « Toutes les annotations » aujourd'hui. | Le bouton disparaît avec la sélection : le focus ne doit pas tomber sur la page. | **Ratifié avec précision** : la ligne de l'annotation si elle existe encore, sinon le dessin ; le retour du focus ne recrée aucune sélection ; une annonce accessible signale la désélection. | ## Liste des fiches (lot R3) @@ -29,28 +30,30 @@ retenu une autre option que la recommandation), **Ouvert** (recommandation en at | # | Question | Recommandation exacte | Conséquences | Statut | |---|---|---|---|---| | A7 | Source de la date de dernière modification | Une modification SQL en lecture seule, `last_modified_at` (la plus récente des dates de la fiche et de ses versions), avec son propre checkpoint. | La date actuelle de la liste ne bouge pas quand un brouillon est enregistré (28 fiches sur 219 dans la sandbox). Sans la modification SQL, pas de vraie date. | **Ratifié** : checkpoint SQL dédié (`V1-2-6_R3_SQL_CHECKPOINT.md`). En attendant : aucune date de création présentée comme date de modification, aucun tri trompeur. R3 livre d'abord la recherche et le tri par nom, puis la date et le tri par date après le checkpoint. | -| A8 | Format de la date | Absolu : « 9 nov. 2026, 12:06 » (EN « 9 Nov 2026, 12:06 »). | Lisible sans calcul ; pas de date relative qui vieillit dans une capture. | Ouvert (dépend de A7) | -| A9 | Carte « Fiches officielles » de l'accueil Administration | Les cinq fiches modifiées le plus récemment, avec espèce, badges et ligne de version de la liste, puis « Voir les N fiches ». | Dépend de A7. Avant le checkpoint SQL, la carte ne prétend pas montrer les plus récentes (les cinq premières par nom, sans date). | Ouvert (dépend de A7) | +| A8 | Format de la date | Absolu : « 9 nov. 2026, 12:06 » (EN « 9 Nov 2026, 12:06 »). | Lisible sans calcul ; pas de date relative qui vieillit dans une capture. | **Ratifié** le 2026-11-09 (verdict graphique R0), selon la recommandation exacte ; affiché seulement après le checkpoint SQL (A7) | +| A9 | Carte « Fiches officielles » de l'accueil Administration | Les cinq fiches modifiées le plus récemment, avec espèce, badges et ligne de version de la liste, puis « Voir les N fiches ». | Dépend de A7. Avant le checkpoint SQL, la carte ne prétend pas montrer les plus récentes (les cinq premières par nom, sans date). | **Ratifié** le 2026-11-09 (verdict graphique R0), selon la recommandation exacte ; état final après le checkpoint SQL (A7), avant lui les cinq premières par nom sans date | ## Catalogue (lot R4) | # | Question | Recommandation exacte | Conséquences | Statut | |---|---|---|---|---| -| A10 | Texte de l'avertissement dans la carte | FR « Contrôle d'intégrité échoué : cette version ne peut pas être affichée. » ; un échec de chargement d'une autre nature a sa propre ligne et « Réessayer » (planche 30). | La carte reste dans la liste et « Consulter » reste disponible ; la page de la fiche garde son message actuel. | R4 **accepté** comme correctif indépendant d'affichage, sans modification du contrôle d'empreinte ; texte ouvert | +| A10 | Texte de l'avertissement dans la carte | FR « Contrôle d'intégrité échoué : cette version ne peut pas être affichée. » ; un échec de chargement d'une autre nature a sa propre ligne et « Réessayer » (planche 30). | La carte reste dans la liste et « Consulter » reste disponible ; la page de la fiche garde son message actuel. | R4 **accepté** comme correctif indépendant ; texte **ratifié** le 2026-11-09 selon la recommandation exacte | ## Pile d'essai (`TRIAL_STACK.md`) | # | Question | Recommandation exacte | Conséquences | Statut | |---|---|---|---|---| -| A11 | Nom de commande, préfixe, ports | `pnpm db:trial`, conteneurs `faunosteo_trial_*`, ports 58432, 58999, 58300, 58500, 58025, 58801 sur 127.0.0.1 et 5194 pour l'application. | Aucun nom ni port partagé avec la sandbox (57xxx, 5191 à 5193) ou DEV (54321 à 54324). | **Ratifié** pour `pnpm db:trial` ; préfixe et ports ouverts | +| A11 | Nom de commande, préfixe, ports | `pnpm db:trial`, conteneurs `faunosteo_trial_*`, ports 58432, 58999, 58300, 58500, 58025, 58801 sur 127.0.0.1 et 5194 pour l'application. | Aucun nom ni port partagé avec la sandbox (57xxx, 5191 à 5193) ou DEV (54321 à 54324). | **Ratifié** : `pnpm db:trial`, préfixe et ports selon la recommandation exacte | | A12 | Sort des commandes `db:sandbox trial`, `trial-account`, `trial-grant` | Les retirer une fois la pile d'essai validée. | Deux chemins d'essai coexistent tant qu'elles restent. | **Décidé autrement** : conservées provisoirement, ni supprimées ni redirigées en silence | -| A13 | Comptes d'essai | Un compte `admin` avec les habilitations du catalogue, `owner` seulement si l'écran des droits est essayé. | Voir ci-contre. | **Décidé** : deux comptes, un compte propriétaire et administrateur pour les essais d'administration, un compte praticien avec les habilitations d'édition. Point à confirmer : la règle O1 n'active `sheet_editor` que pour un administrateur de la plateforme ; le compte praticien doit donc aussi avoir le rôle `admin` pour éditer. | -| A14 | Durée des clés et renouvellement des secrets | Clés valables un an, commande `rotate-keys`. | Les clés de 30 jours de la sandbox bloqueraient une pile persistante au bout d'un mois. | Renouvellement **ratifié** (`rotate-keys` et `rotate-secrets`) ; durée d'un an ouverte | -| A15 | Sauvegarde avant chaque `migrate` | Automatique, gardée dans le dossier d'état, jamais supprimée sans le propriétaire. | Une migration ratée se rattrape sans recréer la pile. | Ouvert (préservation des volumes ratifiée) | +| A13 | Comptes d'essai | Un compte `admin` avec les habilitations du catalogue, `owner` seulement si l'écran des droits est essayé. | Voir ci-contre. | **Décidé** (2026-11-09) : deux comptes distincts. Propriétaire et administrateur pour l'administration ; praticien avec le rôle `admin` technique et `sheet_editor`, sans `owner`, sans relecture ni publication. Ce n'est pas un profil praticien de production ; la règle O1 reste inchangée. | +| A14 | Durée des clés et renouvellement des secrets | Clés valables un an, commande `rotate-keys`. | Les clés de 30 jours de la sandbox bloqueraient une pile persistante au bout d'un mois. | **Décidé** (2026-11-09) : clés valables un an dans la pile locale dédiée, rotation documentée (`rotate-keys`, `rotate-secrets`), aucun secret dans Git ni dans les journaux, revue de sécurité du renouvellement avant sa mise en service | +| A15 | Sauvegarde avant chaque `migrate` | Automatique, gardée dans le dossier d'état, jamais supprimée sans le propriétaire. | Une migration ratée se rattrape sans recréer la pile. | **Ratifié** le 2026-11-09 (verdict graphique R0), selon la recommandation exacte | ## Autres décisions du 2026-11-09 - Les corrections des empreintes fictives (anomalie A) et du nettoyage des copies de travail (anomalie B) restent des chantiers indépendants. -- Les planches 23 à 30 : direction fonctionnelle approuvée, rendu graphique en attente de validation. +- Les planches 23 à 30 : direction graphique approuvée avec trois corrections ciblées (23, 24, 26) et des annotations + précisées sur 28 et 29 ; 25, 27 et 30 approuvées telles quelles. +- Le checkpoint SQL `last_modified_at` : conception acceptée, aucune migration créée ni appliquée pour l'instant. - Aucun lot (R1 à R4), ni U2, ni U2b n'est commencé. diff --git a/docs/design/v1-2-6-r0/REVUE.md b/docs/design/v1-2-6-r0/REVUE.md index 27594638..22bbc8dc 100644 --- a/docs/design/v1-2-6-r0/REVUE.md +++ b/docs/design/v1-2-6-r0/REVUE.md @@ -7,10 +7,10 @@ telle qu'elle est construite. Aucun code d'interface n'est modifié avant leur v | 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 » | +| `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 ; 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 | +| `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 | @@ -69,6 +69,7 @@ puis la même commande sur `planche-contact.html` ; le fichier `all.png` produit | 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 | +| 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 | @@ -95,6 +96,10 @@ Libellés repris du code sans changement : « Nouvelle référence », « Ajoute 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 (note jaune de la planche 23). - 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 @@ -140,7 +145,7 @@ Libellés repris du code sans changement : « Nouvelle référence », « Ajoute ## 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é. +- `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 @@ -163,4 +168,47 @@ toucher aux planches : 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. +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 ». + +## 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. diff --git a/docs/design/v1-2-6-r0/maquettes.html b/docs/design/v1-2-6-r0/maquettes.html index cfa4c22c..e9283e8d 100644 --- a/docs/design/v1-2-6-r0/maquettes.html +++ b/docs/design/v1-2-6-r0/maquettes.html @@ -452,12 +452,17 @@ function tile(r, o = {}) { const dl = `
Type
${TYPE[r.type]}
DOI
${r.doi ? ext(r.doi) : 'Aucun'}
URL
${r.url ? ext(r.url) : 'Aucune'}
` let actions = '' if (!o.ro) { - actions = `
${ico('pen', 'sm')}Modifier${o.panel ? `${ico('minus', 'sm')}Retirer de ce constat` : `${ico('trash', 'sm')}Supprimer`}` + // The core refuses deleting a cited reference: no « Supprimer » while it is cited, a hint instead. + const del = o.panel ? `${ico('minus', 'sm')}Retirer de ce constat` + : r.cited ? '' : `${ico('trash', 'sm')}Supprimer` + actions = `
${ico('pen', 'sm')}Modifier${del}` if (o.move) actions += `${ico('up', 'sm')}Monter${ico('down', 'sm')}Descendre` actions += '
' } - return `
${head}
${dl}${citedRows(r, o)}${actions}
` + const delHint = !o.ro && !o.panel && r.cited ? DELETE_HINT : '' + return `
${head}
${dl}${citedRows(r, o)}${actions}${delHint}
` } +const DELETE_HINT = `
${ico('info', 'sm')}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.
` function searchBox(o = {}) { const h = o.ph ? 'height:44px;' : '' const inner = o.q @@ -495,9 +500,12 @@ const ROW_MORE = (txt) => `
${txt}
`
${ROW_MORE(`⋮ ${pl(at - 2, 'référence', 'références')} au-dessus (liste défilée)`)}${part.map((r) => tile(r, { open: r === OPEN || r.id === 'jakel-2011', move: true })).join('')}${ROW_MORE(`⋮ ${pl(list.length - at - 3, 'référence', 'références')} en dessous`)}
` - document.getElementById('b23').innerHTML = editor({ tab: 'Références', h: 1090, body }) + document.getElementById('b23').innerHTML = editor({ tab: 'Références', h: 1012, body }) + `
${note(`Tuiles : fermée = citation sur deux lignes au plus (coupée), type, « Citée N fois » (libellé actuel, familles comprises) ou « Non citée ». Ouverte = citation entière, type, DOI et URL (liens externes, nouvel onglet), constats et familles qui la citent (une famille porte la marque « famille ») avec « Aller à », actions. L'en-tête de tuile est un bouton (aria-expanded) de 44 px ; plusieurs tuiles peuvent rester ouvertes. Comptes calculés comme citations.ts (familles et constats à toute profondeur) : ${DOC.citations} citations, ${UNCITED} références non citées sur ${REFS.length}. Ici deux tuiles ouvertes : « Jäkel… », citée par une famille seulement, et « ${short(OPEN.citation.split('.')[0])} », ${OPEN.index + 1}e de la fiche (liste défilée).`, 'flex:1')} - ${note(`Tri : « Ordre de la fiche » par défaut, puis « Citation (A → Z) », « Nombre de citations » (décroissant), « Type » ; à égalité, l'ordre de la fiche. Liste native (select) avec son étiquette « Trier par », focus clavier montré. Le tri ne modifie jamais le document. « Monter » / « Descendre » n'existent qu'en ordre de la fiche sans recherche (une modification chacun, annulable). « Supprimer » une référence citée reste refusé par le cœur (dialogue existant qui liste les constats). En-tête : plus de bouton « Références » ; « Défaire » / « Refaire ». La recherche est vide : le bouton « Effacer la recherche » apparaît dès la saisie (planche 24). « Ajouter une référence » : en mode édition sur toute vue de l'onglet (planche 24 E). Les lignes jaunes « ⋮ … » sont des annotations de la planche, pas du texte d'interface.`, 'flex:1')}
` + ${note(`Tri : « Ordre de la fiche » par défaut, puis « Citation (A → Z) », « Nombre de citations » (décroissant), « Type » ; à égalité, l'ordre de la fiche. Liste native (select) avec son étiquette « Trier par », focus clavier montré. Le tri ne modifie jamais le document. « Monter » / « Descendre » n'existent qu'en ordre de la fiche sans recherche (une modification chacun, annulable). « Supprimer » n'apparaît pas sur une référence citée (le cœur refuserait) : une ligne d'aide explique comment retirer ses citations d'abord. En-tête : plus de bouton « Références » ; « Défaire » / « Refaire ». La recherche est vide : le bouton « Effacer la recherche » apparaît dès la saisie (planche 24). « Ajouter une référence » : en mode édition sur toute vue de l'onglet (planche 24 E). Les lignes jaunes « ⋮ … » sont des annotations de la planche, pas du texte d'interface.`, 'flex:1')} + +
${note('Suppression : les deux tuiles ouvertes sont citées (Jäkel par une famille, White SA par trois constats) : pas de « Supprimer », la ligne d\'aide le remplace. Une référence non citée (« Non citée ») garde « Supprimer » dans sa tuile ouverte, avec le dialogue de confirmation existant.')}
` } @@ -530,7 +538,7 @@ const ROW_MORE = (txt) => `
${txt}
`
${ED.citation}
${ED.url}
${citedRows(ED)} -
TerminerChaque champ s'applique au brouillon quand il perd le focus, comme aujourd'hui.
` +
TerminerChaque champ s'applique au brouillon quand il perd le focus, comme aujourd'hui.
` const d = `
D. Modification en cours : rien n'est perdu en changeant d'onglet (vue recadrée)
${vframe(640, 740, `
${saveLine({ unsaved: '2 modifications non enregistrées' })}
${TABS.map((t) => `${t}`).join('')}
@@ -621,7 +629,17 @@ const ROW_MORE = (txt) => `
${txt}
`
${[['Centre x', STIFLE.g[1]], ['Centre y', STIFLE.g[2]], ['Rayon', STIFLE.g[3]]].map(([l, v]) => `
${l}${v}
`).join('')}
${o.ro ? '' : 'Marquer comme relu'}
${ico('deselect', 'sm')}Désélectionner${o.ro ? '' : `${ico('trash', 'sm')}Supprimer`}
` - const stage = `
${toolbar('sel')}
${drawing({ w: 640, h: 560, extra: (u) => ring(STIFLE, u) })}${zoom('Ajusté')}
` + // U1 as built (EditableAnnotations CanvasColumn, AnnotationCanvas, ToolColumn, EditorGlyph): view chips, tool hint, + // selection tag, the icon-only tool column (44 px, aria-label = title) beside the canvas, the keyboard add buttons. + const G = { select: 'M5 3l12 7-5 1-3 5z', point: 'M12 8a4 4 0 1 0 0 8 4 4 0 0 0 0-8zM12 3v3M12 18v3M3 12h3M18 12h3', zone: 'M12 3l8 6-3 10H7L4 9z', link: 'M4 4h8v8H4zM12 12h8v8h-8z', out: 'M5 11h12M20 20l-4-4', in: 'M11 5v12M5 11h12M20 20l-4-4', fit: 'M4 9V4h5M20 9V4h-5M4 15v5h5M20 15v5h-5' } + const glyph = (k) => `` + const tb = (k, label, on) => `${glyph(k)}` + const toolCol = `
${tb('select', 'Sélectionner et déplacer', true)}${tb('point', 'Point')}${tb('zone', 'Zone')}${tb('link', 'Accès à une vue détaillée')}
${tb('out', 'Zoom arrière')}${tb('in', 'Zoom avant')}${tb('fit', 'Ajuster')}
` + const chips = `
${DOC.views.map((v, i) => `${v.fr}`).join('')}
` + const stage = `
${chips}
Outil : sélectionner et déplacer · Échap annule un tracé
+ Sélection : point « ${STIFLE.fr} » +
${toolCol}
${drawing({ w: 580, h: 460, extra: (u) => ring(STIFLE, u) })}
+
Ajouter un pointAjouter une zoneAjouter un accès
` const main = editor({ tab: 'Annotations', tip: true, body: stage + `
${props()}
` }) const dialog = `
A. Dialogue de confirmation : son « Annuler » ferme le dialogue sans rien faire
@@ -734,6 +752,7 @@ function sheetSearch(q, o = {}) { + `
${inset}${empty}
${note('Recherche : instantanée, sur le nom de la fiche seulement, sans accents ni casse (comme le catalogue). « Effacer la recherche » vide le champ et y rend le focus. Elle se combine aux quatre filtres existants.')} ${note('Tri : « Dernière modification » (récente d\'abord, défaut) ou « Nom » (A → Z, ordre alphabétique français). Date : voir le point soumis sur sa source (la date actuelle de la liste ignore les enregistrements de brouillon).')} + ${note('Après le checkpoint SQL seulement (docs/development/V1-2-6_R3_SQL_CHECKPOINT.md) : la date « Modifiée le … » et le tri « Dernière modification » montrent l\'état qui suit ce checkpoint. Avant lui, R3 propose la recherche et le tri par nom seuls, sans date.')} ${note('Si la date reste celle de la fiche (A7, approximation) : la ligne dit « Fiche modifiée le 9 nov. 2026, 12:06 » et la carte d\'accueil « Fiches modifiées récemment » ; avec la lecture SQL, « Modifiée le … » et « Dernières modifications », comme dessiné.')} ${note('Sans résultat : la phrase nomme la recherche (« Aucune fiche ne contient « mulet » dans son nom. ») ; si des filtres sont aussi actifs, la phrase existante « Aucune fiche ne correspond à ces filtres. » reste. Aucun surlignage du texte trouvé.')} ${note('Générique : aucune section « fiches historiques », aucun filtre de test. « Fiche historique » et « Copie de travail » restent les badges actuels, venus des indicateurs du serveur ; ces fiches sont des lignes ordinaires. Lignes, versions et dates : mise en scène (REVUE.md).')}
` @@ -768,7 +787,8 @@ function sheetSearch(q, o = {}) {
${card}
${entry('Espèces', 'Espèces du catalogue, actives ou non.')}${entry('Accès et habilitations', 'Accès au catalogue et habilitations : attribution, échéance, révocation.')}
` }) document.getElementById('b29').innerHTML = phone + `
B. Accueil Administration (1 280 px)
${home}
${note('Carte : les cinq fiches modifiées le plus récemment (même tri et même date que la liste), avec les badges et la ligne de détail de la liste (espèce, état, versions, revue), sans nouveau badge, et la date ; lien « Voir les 12 fiches » vers la liste. Une fiche historique qui entre dans les cinq garde son action « Créer une copie de travail » sous sa ligne, comme aujourd\'hui.', 'flex:1')} - ${note('Téléphone : filtres empilés comme aujourd\'hui (une colonne sous 640 px), cibles de 44 px, la date passe sur sa propre ligne. Données de mise en scène.', 'flex:1')}
` + ${note('Téléphone : filtres empilés comme aujourd\'hui (une colonne sous 640 px), cibles de 44 px, la date passe sur sa propre ligne. Données de mise en scène.', 'flex:1')} + ${note('Après le checkpoint SQL seulement (docs/development/V1-2-6_R3_SQL_CHECKPOINT.md) : la date, le tri « Dernière modification » et les cinq fiches « les plus récentes » de la carte montrent l\'état qui suit ce checkpoint. Avant lui, la liste offre la recherche et le tri par nom sans date, et la carte liste les cinq premières fiches par nom, sans parler de « récent ».', 'flex:1')}
` } diff --git a/docs/design/v1-2-6-r0/planche-contact.png b/docs/design/v1-2-6-r0/planche-contact.png index 42bd8175..832e8e12 100644 Binary files a/docs/design/v1-2-6-r0/planche-contact.png and b/docs/design/v1-2-6-r0/planche-contact.png differ diff --git a/docs/development/TRIAL_STACK.md b/docs/development/TRIAL_STACK.md index 3f3318c9..41e2beb9 100644 --- a/docs/development/TRIAL_STACK.md +++ b/docs/development/TRIAL_STACK.md @@ -1,7 +1,8 @@ # Dedicated manual trial stack: technical plan Status: PROPOSAL, 2026-11-09 (owner brief « V1-2.6 UX — Arbitrages du premier essai propriétaire », §5), with the -decisions of the brief « R0 — Décisions propriétaire et dernière validation graphique » (2026-11-09, BDR-108): name +decisions of the briefs « R0 — Décisions propriétaire et dernière validation graphique » (BDR-108) and « R0 — Verdict +de revue graphique propriétaire » (BDR-109), both 2026-11-09: name `pnpm db:trial`, two trial accounts, `db:sandbox trial*` kept for now, isolation from the suites, volumes preserved, resources capped, secrets renewable. Plan only: no stack is created, started, reset or removed, no script changes, existing data untouched. Implementation @@ -67,7 +68,10 @@ keys with the same secret and restarts the services: a persistent stack with the itself out after a month. Full renewal (owner 2026-11-09) is `rotate-secrets`: a new JWT secret and new keys, new role passwords set in the database (`alter role … password`, values through psql variables, never argv), env files rewritten (600), services restarted in order, the previous secrets file kept as `secrets.prev.sh` (600) until the -stack answers; account passwords are untouched. Both commands print no secret. Since every secret differs from the sandbox's, a suite that reached a trial port by mistake +stack answers; account passwords are untouched. Both commands print no secret. Rules (A14, decided 2026-11-09): keys valid one year on this dedicated local stack +only; no secret in Git, in a command line, in the script's output or in a log (the state folder sits outside the +repository and the script refuses one inside it); the rotation procedure is written in the script's help and in +`SUPABASE.md`; the renewal code gets a security review (fresh security gate) before the stack is used. Since every secret differs from the sandbox's, a suite that reached a trial port by mistake would be refused by GoTrue, PostgREST and Postgres instead of writing. ### 3.4 Persistence and lifecycle @@ -94,10 +98,12 @@ would be refused by GoTrue, PostgREST and Postgres instead of writing. (`db-sandbox.sh:457-472`); `grant ` as `cmd_trial_grant` (:476-496). 1. Owner/admin account, for the administration trials: platform roles `owner` and `admin`, catalogue rights `sheet_editor`, `sheet_reviewer`, `sheet_publisher`. - 2. Practitioner account, for the normal journey: `sheet_editor` only, no `owner`, no reviewer or publisher right. - Fact to weigh: today a `sheet_editor` right is active only for a platform admin (rule O1, - `supabase/migrations/20261028100000_sheet_access_hardening.sql:199`), so this account also needs the `admin` - role; without it, it can read the catalogue (`catalog_reader`) but not edit. Changing O1 is out of scope. + 2. Practitioner account, for the normal journey (decided 2026-11-09, A13): technical platform role `admin` and the + catalogue right `sheet_editor`; no `owner`, no `sheet_reviewer`, no `sheet_publisher`. The `admin` role is there + only because rule O1 activates `sheet_editor` for a platform admin alone + (`supabase/migrations/20261028100000_sheet_access_hardening.sql:199`); O1 is not changed. This is a trial + account, not a production practitioner profile: a production practitioner holds neither `admin` nor a catalogue + editing right by default. Editing and Administration require a TOTP factor (aal2, same file :321-341), enrolled in Mon compte by each account. - The equine sheet: the seed gives the historical sheet its fixed id and `private.historical_sheet_id()` flags it (`20261102100000_sheet_admin_reads.sql:56`); it is the only official sheet at creation. @@ -143,8 +149,8 @@ they created; `shellcheck` on both scripts. | # | Question | Recommendation | |---|---|---| -| A11 | Command name, prefix, ports | `pnpm db:trial` (RATIFIED), `faunosteo_trial_`, 58xxx and 5194 as in 3.2 (open). | +| A11 | Command name, prefix, ports | RATIFIED: `pnpm db:trial`, `faunosteo_trial_`, 58xxx and 5194 as in 3.2. | | A12 | Fate of `pnpm db:sandbox trial`, `trial-account`, `trial-grant` | DECIDED: kept for now, neither removed nor silently redirected. | -| A13 | Trial accounts | DECIDED: two accounts (3.5). Open: confirm the practitioner account takes `admin` because of O1. | -| A14 | Key lifetime and renewal | Renewal DECIDED (`rotate-keys`, `rotate-secrets`); one-year lifetime open. | -| A15 | Backup before every `migrate` | Automatic, kept in the state folder, never pruned without the owner. | +| A13 | Trial accounts | DECIDED: two accounts (3.5); practitioner = technical `admin` + `sheet_editor`, not a production profile; O1 unchanged. | +| A14 | Key lifetime and renewal | DECIDED: one year, documented rotation, no secret in Git or logs, security review of the renewal (3.3). | +| A15 | Backup before every `migrate` | RATIFIED: automatic, kept in the state folder, never pruned without the owner. | diff --git a/docs/development/V1-2-6_R3_SQL_CHECKPOINT.md b/docs/development/V1-2-6_R3_SQL_CHECKPOINT.md index bf3b8d97..90efee02 100644 --- a/docs/development/V1-2-6_R3_SQL_CHECKPOINT.md +++ b/docs/development/V1-2-6_R3_SQL_CHECKPOINT.md @@ -1,8 +1,9 @@ # R3 SQL checkpoint: a true last-modification date for the sheet list -Status: PROPOSAL for the owner's dedicated SQL checkpoint, 2026-11-09 (brief « R0 — Décisions propriétaire et -dernière validation graphique », A7). Nothing here is written as a migration; no SQL, application, script or sandbox -change before the owner authorises this checkpoint. Companion of `V1-2-6_U1_CORRECTIONS.md` (lot R3). +Status: DESIGN ACCEPTED by the owner, 2026-11-09 (verdict « R0 — Verdict de revue graphique propriétaire », BDR-109), +after the brief « R0 — Décisions propriétaire et dernière validation graphique » (A7). No migration is created or +applied for now; writing and applying it needs the owner's later go. R3 keeps its split before and after this +checkpoint (section 5). Companion of `V1-2-6_U1_CORRECTIONS.md` (lot R3). ## 1. The problem diff --git a/docs/development/V1-2-6_U1_CORRECTIONS.md b/docs/development/V1-2-6_U1_CORRECTIONS.md index e3d4b6cf..0012c003 100644 --- a/docs/development/V1-2-6_U1_CORRECTIONS.md +++ b/docs/development/V1-2-6_U1_CORRECTIONS.md @@ -86,6 +86,9 @@ reference of R1 to R4. button per tile (`aria-expanded`, `aria-controls`), the toolbar with a search field and its explicit clear button (focus back to the field), a native `