109 lines
7.1 KiB
Markdown
109 lines
7.1 KiB
Markdown
# CONTRACT — v1-2-6-u1-authorisation-checkpoint
|
|
- date: 2026-11-06 | flow: checkpoint preparation (docs only) | branch: feature/v1-2-anatomical-sheets
|
|
- status: active
|
|
- worktree: /home/bchanot/Documents/faunosteo-v1-2 (every command from this absolute path; never DEV; the sandbox is
|
|
neither started nor reset)
|
|
- base: a43145a. Commit in place, push; no merge, no `gitflow.sh finish`.
|
|
|
|
## REQUEST (verbatim — IMMUTABLE)
|
|
|
|
# FAUNOSTEO — U1 / U2b — Derniers arbitrages avant implémentation
|
|
|
|
Le propriétaire confirme la conception U1 et le placement de U2b entre U2 et U3.
|
|
|
|
## A. Décisions U2b
|
|
|
|
F2 — Compter uniquement les feuilles sélectionnables de l'arbre des constats, sans les groupes intermédiaires. Les doublons dus à plusieurs annotations d'une même zone doivent être éliminés.
|
|
|
|
F3 — Recherche en français et en anglais, sur les noms des zones, familles, groupes et feuilles. Recherche insensible aux accents et à la casse. Tous les mots doivent correspondre, dans n'importe quel ordre, y compris lorsqu'ils apparaissent à différents niveaux de l'arbre.
|
|
|
|
F4 — Valider le modèle A. Sans annotation cochée, les vues sélectionnées filtrent les zones représentées. Dès qu'une annotation est cochée, les zones explicitement sélectionnées déterminent le filtre anatomique. Combiner ce filtre avec la recherche textuelle par intersection.
|
|
|
|
F8 — Ne jamais créer automatiquement une zone de constats redondante. Une annotation sans zone doit permettre une association explicite à une zone existante ou une création validée. L'opération doit être cohérente, annulable et non destructive. Ne pas fusionner deux constats distincts sur la seule égalité de leurs libellés.
|
|
|
|
F22 — Lorsqu'on ajoute un constat depuis une annotation, utiliser sa zone existante comme rattachement par défaut. Toute modification de l'association anatomique passe par une action explicite, sans déplacement silencieux des constats existants.
|
|
|
|
Mettre à jour les décisions et les tests U2b concernés.
|
|
|
|
## B. Décisions encore ouvertes
|
|
|
|
Présenter les questions F5 et F9 à F21 avec leurs libellés exacts et les recommandations correspondantes.
|
|
|
|
Ne pas les considérer comme automatiquement approuvées.
|
|
|
|
## C. Checkpoint d'autorisation U1
|
|
|
|
Le plan U1 au commit 2e46c14 est conservé.
|
|
|
|
Présenter maintenant, sans réécrire le plan :
|
|
|
|
1. Les 18 choix visibles du plan U1, avec alternatives, recommandation et conséquences.
|
|
2. Les cinq amendements contractuels exacts.
|
|
3. Le résultat des trois audits indépendants et la trace de résolution de leurs points majeurs.
|
|
4. La portée exacte de toute suppression ou réinitialisation de la sandbox prévue dans le lot B1.
|
|
5. Les critères de validation de chaque lot A à I.
|
|
|
|
Prévoir qu'aucune suppression de données, même en sandbox, n'est implicitement autorisée par l'approbation du plan.
|
|
|
|
## D. Apprentissage React
|
|
|
|
Conserver LRN-119, notamment la distinction entre préservation de l'état et reprise des effets de React Activity, ainsi que le comportement des références DOM lors du masquage.
|
|
|
|
## E. Restrictions
|
|
|
|
Documentation et arbitrages uniquement.
|
|
|
|
Ne pas modifier le code applicatif, Rust, SQL ou worker.
|
|
|
|
Ne pas utiliser Supabase DEV.
|
|
|
|
Ne pas réinitialiser la sandbox.
|
|
|
|
Ne pas fusionner, déployer ni commencer U1, U2 ou U2b.
|
|
|
|
S'arrêter à la présentation des dernières décisions nécessaires à l'autorisation d'implémentation U1.
|
|
|
|
## CLARIFICATIONS
|
|
(none)
|
|
|
|
## ACCEPTANCE CRITERIA
|
|
1. U2b decisions (A): the study `docs/development/V1-2-6_UX_FINDINGS_NAV.md` section 7 records F2, F3, F4, F8 and
|
|
F22 as approved with the owner's sentences of this REQUEST verbatim, adapts their recommendation and consequences
|
|
(F2 leaves and identity never by label, F8 explicit link or validated creation and no merge on labels, F22 default
|
|
zone and no silent move), flags any reading the owner did not state (F22 « par défaut ») and any detail left to
|
|
the U2b contract; F5 and F9 to F21 stay « to decide »; every figure added is computed from the equine draft under
|
|
the rule it names.
|
|
2. U2b tests (A): the study's section 6 lists unit and e2e tests for each of F2, F3, F4, F8 and F22 as decided.
|
|
3. U1 plan preserved (C): plan and contract byte-identical to 2e46c14.
|
|
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 2e46c14 -- .claude/tasks/plans/2026-11-06-v1-2-6-ux-u1.md .claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md && echo U1_UNCHANGED
|
|
EXPECT: U1_UNCHANGED
|
|
EVIDENCE: MET exit=0 marker-found :: U1_UNCHANGED
|
|
4. Checkpoint page (C1-C5): `docs/development/V1-2-6_UX_U1_CHECKPOINT.md` gives (1) the plan's 18 visible choices
|
|
quoted verbatim, each with alternatives, recommendation and consequences; (2) the five AC amendments with the
|
|
contract's current text verbatim and an exact proposed text faithful to the plan, plus the plan's other contract
|
|
changes quoted; (3) the verdicts and MAJOR/MINOR counts of the three challengers and the confirmation pass, each
|
|
MAJOR traced to its resolution in the plan, matching the archived original reports
|
|
`.claude/audits/2026-11-06-v1-2-6-u1-plan-challenges.md`; (4) the exact scope of every planned sandbox reset
|
|
(commands, what is removed and what is not, current state) from `scripts/db-sandbox.sh`; (5) the validation
|
|
criteria of lots A to I matching the plan; every « plan :n » reference points at the cited text.
|
|
5. No implicit deletion (C): the page states that the plan approval authorises no data deletion and proposes a
|
|
contract clarification that prevails over the plan lines authorising the wipe, without editing the plan.
|
|
6. LRN-119 kept (D): unchanged by this intervention, its status line on DOM refs present.
|
|
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet a43145a -- .claude/memory/learnings.md && grep -q "refs to DOM elements detached while hidden" .claude/memory/learnings.md && echo LRN_KEPT
|
|
EXPECT: LRN_KEPT
|
|
EVIDENCE: MET exit=0 marker-found :: LRN_KEPT
|
|
7. Registries: one decisions entry for this brief through `memory.sh`, recording only owner decisions; journal; TODO.
|
|
8. Restrictions (E): no change under `apps/`, `crates/`, `supabase/`, `packages/`, `scripts/`, `docs/design/v1-2-6/`,
|
|
the PNG boards; no sandbox container started or removed; the untracked review file never staged.
|
|
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet a43145a -- apps crates supabase packages scripts docs/design/v1-2-6 'docs/design/v1-2-6-constats/*.png' && ! git ls-files --error-unmatch faunosteo-v1-2-6-revue-ux-chatgpt.md >/dev/null 2>&1 && echo CK_SCOPE_OK
|
|
EXPECT: CK_SCOPE_OK
|
|
EVIDENCE: MET exit=0 marker-found :: CK_SCOPE_OK
|
|
9. A fresh independent verifier against this contract; justified gaps fixed; exact verdict reported. STOP.
|
|
|
|
## FILE SCOPE
|
|
- docs/development/{V1-2-6_UX_FINDINGS_NAV.md, V1-2-6_UX_PLAN.md (U2b entry), V1-2-6_UX_U1_CHECKPOINT.md (new)}
|
|
- docs/design/v1-2-6-constats/REVUE.md
|
|
- .claude/audits/2026-11-06-v1-2-6-u1-plan-challenges.md (new, verbatim reports)
|
|
- .claude/tasks/TODO.md, this contract, .claude/memory (through memory.sh)
|
|
- NOT in scope: the U1 plan and contract, apps/**, crates/**, supabase/**, packages/**, scripts/**, the boards
|