freshyo/tests/web/README.md
2026-10-05 11:46:47 +05:30

47 lines
2 KiB
Markdown

# Web tests (Playwright) — superadmin-ui + region APIs
Browser/UI coverage for `http://localhost:4175` (superadmin-ui) plus
API-level region assertions against the backend. Complements
`tests/e2e/regions` (Maestro, mobile apps).
## Layout
```
tests/web/
playwright.config.ts # specs/, baseURL SUPERADMIN_URL, 1 worker
.env.example # copy to tests/web/.env (never commit secrets)
lib/helpers.ts # UI login, unique stamps, polygon builder
lib/trpc.ts # tRPC-over-HTTP helper (staffLogin, trpcCall)
specs/auth.spec.ts # login happy path + wrong password
specs/regions.spec.ts # regions list loads; create region (UI)
specs/regions-negative.spec.ts # API negatives: dup priorities/creds/name,
# pri 0, delete refusal, SEC 403/401
specs/admins.spec.ts # create admin (UI) + login as new admin
specs/resolution.spec.ts # read-only lat/lng resolution matrix (§2)
specs/consts-read.spec.ts # read-only essentialConsts shape per region
```
## Prerequisites
- Backend on `API_URL` (default `http://127.0.0.1:8787`) with region
migrations applied; superadmin-ui on `SUPERADMIN_URL` (default
`http://localhost:4175`).
- Playwright browsers: `npx playwright install chromium` (or reuse the
ms-playwright cache).
- `R1_ADMIN_NAME`/`R1_ADMIN_PASSWORD` (any non-superadmin staffer) for the
1.18 forbidden check; `TEST_BOT_TOKEN`/`TEST_CHAT_ID` for region creation
(any values; routing is asserted elsewhere).
## Run
```bash
cp tests/web/.env.example tests/web/.env # fill in passwords
# from the repo root:
npx playwright test --config tests/web/playwright.config.ts
# single file:
npx playwright test --config tests/web/playwright.config.ts regions
```
Note: `workers: 1` is deliberate — region creation is global mutable state.
Regions are non-deletable by design, so UI/API creation cases leave
timestamped `PW-*` regions behind (see `regions-negative.spec.ts` header).