القائمة
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 المهني
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.
| 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.