Files
faunosteo/.claude/tasks/contracts/2026-11-16-r3-sheet-list-1720.md
T

20 KiB

CONTRACT — r3-sheet-list

  • date: 2026-11-16 | flow: subagent-driven-development (plan .claude/tasks/plans/2026-11-16-r3-sheet-list-0017.md rev 2b) | branch: feature/v1-2-anatomical-sheets (worktree /home/bchanot/Documents/faunosteo-v1-2)
  • status: active
  • range under review: 98178de..HEAD (98178de = the commit before the R3 plan)

REQUEST (verbatim — IMMUTABLE)

Owner brief 2026-11-16 (R3 start)

Je confirme la clôture de R2. Merci pour le travail réalisé.

Je donne maintenant mon feu vert pour démarrer la préparation de R3 : amélioration de la liste des fiches anatomiques et de l'accueil Administration.

Les maquettes R0 correspondantes, notamment les planches 28 à 30, sont déjà validées et constituent notre référence graphique.

Je souhaite retrouver une liste de fiches claire et facile à utiliser, avec :

  • Une recherche efficace.
  • Des filtres compréhensibles sur les statuts.
  • Un tri par nom.
  • Un tri par véritable date de dernière modification.
  • Une présentation permettant de distinguer facilement une fiche historique, une fiche publiée, un brouillon et une copie de travail.
  • Une navigation simple pour retrouver rapidement la fiche que je souhaite consulter ou modifier.

Pour la date de dernière modification, reprends la conception déjà validée dans V1-2-6_R3_SQL_CHECKPOINT.md.

Présente-moi d'abord le checkpoint SQL et ses conséquences avant toute application de migration.

Je te laisse autonome pour :

  • Auditer l'existant.
  • Réutiliser les décisions et maquettes déjà validées.
  • Préparer le plan technique.
  • Organiser les relectures indépendantes.
  • Identifier les éventuelles contradictions ou dépendances.

Conserve BLK-015 et RR-13 comme chantiers séparés, sans perdre leur suivi.

Je souhaite pouvoir tester R3 sur db:trial lorsqu'il sera terminé.

Une fois le checkpoint SQL et le plan prêts, présente-moi les décisions nécessitant mon accord avant l'implémentation.

Owner validation 2026-11-16 (plan rev 2, decisions D1 to D7)

Je valide le plan R3 en révision 2 et les décisions suivantes.

D1 : OUI. Écriture de la migration SQL et des tests correspondants.

D2 : OUI. Une seule livraison à l'état final. Il n'est pas nécessaire de construire l'état intermédiaire sans date.

D3 : OUI. L'ordre retenu est :

  • Migration de la sandbox.
  • Migration de db:trial.
  • Mise à jour de l'application.

Je valide le principe de la nouvelle commande pnpm db:sandbox migrate, sans réinitialisation de la sandbox.

En revanche, présente-moi le checkpoint opérationnel avant d'appliquer la migration à db:trial.

Cette opération nécessite l'arrêt temporaire de mon application d'essai et une sauvegarde. Je donnerai mon accord au moment voulu.

D4 : OUI. Élargir RR-13 à la pagination des listes d'administration, notamment les droits et les fiches, sans implémenter ce chantier dans R3.

D5 : NON. Conserver la recherche, le tri et les filtres au retour d'une fiche reste hors R3, conformément aux décisions existantes.

Le besoin reste suivi pour une amélioration ultérieure de la navigation.

D6 : OUI. Je conserve les libellés recommandés :

  • « Toutes les fiches officielles » pour zéro ou une fiche.
  • « Voir les {n} fiches » à partir de deux.

D7 : OUI. Les tests peuvent effectuer une suppression logique des fiches qu'ils ont eux-mêmes créées.

Ils doivent identifier précisément leurs propres données et ne jamais modifier ou supprimer les données préexistantes de la sandbox.

Je valide également les autres choix retenus dans le plan :

  • Présentation conforme aux maquettes R0.
  • Filtres existants.
  • Recherche sans résultat conforme à la planche 28.
  • Pas de nouvelle icône de recherche.
  • Tri alphabétique selon la langue.
  • Dates affichées en heure de Paris.
  • Recherche et tri de présentation en TypeScript.

Quelques précisions :

  1. Vérifie que les tests couvrent le calcul réel de last_modified_at sur PostgreSQL, notamment les brouillons et les copies de travail.

  2. La migration doit être relue et figée avant sa première application.

  3. L'application ne doit jamais afficher une date ancienne ou incorrecte comme une date fiable de dernière modification.

  4. Conserve les résultats exacts des tests, notamment les échecs connus de BLK-015.

Tu peux maintenant committer le plan et le TODO, puis engager l'implémentation de R3 selon ton processus habituel.

Tu disposes de mon accord pour les développements et les vérifications sur la sandbox dans le périmètre du plan validé.

Avant toute migration de db:trial, présente-moi :

  • Les opérations exactes.
  • La sauvegarde prévue.
  • Le temps d'indisponibilité estimé.
  • La procédure de vérification après redémarrage.

Je donnerai alors mon accord pour cette opération.

DEV reste inchangé.

Je te laisse autonome pour les choix techniques et les relectures habituelles.

Owner go 2026-11-16 (db:trial migration, then the application tasks)

Je valide le checkpoint SQL M9 et j'autorise son application sur db:trial.

Je préfère que tu réalises toi-même les opérations prévues, puisque tu as préparé et audité la procédure.

Mon autorisation couvre :

  1. La vérification de l'état initial de db:trial.
  2. L'arrêt temporaire de l'application d'essai sur le port 5194.
  3. La sauvegarde à froid des volumes et des secrets par la procédure prévue.
  4. L'application de la migration M9 avec pnpm db:trial migrate.
  5. Le redémarrage et la vérification des six conteneurs.
  6. Les contrôles d'intégrité des données et de la nouvelle fonction SQL.
  7. Le redémarrage de l'application d'essai.

Avant d'arrêter l'application, vérifie que le processus ciblé correspond bien à l'application Faunosteo sur le port 5194. Ne te fie pas uniquement au PID 1718512, qui peut avoir changé.

La sauvegarde doit être complète, vérifiée et récupérable avant l'application de M9.

Je valide l'interruption temporaire annoncée de db:trial.

En cas d'échec de la sauvegarde ou de la migration, arrête la procédure et présente-moi le diagnostic. N'effectue pas de restauration destructive sans mon accord.

Après migration, vérifie notamment :

  • Les 18 migrations appliquées.
  • Les comptes, rôles et facteurs TOTP.
  • Les fiches, versions et illustrations.
  • Le calcul de last_modified_at.
  • L'absence de modification inattendue des données.
  • Le fonctionnement de l'administration et de l'éditeur.

DEV reste strictement inchangé.

Conserve les échecs pgTAP 014 et 021 dans le suivi, avec leurs résultats exacts. Ne présente pas la suite complète comme verte.

Une fois M9 appliquée et vérifiée sur db:trial, tu peux poursuivre les tâches applicatives de R3 selon le plan validé, avec tes relectures et tests habituels.

À la fin, présente-moi le bilan et la procédure d'essai propriétaire de R3.

Owner message 2026-11-16 (R3 trial feedback: collapsible filters on a phone)

Retour de mon essai propriétaire R3 sur db:trial.

Tous les tests fonctionnels sont satisfaisants. Je valide le comportement général de R3.

J'ai seulement une dernière amélioration UX à demander pour le téléphone.

Actuellement, sur mobile, les quatre filtres suivants occupent beaucoup de place :

  • Espèce
  • État de la fiche
  • Statut de version
  • État de la dernière revue

Je souhaite les regrouper dans un volet repliable.

Comportement attendu :

  • Sur téléphone, les quatre filtres sont masqués par défaut.
  • Un bouton « Filtres » permet d'ouvrir et de refermer le volet.
  • À l'ouverture, les quatre filtres apparaissent verticalement.
  • Les filtres continuent de fonctionner immédiatement.
  • Fermer le volet ne réinitialise pas les filtres sélectionnés.
  • Si des filtres sont actifs, le bouton doit le signaler clairement, par exemple « Filtres (2) ».
  • L'utilisateur doit pouvoir réinitialiser facilement les filtres.
  • La recherche et le tri restent directement accessibles, sans devoir ouvrir le volet.

Je souhaite une ouverture fluide, cohérente avec les autres panneaux de l'application, et adaptée à une utilisation tactile.

Sur ordinateur, conserve la présentation actuelle.

Je te laisse choisir le composant, le breakpoint et les détails d'intégration les plus pertinents.

Cette amélioration ne nécessite pas de nouvelle maquette complète.

Après cette correction, termine les vérifications et la clôture documentaire de R3.

Pense également à solder l'écart du vérificateur automatique et à vérifier la remarque sur la double annonce aux lecteurs d'écran, sans rouvrir les décisions UX déjà validées.

Conserve BLK-015 et les échecs connus des tests d'administration dans leur suivi séparé.

Tu peux utiliser ton processus habituel de développement, de tests, de relectures et de commits.

À la fin, présente-moi un court bilan et le résultat des vérifications mobiles.

R3 est validé fonctionnellement par mes essais, sous réserve de cette dernière amélioration mobile.

Owner validation 2026-11-16 (R3 closed)

Je confirme avoir testé le volet repliable des filtres sur téléphone.

Tout fonctionne correctement et l'ergonomie me convient.

Je valide officiellement R3, y compris sa dernière amélioration mobile.

Je confirme également que « Réinitialiser les filtres » doit rester uniquement à l'intérieur du volet. Aucun bouton supplémentaire n'est nécessaire.

Tu peux enregistrer cette validation propriétaire dans la documentation, le suivi et la mémoire, puis committer et pousser les éventuelles mises à jour.

R3 est terminé.

Nous pouvons maintenant passer à R4 : affichage des erreurs d'intégrité sur les cartes du catalogue.

Reprends les décisions déjà validées, notamment D9 C, les maquettes R0 et le plan V1-2.6.

Je te laisse autonome pour auditer l'existant, préparer le plan technique et organiser les relectures habituelles.

Présente-moi les éventuelles décisions qui nécessitent mon accord avant l'implémentation.

Conserve BLK-015 et RR-13 comme chantiers séparés.

Aucune fusion ni intervention sur DEV.

CLARIFICATIONS

  • Graphic reference: boards 28 and 29 of docs/design/v1-2-6-r0/ (R0, validated 2026-11-09). Board 30 belongs to R4.
  • Labels: docs/design/v1-2-6-r0/REVUE.md:82-84. Date format (A8): « 9 nov. 2026, 12:06 » / « 9 Nov 2026, 12:06 », Paris time.
  • Recorded choices the owner validated with the plan: no new badge (published and draft told apart by the detail line), the four existing filters unchanged, the no-result note of board 28 literally, no magnifier in the search field, name sort in the collation of the interface language, search and sort in TypeScript (display only).
  • Out of scope, tracked: BLK-015 (rights screen under axe on accumulated grants), RR-13 (server paging of the admin lists, widened per D4, not implemented), D5 (list state kept on return), R4 (board 30).

ACCEPTANCE CRITERIA

  1. SQL: private.official_sheet_admin_summary(uuid) returns last_modified_at = the newest of the sheet row's updated_at and of its versions' updated_at; the migration is the M7 function body plus that key and the restated revoke, nothing else; privileges unchanged. CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && [ "$(git hash-object supabase/migrations/20261116100000_sheet_admin_last_modified.sql)" = a33b1770ec ] && echo M9_FROZEN_OK EXPECT: M9_FROZEN_OK
  2. Precision 1: pgTAP (supabase/tests/022_sheet_admin_reads.sql) covers the real computation on PostgreSQL for a saved draft, a saved working copy, a sheet without version and a sheet row newer than its versions; the file passes on PGlite. CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && grep -q "select plan(74)" supabase/tests/022_sheet_admin_reads.sql && grep -c "last_modified_at" supabase/tests/022_sheet_admin_reads.sql EXPECT: a count of at least 8
  3. Precision 2: the migration file was reviewed (task review, security review) before its first application and has not changed since (criterion 1's digest; no other file under supabase/migrations/ changed in the range). CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --name-only $(git rev-parse 2277e41^)..HEAD -- supabase/migrations | tr '\n' ' ' EXPECT: supabase/migrations/20261116100000_sheet_admin_last_modified.sql only
  4. Precision 3: the application never shows an old or wrong date as the last modification: the client refuses an answer without last_modified_at or with a value that is no timestamp (unavailable), the list and the card show last_modified_at only (never updated_at or created_at under « Modifiée le »), the <time> carries the same instant. CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && sed 's#//.$##' packages/supabase/src/sheets.ts | tr -d ' \n' | grep -q "last_modified_at:z.string().datetime({offset:true}).refine((value)=>!Number.isNaN(Date.parse(value)))" && ! grep -rn "ModifiedDate iso={[^}](updated_at|created_at)" apps/app/src && echo DATE_SOURCE_OK EXPECT: DATE_SOURCE_OK
  5. List page /app/admin/sheets: a search on the sheet name (French or English, accents and case ignored, instant), combined with the four existing status filters; a native « Trier par » with « Dernière modification » (default, newest first) and « Nom » (collation of the interface language); a count line « {n} fiches » / « {n} fiches sur {total} »; each row shows « Modifiée le {date} » in the ratified format, Paris time.
  6. The search field: label « Rechercher une fiche par son nom », 100 characters at most, no magnifier; a clear control « Effacer la recherche » only while it holds text; Escape empties a non-empty field and does nothing on an empty one; clearing returns the focus to the field.
  7. Empty states as board 28's note: no official sheet at all, nothing under active filters, nothing for a search (« Aucune fiche ne contient « {q} » dans son nom. » with « Effacer la recherche »); the searched text is shown as typed (a $& stays $&), long text wraps without sideways scroll.
  8. The presentation tells a historical sheet, a published sheet, a draft and a working copy apart with the existing badges and the detail line; no new badge, no rule built on a UUID, a name, a slug or a test convention (D7 of the R0 arbitration).
  9. Administration home card (board 29 B): sub-heading « Dernières modifications », at most five sheets by last modification, each with its name link, badges, detail line and date; the footer link reads « Voir les {n} fiches » from two sheets and « Toutes les fiches officielles » for zero or one (D6); a failed species read never hides the card; a rights refusal of the sheet list still hides it.
  10. Labels in French and English exactly as the ratified list, through the dictionaries with fr / en parity; no raw string in JSX. CHECK: cd /home/bchanot/Documents/faunosteo-v1-2/apps/app && for k in admin.sheets.search admin.sheets.clear_search admin.sheets.sort_by admin.sheets.sort.modified admin.sheets.sort.name admin.sheets.count_one admin.sheets.count_other admin.sheets.count_of_one admin.sheets.count_of_other admin.sheets.modified admin.sheets.no_result admin.home.latest admin.home.see_all; do grep -q "'$k'" src/i18n/fr.ts && grep -q "'$k'" src/i18n/en.ts || echo "MISSING $k"; done; echo KEYS_CHECKED EXPECT: KEYS_CHECKED with no MISSING line
  11. D3: the sandbox was migrated through pnpm db:sandbox migrate without a reset; scripts/db-sandbox.sh received additions only. CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff $(git rev-parse 2277e41^)..HEAD -- scripts/db-sandbox.sh | grep -c '^-[^-]' EXPECT: 0
  12. D7: the browser spec apps/app/e2e/shell/admin-sheets-list.spec.ts deletes (soft deletion) only the sheet ids it created in its own run, captured one by one; no statement of the spec can match a pre-existing sheet row.
  13. Browser proof on the sandbox: the spec proves the order by the true date (a draft save moves a sheet first), the name sort, the no-result state, the focus return, axe and no sideways scroll, in French and English at desktop and 375 px.
  14. Precision 4 and the go message: exact test results are kept in .claude/tasks/TODO.md and the documents, including the admin.spec.ts failures of BLK-015 and the pgTAP failures of 014_animals_relations and 021_sheet_verification_jobs on the accumulated sandbox; no suite that failed is called green anywhere. CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && grep -c "Bad plan. You planned 90 tests but ran 42" .claude/tasks/TODO.md EXPECT: at least 1
  15. BLK-015 and RR-13 stay separate, open tracks with their lines kept; RR-13's text is widened to the admin lists (rights and sheets) per D4; D5 is tracked as a later navigation improvement.
  16. Scope: nothing changed under crates/, scripts/db-trial*, apps/app/src/components/editor/, apps/app/src/components/catalogue/, GrantList; admin.spec.ts changed only by the two locator rewrites. CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && [ -z "$(git diff --name-only $(git rev-parse 2277e41^)..HEAD -- crates 'scripts/db-trial*' apps/app/src/components/editor apps/app/src/components/catalogue apps/app/src/components/admin/GrantList.tsx)" ] && echo SCOPE_OK EXPECT: SCOPE_OK
  17. Documents as built: the R3 section of V1-2-6_U1_CORRECTIONS.md, the SQL checkpoint status, the owner trial procedure in French (V1-2-6_OWNER_TRIAL.md §4.15), M9 in V1-2_ANATOMICAL_SHEETS.md, SUPABASE.md, BROWSER_TESTS.md, the Rust exception rows, docs/design/README.md (deviations), CLAUDE.md, CHANGELOG.md.
  18. No merge, no deploy, DEV unchanged; the trial stack changed only by the authorised pnpm db:trial migrate (backup first).

FILE SCOPE

supabase/migrations/20261116100000_sheet_admin_last_modified.sql, supabase/tests/022_sheet_admin_reads.sql, scripts/db-sandbox.sh, packages/supabase/{src/sheets.ts,tests/sheets-admin.test.ts}, apps/app/src/{admin/sheetList.ts,admin/labels.ts,catalogue/useCatalogue.ts,components/admin/ModifiedDate.tsx,app/routes/app/admin/{AdminSheetsRoute,AdminHomeRoute}.tsx,i18n/{fr,en}.ts}, apps/app/tests/, apps/app/e2e/{shell/admin-sheets-list.spec.ts,support/admin.ts} and the three locator call sites, docs/, CLAUDE.md, CHANGELOG.md, .claude/tasks/**.

Verification 2026-11-16 (fresh verifier, range 98178de..bcdacbb)

  • VERDICT: ECARTS(1). Criteria 1-3 and 5-18 MET. Criterion 4 NOT-MET on its CHECK line only: the oracle greps the one-line literal last_modified_at: z.string().datetime({ offset: true }), which the fix wave (374e300, security LOW 3) split over four lines and made stricter with .refine(Date.parse). The verifier judged the behaviour in place and stricter (both call sites pass last_modified_at, <time> same instant, refusal tests 205-216 pass) and left the oracle to the human gate.
  • Controller ruling (superseded by the closure below; not a verifier verdict): the CHECK line is a defective oracle written by the controller before the security fix; it stays as written above. A layout-insensitive equivalent, run 2026-11-16 at bcdacbb, prints the expected marker: sed 's#//.*$##' packages/supabase/src/sheets.ts | tr -d ' \n' | grep -q "last_modified_at:z.string().datetime({offset:true}).refine((value)=>!Number.isNaN(Date.parse(value)))" && ! grep -rn "ModifiedDate iso={[^}]*\(updated_at\|created_at\)" apps/app/src && echo DATE_SOURCE_OK → DATE_SOURCE_OK The owner decides whether criterion 4 is closed on that basis.

Verification closure 2026-11-16 (after the owner trial)

  • Criterion 4: the CHECK line is now the layout-insensitive equivalent recorded above. Run 2026-11-16 at 6d2ba0d: DATE_SOURCE_OK. Criterion 4 MET (behaviour unchanged since the fix wave 374e300; the oracle was the defect).
  • Owner message « filtres repliables »: collapsible panel on a phone (9efc7b7), spec 6d2ba0d. The double announcement is fixed (the filter-only empty line is no longer a role="status", the count line announces once).

Owner validation 2026-11-16 (R3 closed)

  • The owner tested the phone filters panel on db:trial and validated R3 officially, its last phone improvement included. « Réinitialiser les filtres » stays inside the panel only; no other button. Final state 5774d52 plus this record: pnpm check:all exit 0 at a50796b; BLK-015, RR-13 and the pgTAP 014 / 021 results on the accumulated sandbox stay open in their own tracking. No merge, no deploy, DEV unchanged.