diff --git a/.claude/memory/journal.md b/.claude/memory/journal.md index 5a827ed1..5e52be57 100644 --- a/.claude/memory/journal.md +++ b/.claude/memory/journal.md @@ -515,3 +515,4 @@ R5.4: `draft/{labels,changelog,review_report,drawing,overlay,app_review,svg_comp ## 2026-11-03 - 2026-11-03 V1-2.5 owner checkpoint corrections (f5456f3): three permission states (creation page order loading, server refusal, failed read, editor rule; admin home notice; reloadAccess keeps held roles), Paris end-of-day expiry, species order 0..9999 in M7, labels, TOTP reuse measured (code accepted by several sessions in step N and N+1, refused N+2), lost-factor review = production prerequisite. 2 state-dependent sandbox tests fixed. Gates green on fresh stack, security PASS, verifier CONFORME. V1-2.5 VERIFIED. No DEV, no merge. - 2026-11-03 owner accepted V1-2.5 final checkpoint b4415a3 (V1-2.5 VERIFIED): BDR-099 decisions, LRN-113 TOTP reuse/Storage 409/sandbox order. V1-2.6 editor level 1 authorised (brief « Validation V1-2.5 et autorisation V1-2.6 »). +- 2026-11-03 V1-2.6 owner GO conditional on six FATAL re-check. Fresh verifier: REMAINING(2): fixes 1-5 closed, I1-I5 hold; radius fix 6 opens out_of_frame on small frames; I6 broken (pending recovery copy overwritten by first commit). 2 MINOR. LRN-095 collision + BLK-013 trap in TODO. Executor not launched, STOP. diff --git a/.claude/tasks/TODO.md b/.claude/tasks/TODO.md index 30682fd3..329ff537 100644 --- a/.claude/tasks/TODO.md +++ b/.claude/tasks/TODO.md @@ -671,6 +671,9 @@ Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheet - [x] L2 expiry end of day Europe/Paris, species order 0..9 999 in M7, labels, TOTP key test: app 696, supabase 148, pgTAP 1965 fresh + upgrade, types match - [x] L3 TOTP reuse measured (code accepted by several sessions in its step and the next, refused at N+2), lost-authenticator review (production prerequisite), decisions in docs; sandbox test 103 + 10 skipped x2 - [x] L4 gates: check:all green (dcb1a94; delta = sandbox test + docs), fresh stack test-db 1965, e2e:shell 110 + 8 skipped, sandbox test 103 + 10 skipped after e2e, upgrade from M6 1965 + types match; security PASS x2; verifier ECARTS(6) -> CONFORME; two state-dependent sandbox tests fixed (0499a39, f5456f3); suites need a fresh stack in order test-db, e2e:shell, test + - [ ] 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. 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) + - [ ] A M8 draft_last_save · [ ] B sheet asset accessors · [ ] C preview mutators, edit ops, ids · [ ] D editor store, undo, recovery · [ ] E route, modes, tabs · [ ] F Général, Références, Vertèbres · [ ] G views + upload · [ ] H Annotations · [ ] I Constats · [ ] J Vérification + submit · [ ] K e2e · [ ] L owner trial tooling · [ ] M gates, reviews, checkpoint + - [ ] 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. 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) ## Release readiness track (owner 2026-10-25, distinct from the functional roadmap; nothing here authorises a release or exposure) diff --git a/.claude/tasks/contracts/2026-11-03-v1-2-6-editor-1509.md b/.claude/tasks/contracts/2026-11-03-v1-2-6-editor-1509.md new file mode 100644 index 00000000..0aaaa895 --- /dev/null +++ b/.claude/tasks/contracts/2026-11-03-v1-2-6-editor-1509.md @@ -0,0 +1,274 @@ +# CONTRACT — v1-2-6-editor +- date: 2026-11-03 | flow: ship-feature | branch: feature/v1-2-anatomical-sheets +- status: active +- worktree: /tmp/claude-1000/-home-bchanot-Documents-faunosteo/e641af9a-743e-46d0-9804-99667836040e/scratchpad/v1-2 + (every command runs from this worktree; never from /home/bchanot/Documents/faunosteo, never against DEV: + the `supabase_*_faunosteo` containers are DEV and are never touched; the sandbox is `faunosteo_dbsandbox_*`) +- base: 7f618d0 (memory commit after V1-2.5 VERIFIED at b4415a3) +- contract of the step: docs/development/V1-2_ANATOMICAL_SHEETS.md §16.7 and §8.1-§8.4, with §6.2, §6.6, §6.7, + §9.2-§9.4, §10, §11.1-§11.2, §17.9, §17.11; design docs/design/v1-2-4 boards 04, 05, 06 A (approved, BDR-096), + REVUE.md ratified wordings + +## REQUEST (verbatim — IMMUTABLE) + +# FAUNOSTEO — Validation V1-2.5 et autorisation V1-2.6 + +Décision propriétaire : **ALL**. + +J'accepte le checkpoint final V1-2.5 au HEAD `b4415a3`. + +**V1-2.5 VERIFIED** + +J'autorise l'enregistrement des deux mémoires proposées, puis le démarrage de V1-2.6 conformément au contrat existant. + +## 1. Mémoires + +Créer les deux entrées proposées : + +**BDR — Décisions V1-2.5** +- Ordre des états et contrôles d'autorisation. +- Fonctionnement du bouton Réessayer. +- Expiration des habilitations à 23:59:59.999, heure de Paris, le jour choisi. +- Ordre des espèces limité à 0–9 999. +- Deux écarts UX acceptés. +- Parcours de récupération MFA sécurisé obligatoire avant production. +- Réserve concernant les tests mobiles et les tests sandbox supplémentaires. + +**LRN — Retours techniques** +- Comportement de GoTrue v2.197 sur la réutilisation des codes TOTP, en distinguant les observations de toute garantie générale. +- Particularité de la réponse Storage HTTP 400 avec `statusCode: "409"`. +- Nécessité d'une sandbox neuve et de l'ordre `test-db → e2e:shell → test`, en conservant l'explication du problème de partage d'état. + +Vérifier les identifiants BDR/LRN existants avant attribution. Ne pas créer de collision. + +Commiter et pousser ces modifications sur `feature/v1-2-anatomical-sheets`. + +## 2. Démarrage V1-2.6 autorisé + +Développer l'éditeur anatomique de niveau 1, en respectant strictement le contrat V1-2 §16.7 et §8.2. + +Périmètre : +- Onglets et formulaires structurés. +- Import de dessin SVG avec nettoyage par le cœur Rust. +- Gestion des vues principales et secondaires. +- Points, zones et liens anatomiques. +- Édition des propriétés d'annotations. +- Catalogue et arbre des constats. +- Indicateurs de revue et éléments `to_confirm`. +- Enregistrement, récupération locale et gestion des conflits. +- Consultation en lecture seule sous 1 024 px. +- Parcours clavier et accessibilité prévus au contrat. + +Ne pas inventer de nouvelles fonctionnalités hors périmètre. + +Ne pas modifier le design approuvé V1-2.4 sans défaut démontré. + +## 3. Test fonctionnel obligatoire + +Démontrer sur une sandbox fraîche un parcours complet : + +1. Connexion avec un compte possédant les habilitations nécessaires. +2. Création d'une nouvelle fiche pour une espèce autre que le cheval. +3. Import d'un SVG réel. +4. Vérification et nettoyage du dessin par le cœur Rust. +5. Création d'une vue secondaire. +6. Création et modification de points, zones et liens. +7. Création des catégories et constats prévus par le contrat. +8. Enregistrement du brouillon. +9. Rechargement du navigateur et récupération correcte du travail. +10. Gestion d'un conflit de modification entre deux sessions. +11. Soumission de la fiche. +12. Vérification de sa progression dans le workflow, jusqu'à `verifying` conformément aux règles existantes. + +Respecter les règles concernant les éléments `to_confirm` et les verdicts. Ne pas contourner les contrôles pour faire réussir la démonstration. + +## 4. Tests et qualité + +Exécuter les tests contractuels, notamment : +- E2E A2, A3 et A4. +- Parcours clavier et champs numériques. +- Import SVG hostile et valide. +- Contrôles des permissions. +- Gestion des conflits. +- Rechargement et récupération. +- Affichage mobile à 320 et 375 px. +- Lecture seule sous 1 024 px. +- Intégration des composants Rust/Wasm. +- Non-régression des fiches équines historiques. + +Préserver les oracles et les protections de sécurité déjà validés. + +Exécuter les suites sandbox dans l'ordre requis, sur une pile neuve, sans masquer les problèmes de pollution d'état. + +Relancer `check:all` et une revue indépendante de conformité et de sécurité sur le code final. + +## 5. Livrable testable par le propriétaire + +Au checkpoint V1-2.6, fournir une procédure pratique pour que je puisse tester l'éditeur dans un navigateur : + +- Commandes exactes pour démarrer les services isolés nécessaires. +- URL locale de l'application. +- Méthode d'accès au compte de test, sans exposer de secret dans les logs. +- Parcours précis pour créer une fiche. +- Opérations que je dois pouvoir tester. +- Résultat attendu pour chaque étape. +- Procédure d'arrêt et de nettoyage de la sandbox. + +Ne pas affirmer que le produit a été validé par le propriétaire avant mon essai. + +## 6. Contraintes + +- Travail uniquement sur `feature/v1-2-anatomical-sheets`. +- Commits et push réguliers. +- Aucune fusion vers develop, main ou release. +- Aucune opération sur Supabase DEV. +- Aucun worker DEV. +- Aucune migration DEV. +- Aucune modification des ressources équines historiques. +- Aucun déploiement de production. +- Aucun début de V1-2.7. + +La reconstruction des images et les opérations sur la sandbox jetable sont autorisées si nécessaires, après vérification des cibles et de l'absence d'exécution concurrente. + +## 7. Checkpoint final + +Présenter : +- HEAD et commits. +- Fonctionnalités réalisées. +- Résultats des tests. +- Résultats de l'audit indépendant. +- Écarts et risques résiduels. +- Démonstration complète d'une fiche non équine. +- Procédure de test manuel par le propriétaire. + +Ne déclarer V1-2.6 VERIFIED qu'après satisfaction des critères techniques contractuels. + +S'arrêter avant V1-2.7 et attendre mon retour après essai de l'éditeur. + +## CLARIFICATIONS + +Q: Conflict dialog « author and time » (§6.2) has no data source; §16.7 says SQL none / A: [gated 2026-11-03] +read migration M8 (sandbox only, as M7 in V1-2.5): the admin read of the draft returns the last save's actor and +time (from the audit), no write path, no policy or rule change; the deviation from « SQL changes: none » is +recorded in the contract. DEV untouched. +Q: Board 06 A shows « Prévisualiser »; §8.2 lists follow the round and withdraw; §16.8 gives V1-2.7 the +practitioner preview, the round screen and the withdrawal / A: [gated 2026-11-03] deferred to V1-2.7: V1-2.6 +submits, then shows the frozen draft with « Revue n° N · vérification en cours » and a link to the sheet's +overview; no « Prévisualiser » and no withdrawal before V1-2.7 (visible deviation from board 06 A, recorded). +Q: Which drawing for A2 (« un SVG réel », non-equine, exported then cleaned) / A: [gated 2026-11-03] the +committed Inkscape 1.4.3 export (`crates/core/tests/fixtures/svg/exports/inkscape-1.4.3-*.svg`, a real export, +cleaning offered) plus a hostile file; the owner may import a drawing of their own at the trial. +Q: Undo / redo control (not on board 04) / A: [gated 2026-11-03] two icon buttons « Annuler » and « Rétablir » +in the tool column under the zoom, plus Ctrl+Z and Ctrl+Shift+Z. + +## ACCEPTANCE CRITERIA + +Memory part (§1 of the request): done before this contract, commit 7f618d0 pushed (BDR-099, LRN-113; ids +checked across develop, main, feature/v1-1, feature/v1-2: next free were BDR-099 and LRN-113). + +1. Route `/app/admin/sheets/:sheetId/draft` exists under `RequireAdmin`; the page loads the sheet's draft + (admin read for the draft version, `get_sheet_version`, drawings downloaded under RLS, an editable + `PreviewSheet`) and shows the permission states of BDR-099 (loading, failed read with « Réessayer », not + authorised); an active `sheet_editor` grant gives the edit mode; reviewer-only and publisher-only accounts + get the read-only mode; a draft frozen by a `verifying`, `open` or `approved` round is read-only with a + notice naming the round; a sheet without a draft says so with a link to the overview. The overview offers + the editor link; A1 (new sheet) and W1 (working copy) land on the editor (§11.2). +2. The editable preview handle replaces the document (`replace_document`) and adds drawings (`add_drawing`) + in place, and after a runtime trap rebuilds from the CURRENT document text and the drawings held, never + from the initial input. +3. Tabs Général, Vues et illustrations, Annotations, Constats, Références, Vertèbres, Vérification (§11.1), + ARIA tabs; every change is one core `sheet.edit` command run on commit (blur, confirm, pointer-up), never + per keystroke; TypeScript keeps no document schema and no Zod copy (ts-rs types only). +4. Général: FR/EN name, description, scope disclaimer, attribution (authors, licence, notes); annotation + categories (name FR/EN, colour) add, edit, delete. +5. Références: add, edit, delete; type, citation, URL (http or https only), DOI. Vertèbres: add (code typed at + creation, read-only after), edit, reorder ↑/↓, delete. A refused removal (`has_dependents`) lists the + dependents from `sheet.dependents`; no cascade deletion. +6. Vues et illustrations: main view and detail views (parent; own drawing or crop entered as numeric + `view_box` values over the parent's preview), rename, delete (dependents listed). Drawing upload: the file + is read by the core (`clean_svg`); hard rejection and active content refused with the reason in FR/EN, no + cleaning offered; cleanable: the cleaned drawing composed by the core and the removed names (a removed + `