菜单
Documents smoke test runbook, when to add tests, and Playwright selector pitfalls for simple-books. Use when running E2E tests, debugging flakes, or writing UI tests.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | playing-with-playwright |
| description | Documents smoke test runbook, when to add tests, and Playwright selector pitfalls for simple-books. Use when running E2E tests, debugging flakes, or writing UI tests. |
Default suite (serial, one DB + browser context): business-flow.spec.ts — bootstrap flow then lifecycle flow. Shared steps: sole-proprietor-flow.ts, lifecycle-flow.ts. Coverage grid: COVERAGE.md.
Requires an e2e production build (REFERENCE_DATE baked into the client bundle):
bun run build:e2e # REFERENCE_DATE=2026-05-18 bun run build
bun run test # ephemeral port, prod server, temp SQLite (migrate + seed)
Full local CI-style path (install + chromium):
bun run test:e2e
bun run test:e2e:quick # skip build when .output is fresh
README screenshots in docs/screens/ are opt-in only:
bun run screenshots
# equivalent: UPDATE_SCREENSHOTS=1 bun run test -- --grep @screenshots
Debug flakes:
bun run test -- --headed --debug
bunx playwright show-trace test-results/.../trace.zip
| Module | Use |
|---|---|
tests/e2e/helpers/ui.ts | waitForRoute, openModal, signUpOwner, visibleText |
tests/e2e/helpers/ledger.ts | IRS mileage rate, formatUsd, expected cash cents |
tests/e2e/helpers/auth.ts | E2E_OWNER credentials |
tests/e2e/COVERAGE.md | What is / is not tested |
NOT YET unless:
Prefer UI happy-path tests over unit tests for plumbing.
page.locator('form').getByRole(...)<motion.div> are not heading role: use getByText('…').first()#m-miles, #svc-name) or empty-state copy, not hydration timing/sign-up POST response before asserting /dashboardnetworkidle on SSR navigationsResponsive checklist: responsive-layout.
Documents Docker image build, Helm chart, release-please versioning, GitHub Actions CI, and K8s deploy constraints for simple-books. Use when deploying, releasing, adding CI workflows, or configuring production infrastructure.
Documents double-entry journal posting via postJournalSync, ACCT codes, and MVP recipes in simple-books. Use when adding business events, invoices, payments, mileage, reversals, or ledger entries.
Creates TanStack Start createServerFn RPC endpoints with requireAuthMiddleware and dynamic server imports in simple-books. Use when adding *.functions.ts files, server mutations, or fixing import-protection build errors.
Documents local and S3 attachment storage, upload API, and cleanup for simple-books. Use when working with file uploads, attachments, Garage/S3 config, or IRS retention.
Documents bootstrap sign-up, OIDC-only login when configured, and single-owner bootstrap in simple-books. Use when changing auth, login, OIDC env vars, or user access.
Adversarial security review for financial apps: novel and chained exploits, LLM-powered attacker tactics, auth/RPC/upload/ledger invariants, and bad secure-coding process. Use before merge on security-sensitive changes, when auditing auth, money, attachments, deployment, or when the user asks for threat modeling, penetration mindset, or codesec review.