docs: deux concepts pour ce que la journée a appris
sign-in — comment un utilisateur passe de rien à une identité qui agit. La barrière, l'identifiant qui franchit une frontière de partition par l'URL, et surtout : la redirection vers le broker appartient à @ng-org/web, vérifié dans son bundle. Le polyfill ne la réimplémente pas ; ce qui lui revient est la seule chose qu'init() ne peut pas faire, écrire l'identifiant dans l'URL avant qu'il ne la lise. La feuille centrale dit pourquoi régler l'identité et se connecter sont deux actes séparés : l'un ne demande aucune session, l'autre en exige une, et les confondre bloque dans un sens et casse le partage en silence dans l'autre. Le piège encore vivant — une connexion abandonnée qui reste joignable — est consigné comme tel, non corrigé. e2e-harness — ce que chaque suite juge, et deux choses qu'un agent doit savoir avant de diagnostiquer : le raccourci qui pré-injectait l'identifiant dans l'URL a tenu deux défauts invisibles pendant des mois (un lien de téléchargement vers un 404 que rien ne servait, et une barrière inatteignable pour tout nouvel arrivant) ; et un tuyau devtools qui lâche tue une exécution sans que Playwright n'émette d'événement, ce qui ressemble à un défaut produit et n'en est pas. Le vocabulaire gagne settle, barrier, journey et batch. J'avais aussi introduit « hand-over » pour la redirection : retiré, c'est le mot de NextGraph qui l'emporte.
This commit is contained in:
@@ -0,0 +1,27 @@
|
||||
---
|
||||
type: overview
|
||||
summary: What each end-to-end suite judges, the shortcut that kept two defects invisible, and the failure mode that is not ours to fix
|
||||
triggers:
|
||||
keywords: [e2e, harness, playwright, chromium, journey, suite, profile, broker page, notebook, wallet profile]
|
||||
paths:
|
||||
- "packages/polyfill/e2e/**"
|
||||
vocabulary:
|
||||
- term: journey
|
||||
gloss: one named end-to-end story in the applicative suite, reported pass or fail as a whole
|
||||
not: [scenario, test case, spec]
|
||||
- term: batch
|
||||
gloss: one run of a suite, which mints its own physical user and discards the previous one
|
||||
not: [session, campaign]
|
||||
---
|
||||
|
||||
# e2e-harness — the suites, and what they can and cannot tell you
|
||||
|
||||
Three suites drive real browsers against the real broker and the real wallet application. They are the only place the emulation meets what it emulates, so a green unit suite says nothing about them.
|
||||
|
||||
They are also expensive and, on a machine whose network moves, unreliable in ways that look exactly like product defects. Most of what this concept holds exists so an agent does not spend hours diagnosing a product bug that is a transport failure — or, worse, trust a green run that measured nothing.
|
||||
|
||||
## Read first
|
||||
|
||||
- `knowledge_what-each-suite-judges` — which suite answers which question.
|
||||
- `rule_never-shortcut-the-sign-in` — the shortcut that hid a 404 and a regression at once.
|
||||
- `caveat_a-dropped-pipe-kills-a-run` — the failure mode that is not ours.
|
||||
Reference in New Issue
Block a user