docs(docs): detail views board, uniqueness is the core's (SQL check gone since M5)

This commit is contained in:
bchanot committed 2026-11-22 22:39:54 +01:00
1 parent 39507709d6
commit 198548695c
1 file changed
+7 -2
+7 -2
View File
@@ -103,7 +103,7 @@ Les trois stratégies :
|---|---|---|---| |---|---|---|---|
| Marque de la catégorie interne | Son identifiant fixe `cat-access`, que seul le cœur crée, comme `view-main` (`create.rs:9`) | Clé `role` et `schema_version` 3 | Clé `role: navigation` | | Marque de la catégorie interne | Son identifiant fixe `cat-access`, que seul le cœur crée, comme `view-main` (`create.rs:9`) | Clé `role` et `schema_version` 3 | Clé `role: navigation` |
| Versions antérieures | Lisent la fiche, et voient une catégorie ordinaire (états ci-dessous) | Refusent la fiche, avec la même erreur qu'une clé inconnue : rien de plus explicite pour les versions déjà construites | Refusent la fiche dès le premier accès : point de non-retour (COMPATIBILITY §7) | | Versions antérieures | Lisent la fiche, et voient une catégorie ordinaire (états ci-dessous) | Refusent la fiche, avec la même erreur qu'une clé inconnue : rien de plus explicite pour les versions déjà construites | Refusent la fiche dès le premier accès : point de non-retour (COMPATIBILITY §7) |
| SQL | Aucune migration. L'unicité de l'identifiant est déjà contrôlée par le cœur (`validate.rs:397`) et par SQL (`20261010100000_sheet_document_schema_v2.sql:45`) ; un test pgTAP le prouvera | Contrainte `document_schema_version = 2` à élargir (précédent BLK-008) | Migration de U6 avancée : époque des règles, contrôles à l'enregistrement et à la publication | | SQL | Aucune migration. L'unicité de l'identifiant est tenue par le cœur : refus à l'insertion, et erreur `category.id.duplicate` (`validate.rs:397`) dans le verdict avant soumission et publication. SQL ne contrôle plus que la structure depuis `20261028110000` (correction du 2026-11-22) ; un test pgTAP vérifie qu'une fiche portant `cat-access` s'enregistre | Contrainte `document_schema_version = 2` à élargir (précédent BLK-008) | Migration de U6 avancée : époque des règles, contrôles à l'enregistrement et à la publication |
| Cœur Rust | Le lot vue, catégorie et accès, les refus d'édition | Second lecteur gardé à vie (un lecteur d'archives ne perd jamais une version), écriture v3, instantanés redescendus en v2 pour le lecteur N-1 | Clé, retrait dans les instantanés, élargissement du lecteur d'instantanés (lecteur de données utilisateur), preuves du §8 | | Cœur Rust | Le lot vue, catégorie et accès, les refus d'édition | Second lecteur gardé à vie (un lecteur d'archives ne perd jamais une version), écriture v3, instantanés redescendus en v2 pour le lecteur N-1 | Clé, retrait dans les instantanés, élargissement du lecteur d'instantanés (lecteur de données utilisateur), preuves du §8 |
| PDF et lecteur N-1 | Inchangés : l'instantané porte une catégorie ordinaire | À adapter | Retrait de la clé à prouver | | PDF et lecteur N-1 | Inchangés : l'instantané porte une catégorie ordinaire | À adapter | Retrait de la clé à prouver |
| Retour arrière après U2 | Possible | Impossible | Impossible | | Retour arrière après U2 | Possible | Impossible | Impossible |
@@ -129,9 +129,14 @@ Vérifications demandées pour le plan :
catégories `cat-access` des versions enregistrées de la sandbox, et sur DEV seulement avec votre accord. catégories `cat-access` des versions enregistrées de la sandbox, et sur DEV seulement avec votre accord.
- Création par le cœur seul : seul le lot vue, catégorie et accès la crée ; toute autre insertion d'une catégorie - Création par le cœur seul : seul le lot vue, catégorie et accès la crée ; toute autre insertion d'une catégorie
portant cet identifiant est refusée. portant cet identifiant est refusée.
- Unicité, suppression et modification : le doublon est refusé par le cœur et par SQL (test pgTAP) ; la suppression - Unicité, suppression et modification : le doublon est refusé par le cœur, à l'insertion et dans le verdict (SQL ne
contrôle plus que la structure depuis la migration `20261028110000`, voir la correction ci-dessous) ; la suppression
est refusée tant qu'un accès y est rangé ; la nouvelle version refuse de la renommer, la recolorer ou la supprimer ; est refusée tant qu'un accès y est rangé ; la nouvelle version refuse de la renommer, la recolorer ou la supprimer ;
le cœur la recrée au prochain accès si elle manque. le cœur la recrée au prochain accès si elle manque.
- Correction du 2026-11-22, trouvée en relisant le plan : les révisions 3 et 4 disaient l'unicité contrôlée aussi par
SQL. Cette vérification SQL a été retirée par la migration `20261028110000_sheet_review_workflow.sql` (V1-2 M5,
décision O22 : SQL garde la structure, le cœur juge les règles). La remettre serait une migration et une règle
métier en SQL : ce n'est pas proposé.
- Lecture et réécriture par l'application N-1 : un test de caractérisation, écrit et rendu vert sur le cœur actuel - Lecture et réécriture par l'application N-1 : un test de caractérisation, écrit et rendu vert sur le cœur actuel
avant tout changement, lit une fiche portant `cat-access` et des accès, la modifie, la réécrit et la relit. Le avant tout changement, lit une fiche portant `cat-access` et des accès, la modifie, la réécrit et la relit. Le
lecteur N-1 figé lit le PDF d'une telle fiche. lecteur N-1 figé lit le PDF d'une telle fiche.