docs(docs): R4 catalogue card integrity warning as built

This commit is contained in:
bchanot committed 2026-11-17 00:31:52 +01:00
1 parent dadd8e5d29
commit e1cdd9d25c
6 files changed
+185 -5

No files matched your search

+74
View File
@@ -599,6 +599,80 @@ Passez l'application en anglais si vous voulez relire les libellés (« Search a
Résultat du 16 novembre 2026 : essai fait par le propriétaire sur db:trial, panneau des filtres sur
téléphone compris. R3 est validé. « Réinitialiser les filtres » reste uniquement dans le panneau.
### 4.16 Démonstration R4 : les erreurs dans les cartes du catalogue
À faire sur la sandbox, avec `pnpm db:sandbox trial` (décision D3), pas sur `db:trial` : la pile d'essai n'a aucune
version publiée, son catalogue est vide. Planche 30 (`docs/design/v1-2-6-r0/30-catalogue-carte-integrite.png`),
libellé A10.
Préparation. La sandbox tourne déjà et garde les données des tests automatiques : ne lancez ni `up fresh` (refusé tant
qu'elle tourne) ni `down` (tout serait effacé). Créez votre compte comme à l'étape 2 si vous n'en avez pas sur cette
sandbox, puis donnez-lui le droit de lecture du catalogue :
```bash
pnpm db:sandbox trial-grant vous@example.com catalog_reader
```
Lancez l'application comme à l'étape 3 (`pnpm db:sandbox trial`, adresse en `:5193`) et connectez-vous. La double
authentification n'est pas nécessaire pour le catalogue. Ouvrez « Fiches anatomiques » dans le menu. La page est
lente à se remplir : la sandbox compte 164 fiches au catalogue et chaque carte charge sa version et son illustration
au moment où elle s'affiche.
Ce qui vient des données, pas de R4. Un relevé en lecture seule du 17 novembre 2026 a passé les 164 fiches du
catalogue au contrôle d'intégrité du moteur, comme le fait la carte. 160 passent et dessinent leur vue principale
(80 « Cheval publié … » et 80 « Cheval refusé … », laissées par les tests du catalogue). Quatre échouent, toutes du
même genre : les quatre fiches nommées « Cheval sandbox » (deux en version 1, deux en version 2). Leur empreinte
enregistrée est une valeur fictive (`aaaa…`), écrite par des tests qui imitent le service de vérification : le
moteur recalcule l'empreinte, elle ne correspond pas, la version est refusée. C'est l'anomalie de test A. Elle existait
avant R4, elle est suivie à part, et R4 ne la corrige pas : R4 change seulement la façon dont l'échec s'affiche. Avant
R4, ces quatre cartes se taisaient (nom, version et « Consulter », sans compteurs ni explication). Aucune autre fiche
ne devrait échouer ; si une autre carte montre une ligne d'erreur, notez son nom et son message.
Ce qui est propre à R4 : la ligne dans la carte, ce qui reste autour d'elle, et « Réessayer ». Chaque étape donne
l'action, puis l'attendu. Étapes 1 à 5 à 1 280 px, étape 6 sur un téléphone ou dans une fenêtre de 375 px.
1. Avant de chercher, notez le nom d'une carte saine, une carte « Cheval publié … » qui montre ses compteurs (vues,
zones de constats) et une vignette. Elle sert à l'étape 4.
2. Ligne d'intégrité. Action : tapez « sandbox » dans « Rechercher une fiche ». Attendu : exactement quatre cartes
« Cheval sandbox ». Chacune garde l'espèce, « Publiée », son nom et « Version 1 » ou « Version 2 », sans date de
publication (la date vient avec les détails qui n'ont pas pu être lus). À la place des compteurs et de la
vignette, une ligne rouge avec un triangle d'alerte, en gras : « Contrôle d'intégrité échoué : cette version ne
peut pas être affichée. » Pas de « Réessayer » : relancer ne changerait rien à la version. « Consulter » reste
en bas de la carte et répond à la souris comme au clavier (Tab puis Entrée).
3. La page de la fiche, inchangée. Action : « Consulter » sur une des quatre cartes. Attendu : la page de la fiche,
telle qu'avant R4, avec son message détaillé « L'empreinte de cette version ne correspond pas à celle enregistrée à
sa publication. » et son propre bouton « Réessayer » (la page propose de réessayer pour toute erreur, R4 n'y
touche pas). Revenez au catalogue (la recherche n'est pas gardée au retour, comportement connu).
4. Ligne réseau et « Réessayer ». Une carte ne charge sa version qu'au moment où elle s'affiche : couper le réseau
après coup ne change rien aux cartes déjà là. Il faut donc la faire disparaître puis réapparaître hors ligne.
Action : tapez « sandbox » (la carte saine de l'étape 1 disparaît). Ouvrez les outils de développement (F12),
onglet « Network » (« Réseau »), réglez « No throttling » sur « Offline ». Remplacez « sandbox » par le nom noté
à l'étape 1. Attendez environ 7 secondes : la lecture de la date est retentée trois fois avant d'abandonner, et la
carte attend la fin de ces essais. Attendu : la carte saine montre une ligne ambrée avec l'icône « pas de réseau »
et « Connexion au serveur impossible. Vérifiez votre réseau. », puis « Réessayer » et « Consulter ». Remettez
« No throttling » (en ligne), puis cliquez « Réessayer ». Attendu : pendant l'essai, la ligne et le bouton restent
en place ; puis la ligne disparaît, les compteurs et la vignette apparaissent, et le focus passe sur « Consulter »
de cette carte. Si vous cliquez « Réessayer » encore hors ligne, la ligne revient après environ 7 secondes et le
focus reste sur « Réessayer ».
5. Anglais. Action : passez l'interface en « EN » et refaites l'étape 2. Attendu : « Integrity check failed: this
version cannot be displayed. »
6. Téléphone (375 px). Action : refaites les étapes 2 et 4 à 375 px (sur un téléphone, l'étape 4 demande les outils
de développement d'un ordinateur : utilisez une fenêtre de 375 px ou le mode appareil des outils). Attendu : une
carte par ligne, la phrase passe à la ligne, « Réessayer » et « Consulter » font au moins 44 px de haut, aucun
défilement horizontal.
Écart connu, en attente de la revue graphique : à 1 280 px, la carte réseau empile « Réessayer » au-dessus de
« Consulter », alors que la planche 30 les dessine côte à côte (`docs/design/README.md`).
Limites connues de R4 :
- Si le moteur lui-même ne se charge pas, chaque carte affiche sa ligne « moteur » avec son propre « Réessayer » ; un
clic relance le moteur et recharge cette carte seulement, les autres attendent leur propre clic.
- Une date de publication qui n'a pas pu être lue manque sans message.
- Une version saine dont la vue principale ne peut pas être dessinée garde ses compteurs et affiche la phrase neutre
déjà utilisée par la page de la fiche (« Cette vue ne peut pas être affichée : … »). La sandbox n'a pas de cas de ce
genre aujourd'hui (relevé ci-dessus).
- Les fiches « R4 … » créées par le test automatique sont archivées à la fin de chaque passage : elles ne sont plus au
catalogue, mais restent dans la liste d'administration sous « Archivée ».
## 5. Limites à connaître
- Risque résiduel RR-12 : les opérations du catalogue lisent la mention `aal2` du jeton, pas la session vivante.
Un jeton émis à `aal2` reste accepté après la suppression du facteur, jusqu'à son expiration (une heure).