docs(docs): V1-1.6 as built, D11 drawer only, closure inventory, DEV steps

Contract §11.8 and §15; D11 and U3 decided, D12 open; SUPABASE.md §3.3 gains
the rehearsed restore check and the owner's browser acceptance on DEV; browser,
test and frontend docs, design README, CLAUDE.md map.
This commit is contained in:
bchanot committed 2026-10-26 17:24:19 +01:00
1 parent 3e968eeeab
commit e215e9b2cb
7 files changed
+201 -28

No files matched your search

+13 -2
View File
@@ -8,7 +8,7 @@ Chromium only until V1-5. The suites live in `apps/app/e2e`.
| Command | Backend | Dev server | Content |
|---|---|---|---|
| `pnpm e2e:ui` | none | Vite on `127.0.0.1:5191` | `e2e/ui/dialog.spec.ts`: the D13 contract of the shared Dialog on a test page; `e2e/ui/local-tool.spec.ts`: the disclaimer, edit and replace dialogs on the real local-tool routes |
| `pnpm e2e:shell` | the isolated stack of `pnpm db:sandbox` | Vite on `127.0.0.1:5192` | `e2e/shell/shell.spec.ts`: sign-in, dashboard, the account photo confirmation, the phone drawer |
| `pnpm e2e:shell` | the isolated stack of `pnpm db:sandbox` | Vite on `127.0.0.1:5192` | `e2e/shell/shell.spec.ts`: sign-in, dashboard, the account photo confirmation, the phone drawer; `e2e/shell/clients.spec.ts`: the client journeys (V1-1.5); `e2e/shell/animals.spec.ts`: the animal and relation journeys (V1-1.6, contract §11.8) |
Each suite runs on two Chromium projects: `chromium-desktop` (1280 × 800) and
`chromium-375` (375 × 667, mobile viewport, touch). A test tagged `@phone`
@@ -29,7 +29,13 @@ CLI stack. Each test creates its own confirmed account through the sandbox's
GoTrue admin API (random address under `sandbox.local`, random password, a
fictitious display name, the profile locale of the test), and seeds the clean
avatar the worker would have produced (the `assets` row as postgres, the
object with the service key). `pnpm db:sandbox down` removes all of it.
object with the service key). Rows around the subject of a test (clients,
animals, relations) are written as postgres by `e2e/support/records.ts`,
every value quoted as an SQL literal. `pnpm db:sandbox down` removes all of it.
`pnpm db:sandbox e2e-shell <args>` passes its arguments to Playwright: one
spec file, `--project`, `--grep`. The animal suite removes its routes after
each test without waiting for them, so an answer still in flight when the last
check passed is dropped with the context instead of failing the test.
## 2. Prerequisites
@@ -114,6 +120,11 @@ suite needs Docker in the runner for the sandbox.
click has no opener to return to there; a keyboard opening always has one.
- The vitest suites (happy-dom) cover the React wiring of the dialogs only:
happy-dom has no top layer, no inertness and no dialog focusing steps.
- axe's target-size rule measures a control partly under the sticky top bar
as cut. Two phone states of the animal suite are reached at the bottom of a
long page (the client page after linking an animal, a refused duplicate);
they are scanned from the top of the page (`expectAccessibleFromTop`), where
nothing sits under the bar. The controls are 44 px high either way.
## 7. Adding a test