docs(docs): V1-2.6 maquettes arbitrations, technical study, conformance result
This commit is contained in:
1 parent
9f420d329d
commit
d21ffcc5dc
4 files changed
+198
-1
No files matched your search
@@ -674,7 +674,7 @@ Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheet
|
||||
- [ ] V1-2.6 editor level 1: plan APPROVED by the owner 2026-11-03 (brief « GO propriétaire V1-2.6 »: 13 lots A-M, C1-C24, 8 visible choices, M8 sandbox only, no JSON export button, recovery messages exact), gated on a targeted independent re-check of the six FATAL fixes. Re-check 2026-11-03: REMAINING(2) — fixes 1-5 closed, I1-I5 hold; fix 6 (r = 12 + 3 %) opens `out_of_frame` on frames under ~25.5 units (hitbox r in frame bounds); I6 broken: the first commit overwrites a pending recovery copy before « Restaurer » / « Ignorer »; 2 MINOR (N source when the admin read fails, two-copy cap). Executor NOT launched; STOP for the owner. Owner arbitrations 2026-11-03 (« arbitrages propriétaire sur REMAINING(2) »): C25-C31 gated, plan revised; second targeted re-check: REMAINING(1), no BLOCKER, F1 MAJOR (accept trusted the core's silence on unmeasured views) + 7 MINOR, all integrated in the plan. Owner GO 2026-11-04 (« GO propriétaire après REMAINING(1) »): F1 fix approved, C26 refined by seven repair rules, minor effects approved; C32-C34 gated; execution of lots A-M authorised, no third plan review. 2026-11-04 13:08 the scratchpad worktree was removed by the harness cleanup (LRN-114): commits safe on origin (8343528), uncommitted lot H + lot G fix lost; worktree recreated at /home/bchanot/Documents/faunosteo-v1-2 (owner authorisation); resume ledger `.claude/tasks/plans/2026-11-03-v1-2-6-execution.md`. Contract `.claude/tasks/contracts/2026-11-03-v1-2-6-editor-1509.md`, plan `.claude/tasks/plans/2026-11-03-v1-2-6-editor.md`; sandbox only, no DEV, no worker on DEV, no merge, no V1-2.7; STOP at the V1-2.6 owner checkpoint (trial procedure)
|
||||
- [x] A M8 draft_last_save (2f824a9) · [x] B sheet asset accessors (f7e7bf4) · [x] C preview mutators, edit ops, ids (173be59..cfd49c7) · [x] D editor store, undo, recovery (7f1d440..b14509f) · [x] E route, modes, tabs (6aba971) · [x] F Général, Références, Vertèbres (d163b2c) · [x] G views + upload (8343528, 1bbf97e, 7ea9619) · [x] H Annotations (2609785, 3f15762) · [x] I Constats (92c595c, 91d06c9) · [x] J Vérification + submit (447d0a4..3d589e1) · [x] K e2e (5097fd7..4cc27a8) · [x] L owner trial tooling (ac5fbfb) · [x] M gates, reviews, checkpoint (071b58a..7a4ce9e; checkpoint report 2026-11-04, owner trial pending) · [x] N owner checkpoint decisions (C35-C44: be4f468..5e0aa62; ready for the owner trial, guide verified from the worktree) · [x] O last decisions (C45-C48: free paths never reshaped, explicit category zone, LAN trial on 192.168.1.100:5193; a69eba5..9b86f54) · [ ] owner manual trial
|
||||
- [ ] V1-2.6 new editor UX maquettes (owner brief 2026-11-05 « nouvelles maquettes UX approuvées sur le principe »; contract `.claude/tasks/contracts/2026-11-05-v1-2-6-ux-maquettes.md`): mockups + feasibility audit only, no core/app code, no DEV, no merge, no V1-2.7; STOP at the graphic checkpoint
|
||||
- [x] core feasibility audit (`.claude/audits/2026-11-05-v1-2-6-ux-feasibility.md`) · [x] 16 boards + contact sheet + sources in `docs/design/v1-2-6/` · [x] REVUE.md (journey, 11 choices, contradictions, feasibility) · [x] fresh design review (6 MUST-FIX, 10 SHOULD applied; board 08 name finding wrong: frame holds Coude) + verifier ECARTS(2) U2/U9 fixed after (custom category menu, phone redraw), no re-verify · [x] commit + push branch · [ ] owner graphic checkpoint
|
||||
- [x] core feasibility audit (`.claude/audits/2026-11-05-v1-2-6-ux-feasibility.md`) · [x] 16 boards + contact sheet + sources in `docs/design/v1-2-6/` · [x] REVUE.md (journey, 11 choices, contradictions, feasibility) · [x] fresh design review (6 MUST-FIX, 10 SHOULD applied; board 08 name finding wrong: frame holds Coude) + verifier ECARTS(2) U2/U9 fixed after (custom category menu, phone redraw), no re-verify · [x] commit + push branch · [x] owner review prep (brief 2026-11-05 « préparation de la validation propriétaire »): fresh verifier CONFORME 11/11 on 9f420d3 + 5 defects outside criteria kept (no redraw allowed), ARBITRAGES.md, ETUDE-TECHNIQUE.md, CONTROLE-CONFORMITE.md, archive `/home/bchanot/faunosteo-v1-2-6-ux-maquettes.zip` · [ ] owner graphic checkpoint (external ChatGPT review first)
|
||||
- [ ] separate tracks kept apart: TOTP asked at sign-in; missing illustrations blocking the copy of the historical equine sheet
|
||||
- [ ] MANDATORY before merging V1-2 into develop (owner 2026-11-03): registry id reconciliation. LRN-095 collides: develop 09655b2 « Port a safe runner verbatim… » (2026-11-02) vs V1-2 « pgTAP across PGlite and the real Supabase image… » (2026-10-28, cited by BDR-084 and the V1-2.1 TODO lines). BLK-013 exists on develop only (« e2e:avatar on develop reached DEV »): `memory.sh` on V1-2 would hand out BLK-013 again, so a V1-2 blocker needs its id checked against develop first. Same for the TODO release-readiness ids: RR-11 is develop's (« sandbox-only e2e follow-ups »), V1-2 uses RR-12. No renumbering during V1-2.6 unless needed; renumber one side and patch its citers at the merge
|
||||
- [ ] V1-2.5 catalogue, admin space, rights, species, MFA · V1-2.6 editor level 1 · V1-2.7 preview, review, publication UI · V1-2.8 equine working copy and review preparation · V1-2.9 FR/EN acceptance and closure (owner checkpoints V1-2.3, V1-2.4, V1-2.6, V1-2.7, V1-2.8, V1-2.9 + each DEV operation of contract §16.11)
|
||||
|
||||
@@ -0,0 +1,82 @@
|
||||
# V1-2.6 · Les 11 arbitrages UX ouverts
|
||||
|
||||
Liste intégrale des choix visibles dans les seize planches qui attendent une décision du propriétaire. Leur numéro est celui de `REVUE.md` § « Choix de conception à arbitrer ». L'accord donné sur le concept de la nouvelle UX ne vaut validation d'aucun de ces détails. Statut : **ouverts, aucun tranché**.
|
||||
|
||||
Pour chaque choix : ce qui est dessiné, les alternatives, leurs conséquences, et une recommandation, qui n'engage que l'auteur des maquettes.
|
||||
|
||||
## 1. Déplacer une zone entière
|
||||
|
||||
- **Dessiné (05, 06 A, 16 C)** : un mode explicite « Déplacer la zone ». Hors de ce mode, glisser l'intérieur d'une zone ne déplace rien ; on valide par « Valider la position » ou Entrée.
|
||||
- **Alternatives** : (a) au bureau, glisser directement l'intérieur d'une zone déjà sélectionnée, comme le fait l'éditeur V1-2.6 actuel, et garder le mode explicite au doigt ; (b) glisser directement partout.
|
||||
- **Conséquences** : le mode coûte un clic de plus au bureau mais rend tout déplacement intentionnel. (a) est plus rapide pour un éditeur qui travaille à la souris ; le risque d'erreur reste faible, car seule la zone déjà sélectionnée bouge et Annuler la remet en place. (b) entre en conflit au doigt avec le défilement du dessin.
|
||||
- **Recommandation** : (a). Glisser direct au bureau sur une zone sélectionnée, mode explicite au doigt.
|
||||
|
||||
## 2. Place d'Annuler / Rétablir
|
||||
|
||||
- **Dessiné (toutes les planches d'édition)** : deux boutons flottants sur le dessin, plus un message « … déplacé · Annuler » après chaque geste.
|
||||
- **Alternatives** : (a) dans l'en-tête, à côté de l'état d'enregistrement ; (b) dans la barre d'outils, comme dans l'éditeur actuel.
|
||||
- **Conséquences** : l'historique d'annulation couvre tout le brouillon, onglets Général et Constats compris. Un bouton posé sur le dessin laisse croire qu'il n'annule que le dessin, et il disparaît quand on change d'onglet. L'en-tête est visible sur tous les onglets et dit la bonne portée.
|
||||
- **Recommandation** : (a), sur toutes les tailles, téléphone compris (deux icônes de 44 px dans la barre du haut). Garder le message « Annuler » après un geste sur le dessin.
|
||||
|
||||
## 3. Taille d'un point sans valeur chiffrée
|
||||
|
||||
- **Dessiné (02, 03, 14 B, 16 B)** : un curseur de « Petit » à « Grand » avec un trait rouge au minimum touchable, et une poignée sur le bord du point.
|
||||
- **Alternatives** : (a) afficher une valeur relative à côté du curseur ; (b) le curseur avec des crans sur les tailles déjà utilisées dans la vue ; (c) trois tailles fixes.
|
||||
- **Conséquences** : la fiche équine utilise des tailles régulières (34 sur la vue principale, 30 pour les charnières, 27 sur la tête). Sans repère, deux points voisins finissent avec des tailles presque égales mais différentes, ce qui se voit chez le praticien. (c) est trop rigide d'une espèce à l'autre.
|
||||
- **Recommandation** : (b). Le curseur s'aimante sur les tailles déjà employées dans la vue, sans afficher de nombre ; le trait rouge reste.
|
||||
|
||||
## 4. Noms des catégories fixes
|
||||
|
||||
- **Dessiné (07, 15 A)** : Os, Articulations et Vertèbres ont un nom figé ; seules la couleur et l'opacité changent.
|
||||
- **Alternatives** : (a) noms modifiables en FR et EN, rôle fixe ; (b) noms figés.
|
||||
- **Conséquences** : des noms figés gardent le même vocabulaire sur toutes les fiches et toutes les espèces, ce qui aide le praticien qui passe d'un cheval à un chien. Des noms modifiables permettent par exemple « Articulations et ligaments », au prix de catégories qui ne s'appellent plus pareil d'une fiche à l'autre.
|
||||
- **Recommandation** : (b), noms figés et contrôlés par le cœur. Un besoin particulier passe par une catégorie propre à la fiche.
|
||||
|
||||
## 5. Opacité et palette
|
||||
|
||||
- **Dessiné (07, 15 A)** : opacité du seul remplissage, contour toujours plein ; palette de seize couleurs, code hexadécimal, curseur et champ « % » synchronisés, aperçu.
|
||||
- **Alternatives** : (a) opacité appliquée au remplissage et au contour ; (b) pas d'opacité réglable, on garde les valeurs actuelles (point 0,65 sur la vue principale et 0,5 sur une vue détaillée, zone 0,3) et seule la couleur change.
|
||||
- **Conséquences** : une opacité stockée est un changement de schéma (voir `ETUDE-TECHNIQUE.md`). Une seule valeur par catégorie efface aussi la différence actuelle entre points et zones d'une même catégorie. (a) rend les contours illisibles à faible opacité. (b) ne coûte rien côté modèle.
|
||||
- **Recommandation** : si l'opacité reste voulue, un champ optionnel sur la catégorie, appliqué au remplissage seul, absent par défaut (les fiches existantes s'affichent alors comme aujourd'hui), et retiré de l'instantané PDF puisque le PDF dessine sa propre surbrillance. Sinon (b), qui reste la voie la moins coûteuse.
|
||||
|
||||
## 6. Vue détaillée : nom proposé et accès automatique
|
||||
|
||||
- **Dessiné (08, 14 C)** : le nom proposé reprend les annotations comprises dans le cadre ; une case cochée par défaut crée l'accès sur la vue parente, de la forme du rectangle.
|
||||
- **Alternatives** : (a) nom à saisir, sans proposition ; (b) nom générique « Vue détaillée 2 » ; (c) accès décoché par défaut.
|
||||
- **Conséquences** : la proposition demande une nouvelle requête du cœur et donne un nom maladroit si le cadre contient beaucoup d'annotations, ou aucun. Un accès qui recouvre des points de la vue parente est plus gênant : les disques visibles restent prioritaires au clic, mais l'anneau de tolérance autour d'un petit point est recouvert par l'accès. Un doigt qui vise le bord d'un point ouvre alors la vue détaillée.
|
||||
- **Recommandation** : garder la proposition de nom, modifiable, avec « Vue détaillée n » quand le cadre est vide. Cocher l'accès par défaut seulement si le rectangle ne recouvre aucune annotation de la vue parente ; sinon le décocher et dire pourquoi.
|
||||
|
||||
## 7. Périmètre et limites à partir d'un texte commun
|
||||
|
||||
- **Dessiné (10)** : deux blocs, le texte commun non modifiable et les précisions propres à la fiche, lus à la suite par le praticien ; une nouvelle version du texte commun est signalée et ne s'applique qu'après accord.
|
||||
- **Alternatives** : (a) un bouton « Partir du texte commun » qui copie le texte dans un champ vide, ensuite librement modifiable, avec une comparaison en lecture seule ; (b) pas de texte commun.
|
||||
- **Conséquences** : le document ne stocke qu'un texte par langue. Les deux blocs liés demandent soit deux champs (changement de schéma), soit une convention fragile pour retrouver la partie commune. Il faut aussi une source versionnée du texte commun et un responsable de sa rédaction juridique. Une version publiée d'une fiche est figée de toute façon : la mise à jour ne servirait qu'aux brouillons. (a) ne change que la page. Les deux options heurtent §7.4 (aucun modèle livré) et demandent l'accord du propriétaire.
|
||||
- **Recommandation** : (a). Le texte commun vit dans l'application, rédigé et validé par le propriétaire.
|
||||
|
||||
## 8. Enregistrement explicite
|
||||
|
||||
- **Dessiné (en-tête, 12 A)** : bouton « Enregistrer », état « modifications non enregistrées », « Enregistrement… », « Enregistré à … ».
|
||||
- **Alternatives** : (a) enregistrement automatique après chaque modification ; (b) enregistrement automatique après une pause de quelques secondes.
|
||||
- **Conséquences** : chaque enregistrement crée une révision, envoie tout le document (0,41 Mo pour l'équin) et passe le contrôle de conflit. L'automatique multiplie les révisions et les conflits entre deux sessions. La copie locale protège déjà contre une fermeture d'onglet ou une panne.
|
||||
- **Recommandation** : garder l'enregistrement explicite et la copie locale.
|
||||
|
||||
## 9. Édition au téléphone
|
||||
|
||||
- **Dessiné (14, 15 A-B, 16)** : édition complète au doigt, panneau du bas, quatre outils en bas, « + » seulement sur les segments assez longs. La planche 15 C montre la règle actuelle.
|
||||
- **Alternatives** : (a) garder O14 A, le téléphone reste en lecture seule ; (b) au téléphone, propriétés modifiables mais pas la géométrie ; (c) édition complète.
|
||||
- **Conséquences** : (c) lève une décision ratifiée, impose des tests de bout en bout à 375 px sur tous les parcours (49 sont aujourd'hui sautés exprès sous 1 024 px) et se heurte à la précision : certaines zones de l'équin ne font que quelques pixels à l'écran sans zoom. Les éditeurs de fiches officielles sont peu nombreux et travaillent au bureau. (b) ajoute un troisième mode à tester.
|
||||
- **Recommandation** : (a) pour V1-2. L'édition au doigt vaut sur tablette en paysage dès 1 024 px. Les planches téléphone restent une piste pour la passe mobile V1-5.
|
||||
|
||||
## 10. Tablette : barre latérale repliée
|
||||
|
||||
- **Dessiné (13)** : dans l'éditeur, la barre latérale de l'application passe derrière le menu.
|
||||
- **Alternatives** : (a) garder la barre latérale comme au bureau ; (b) replier la barre latérale dans l'éditeur à toutes les largeurs sous 1 280 px.
|
||||
- **Conséquences** : aujourd'hui la coque affiche la barre latérale dès 1 024 px (`lg`). À 1 180 px, elle prend 256 px : le dessin n'a plus qu'environ 600 px de large à côté du panneau des propriétés. Replier change la coque pour une seule route.
|
||||
- **Recommandation** : (b). La navigation reste à un tap dans le menu.
|
||||
|
||||
## 11. Couleur propre d'une annotation
|
||||
|
||||
- **Dessiné** : rien ; toute annotation hérite de sa catégorie.
|
||||
- **Alternatives** : (a) masquer le champ et garder les valeurs existantes ; (b) l'afficher seulement quand il est rempli, avec « Revenir à la couleur de la catégorie » ; (c) l'offrir en option avancée ; (d) le retirer du modèle.
|
||||
- **Conséquences** : trois annotations de la fiche équine ont une couleur propre (ATM, SSB, appareil hyoïdien). (a) les laisse s'écarter de leur catégorie sans que l'éditeur voie pourquoi. (d) est un changement de schéma, avec une migration de ces trois valeurs.
|
||||
- **Recommandation** : (b). On ne crée plus de couleur propre ; celles qui existent restent visibles et peuvent être remises à la couleur de la catégorie.
|
||||
@@ -0,0 +1,33 @@
|
||||
# V1-2.6 · Contrôle de conformité des maquettes définitives
|
||||
|
||||
Vérificateur indépendant, sans historique des passes précédentes, lancé le 2026-11-05 sur l'état commité `9f420d3` (livrable `46ea996`, contrat remis au format du vérificateur dans `9f420d3`, critères inchangés). Contrat : `.claude/tasks/contracts/2026-11-05-v1-2-6-ux-maquettes.md`.
|
||||
|
||||
## Verdict : CONFORME, 11 critères sur 11
|
||||
|
||||
| Critère | Résultat | Preuve principale |
|
||||
|---|---|---|
|
||||
| U1 Navigation | Satisfait | Quatre onglets sur 01, 10, 11 ; vues, catégories et régions dans Annotations ; Références en volet (11, 14 D) |
|
||||
| U2 Catégories | Satisfait | Trois catégories « Fixe » sans Supprimer ; menu « ⋮ » Modifier / Supprimer… sur « Os du crâne » ; formulaire « Nouvelle catégorie » ; « Ajouter une catégorie » pendant la création (02, 04, 14 B) ; valeurs synchronisées (07, 15 A) |
|
||||
| U3 Édition directe | Satisfait | Outils Point et Zone ; point glissé (03, 16 B) ; zone déplacée (06 A, 16 C) ; taille au curseur ; aucune coordonnée affichée |
|
||||
| U4 Polygones | Satisfait | Sommets, « + », bulle « − » (05) ; mode Déplacer ; Redessiner (06 B, 16 E) ; Annuler / Rétablir ; courbes et points de contrôle conservés (05) |
|
||||
| U5 Tactile | Satisfait | Tablette 13 (zone de contact de 44 px) ; téléphone 14 A-C et 16 A-E |
|
||||
| U6 Vues détaillées | Satisfait | Rectangle, noms FR/EN proposés (le coude et le carpe sont bien dans le cadre d'après `document.json`), vue ouverte prête à annoter, remplacement par un SVG spécifique, aucun nombre de `viewBox` |
|
||||
| U7 Vertèbres | Satisfait | Pas d'onglet Vertèbres ; « Configurer les régions vertébrales (5) » ; planche 09 et 15 B avec les règles du modèle |
|
||||
| U8 Général | Satisfait | Planche 10 : texte commun non modifiable, précisions propres jamais effacées |
|
||||
| U9 Planches desktop et mobile | Satisfait | Une paire desktop / mobile pour chaque écran demandé |
|
||||
| U10 Identité et fichiers | Satisfait | Jetons identiques à `tokens.css`, coque et composants de V1-2.4, seize PNG, planche-contact, sources |
|
||||
| U11 Faisabilité | Satisfait | Classement des besoins ; citations vérifiées dans le code (une seule décalée d'une ligne : `create.rs:26`, citée `:27`) |
|
||||
|
||||
Périmètre : aucun fichier modifié sous `crates/`, `apps/`, `packages/`, `supabase/` (`git diff --stat 9b86f54 9f420d3` vide). Plancher de contrôle (`floor-guard.sh`) : propre.
|
||||
|
||||
Réserves notées sans écart : la modification d'une catégorie propre à la fiche est montrée par son menu et une note, pas par un écran composé ; le passage de « Ajouter une catégorie » au volet est décrit dans la légende de 02, pas dessiné ; au téléphone, les états « Enregistrement… » et « Enregistré » et la lecture seule « en revue » ne sont dessinés qu'au bureau.
|
||||
|
||||
## Défauts relevés hors critères, non corrigés
|
||||
|
||||
Le brief du 2026-11-05 interdit de refaire les maquettes : ces défauts restent dans les planches livrées.
|
||||
|
||||
1. **Planche 07** : le formulaire « Nouvelle catégorie » est coupé en bas par la carte (bordure inférieure absente, bouton « Ajouter » au ras du bord). Le texte reste lisible.
|
||||
2. **Planche 07** : trois états ouverts en même temps (éditeur d'Articulations, menu « ⋮ », formulaire). Le menu masque le compte « 5 annotations » d'« Os du crâne » et une partie du champ EN.
|
||||
3. **Planches 07 et 09** : les comptes par catégorie sont écrits à la main et faux. Os affiche 3 au lieu de 2, Articulations 13 au lieu de 12 (11 points et 1 accès). Les géométries, elles, viennent bien de `document.json`. La phrase de `REVUE.md` sur l'origine des données vaut pour les géométries, pas pour ces comptes.
|
||||
4. **Planche 04** : le dernier sommet et le segment du bas passent en partie sous la barre « Terminer la zone / Retirer le dernier sommet ».
|
||||
5. **Planche 06** : pas de bouton flottant Annuler / Rétablir sur ces deux cadrages, alors que le choix 2 le place sur le dessin. L'annulation y est seulement décrite.
|
||||
@@ -0,0 +1,82 @@
|
||||
# V1-2.6 · Étude technique de la nouvelle UX (sans implémentation)
|
||||
|
||||
Synthèse des impacts des seize maquettes sur le cœur Rust, le schéma du document, les PDF, le worker, SQL et les fiches existantes. Rien n'a été modifié : ni code, ni schéma SQL, ni worker, ni Supabase DEV. Les références fichier:ligne sont dans `.claude/audits/2026-11-05-v1-2-6-ux-feasibility.md`, dont ce document reprend les conclusions et ajoute les vérifications faites depuis (SQL, instantané PDF, empreinte, ordre de dessin du calque).
|
||||
|
||||
## 1. Opérations Rust existantes, réutilisables telles quelles
|
||||
|
||||
| Opération du cœur | Sert à |
|
||||
|---|---|
|
||||
| `sheet.edit` : `insert`, `update`, `remove`, `move`, `set_status`, `mark_reviewed` | Chaque geste sur le dessin se ramène à un `update` de l'annotation au relâchement : point déplacé ou redimensionné, sommet glissé, inséré ou retiré, polygone déplacé ou redessiné. Catégories, vues et régions passent par `insert`, `update`, `remove` |
|
||||
| `dependents` et le refus `has_dependents` | Suppression d'une catégorie, d'une région ou d'une vue encore utilisée (planches 07, 09) |
|
||||
| Handle d'aperçu (`PreviewSheet`) et composition `view.canvas` | Dessin de chaque vue, cadrage d'une vue détaillée par son `view_box` : le SVG entier est gardé, définitions et transformations comprises, seul le cadre change |
|
||||
| Règles de placement : `out_of_frame`, `too_small`, `interior_too_small` | Refus d'une forme au relâchement (planches 12 B, 16 D), moins de 61 ms par validation sur l'équin |
|
||||
| Règles des régions : `region.code.duplicate`, `region.count_range.invalid`, grammaire du code, `annotation.region.missing` | Planche 09, sans changement |
|
||||
| Nettoyage `clean_svg`, téléversement, rattachement d'un dessin | « Remplacer par un SVG spécifique » |
|
||||
| Mesure de taille, verdict, instantané PDF | Inchangés par l'UX |
|
||||
|
||||
Côté page, existent déjà : la pile d'annulation (8 Mio, une entrée par modification acceptée), Ctrl+Z et Ctrl+Maj+Z, le pincement et le défilement au doigt, la copie locale, le dialogue de conflit.
|
||||
|
||||
## 2. Opérations Rust manquantes
|
||||
|
||||
| Besoin | Opération à créer (esquisse) | Poids |
|
||||
|---|---|---|
|
||||
| Nom proposé pour une vue détaillée | `sheet.annotations_in_rect` {document, view_id, rect} → [{id, name, category_id, inside \| partial}] | Faible : les briques `geometry_bounds` et `placement` existent dans le cœur |
|
||||
| Éditer une courbe sans la simplifier | `sheet.path_points` {d, frame} → [{index, anchor \| control, x, y, outside}] et `sheet.path_move_points` {d, moves} → {d}. Proposition écrite, non construite (`.claude/tasks/plans/2026-11-04-v1-2-6-path-repair-core-proposal.md`) | Élevé : chemins relatifs (déplacer un point décale les suivants), commandes H et V, contrôles implicites S et T, arcs |
|
||||
| Déplacer une zone courbe entière | `sheet.path_translate` {d, dx, dy} → {d} | Moyen, même lecteur de chemin |
|
||||
| Remplacer un cadrage par un SVG spécifique sans décaler les annotations | `sheet.remap_view` {document, view_id, from_box, to_box} → document, annotations passées « À confirmer » | Moyen |
|
||||
| Catégories fixes | Règles du cœur : refus de supprimer une catégorie fixe, une seule catégorie par rôle, rôles obligatoires dans une fiche neuve ; `sheet.empty` crée les trois catégories | Moyen, lié au choix de schéma (§3) |
|
||||
| Opacité par catégorie | Le calque lit l'opacité de la catégorie à la place des constantes (point 0,65 ou 0,5, zone 0,3) ; `docs/ANNOTATION-RENDERING.md` mis à jour d'abord | Moyen ; les références R3 ne se régénèrent pas sans décision |
|
||||
| Lier les régions à la catégorie Vertèbres (facultatif) | Règle de validation : `vertebral_region_code` réservé aux annotations de rôle « vertèbres » | Faible ; aujourd'hui toute annotation peut porter une région |
|
||||
|
||||
Aucune n'est nécessaire pour : glisser un sommet, insérer ou retirer un sommet, déplacer ou redessiner un polygone, tracer le rectangle d'une vue détaillée, régler la taille d'un point. Ces gestes ne changent que la page.
|
||||
|
||||
Contrainte de taille : il reste environ 17 Ko sur le module WebAssembly (583 126 o sur 600 000 o compressés). Les opérations sur les courbes en prendront une bonne part.
|
||||
|
||||
## 3. Catégories fixes et opacité face au schéma actuel
|
||||
|
||||
Aujourd'hui une catégorie porte `id`, `name` FR/EN et `color` (`#rrggbb`, sans transparence). Aucune notion de catégorie fixe ; une fiche neuve démarre sans catégorie ; l'opacité n'existe que dans des constantes du calque.
|
||||
|
||||
| Voie | Principe | Effets |
|
||||
|---|---|---|
|
||||
| A. Champs optionnels dans le schéma v2 | `role` (`bone`, `joint`, `vertebra`) et `fill_opacity` en pourcentage entier, absents par défaut et jamais écrits quand ils sont absents | Les documents existants se lisent et se réécrivent à l'identique : leur empreinte ne change pas, les contrôles SQL `schema_version = 2` non plus. Un entier évite le flottant, qui retirerait `Eq` au type et compliquerait l'écriture canonique. Mais un lecteur strict antérieur refuse un document qui porte ces champs |
|
||||
| B. Schéma v3 | Nouvelle version explicite du document | Les contrôles SQL acceptent 2 et 3 (migration), le cœur lit les deux, le worker aussi, une convention d'empreinte pour v3. Plus propre sur le papier, beaucoup plus lourd |
|
||||
| C. Sans changement de schéma | Identifiants réservés (`os`, `articulations`, `vertebres`) et opacité fixe par rôle | Pas de champ nouveau, mais l'opacité n'est plus réglable, et la catégorie vertébrale équine (`zone-colonne`) devrait être remplacée par une nouvelle, les identifiants étant immuables |
|
||||
|
||||
**Recommandation : voie A.** Elle garde les identifiants existants : sur la copie de travail équine, il suffit d'ajouter un rôle à `os`, `articulations` et `zone-colonne`. La convention d'empreinte `sha256-rfc8785-validated-v1` décrit la lecture stricte du document ; l'élargir à deux clés optionnelles est une décision à prendre avec BDR-068, même si les empreintes existantes ne bougent pas.
|
||||
|
||||
## 4. Lecteur des anciens documents
|
||||
|
||||
- **Documents v2 existants** : lus par le nouveau cœur sans changement (voie A), car les champs sont optionnels.
|
||||
- **Anciens PDF** (enveloppe v1, Report v2 et v3) : inchangés, leur instantané ne porte aucun champ nouveau.
|
||||
- **Anciennes versions de l'application lisant un nouveau document** : le lecteur N-1 figé et le build 0.2.0 sont stricts et refusent une clé inconnue. Deux cas :
|
||||
- **dans un PDF**, si l'instantané retire `role` et `fill_opacity` (le PDF n'en a pas besoin, voir §5), le lecteur N-1 lit les nouveaux PDF comme avant ;
|
||||
- **sur le serveur**, un retour arrière de l'application après l'ajout de ces champs à un brouillon rendrait ce brouillon illisible par l'ancienne version. C'est une limite de retour arrière, du même ordre que RR-2, à inscrire au suivi de mise en production.
|
||||
- **Règle maintenue** : un lecteur d'archives ne perd jamais une version (enveloppe v1, Report v2 et v3, document v2).
|
||||
|
||||
## 5. PDF, worker, SQL et migrations
|
||||
|
||||
- **PDF** : la surbrillance du PDF est une couleur fixe (`#b85a3f` à 0,85), pas celle de la catégorie. L'opacité d'une catégorie ne change donc aucun rendu PDF. L'instantané copie aujourd'hui les catégories telles quelles ; le retirer de ces deux champs, comme il retire déjà les références, garde la compatibilité N-1. Un bilan déjà exporté se reproduit à l'identique.
|
||||
- **Praticien** : son canevas utilise la couleur de la catégorie ; il utiliserait aussi son opacité, absente par défaut, donc rendu inchangé pour les fiches existantes.
|
||||
- **Worker** : il embarque le cœur et lit le document strictement pour le verdict. Un worker construit avant le changement refuserait un brouillon portant les nouveaux champs. Ordre de déploiement : image du worker reconstruite et déployée avant l'application, comme pour toute évolution du cœur.
|
||||
- **SQL** : la forme contrôlée côté serveur ne regarde que les tableaux et les identifiants de catégories ; des champs optionnels passent sans migration (voie A). La voie B demande une migration qui élargit `anatomical_sheet_versions_schema_known` et le contrôle `document.schema_version`. Les empreintes des groupes de revue incluent les catégories : un brouillon qui gagne un rôle ou une opacité voit le groupe de revue qui contient ses catégories marqué modifié, ce qui est le comportement attendu.
|
||||
- **Taille** : quelques octets par catégorie, sans effet sur le plafond de 2 Mio.
|
||||
|
||||
## 6. Préservation des fiches anatomiques historiques
|
||||
|
||||
- **La fiche historique** (`503dc301-…`) reste en lecture seule : aucune étape ne la modifie, la soumet ou la publie, et le pipeline Git n'est pas régénéré (`pnpm r5:import-equine --check` sans différence). Son document reste v2 sans champ nouveau ; son empreinte et l'alias historique restent valides.
|
||||
- **Les versions publiées** sont figées par le serveur : elles gardent leur document tel quel, sans rôle ni opacité, et s'affichent comme aujourd'hui.
|
||||
- **La copie de travail équine** porte la conversion, par une modification ordinaire de son brouillon, relue en revue :
|
||||
- rôles ajoutés à trois catégories existantes ;
|
||||
- « Charnières vertébrales » et « Os du crâne » gardées comme catégories de la fiche ;
|
||||
- les trois couleurs propres d'annotations traitées selon l'arbitrage 11.
|
||||
- **L'outil local et les PDF déjà émis** ne changent pas.
|
||||
|
||||
## 7. Édition tactile et restrictions de largeur
|
||||
|
||||
- **Règle actuelle** : l'édition demande une fenêtre d'au moins 1 024 px (`MIN_EDIT_WIDTH`), sinon mode lecture seule (O14 A ratifiée, contrat §8.4). Les tests de bout en bout sautent exprès 49 cas d'édition sous cette largeur.
|
||||
- **Tablette en paysage** (1 024 px et plus) : déjà autorisée à éditer. Pincer et défiler fonctionnent. Il manque, côté page :
|
||||
- des poignées à zone de contact de 44 px (les sommets actuels sont décoratifs) ;
|
||||
- un contrôle de `pointerId` dans le geste de déplacement, sinon un second doigt peut l'alimenter ;
|
||||
- la priorité de la poignée la plus proche quand deux se chevauchent.
|
||||
- **Tablette en portrait** (768 à 834 px) : reste en lecture seule tant que le seuil tient.
|
||||
- **Téléphone** : éditer impose de lever O14 A, d'écrire les parcours de bout en bout à 375 px et de tester sur WebKit. La tolérance de tap de Chromium (LRN-108) n'est pas celle de Safari, et les suites ne tournent que sur Chromium jusqu'à V1-5. La précision pose aussi problème : certaines zones équines ne font que quelques pixels sans zoom. Recommandation : arbitrage 9.
|
||||
Reference in new issue
Block a user