fst-e2e-critical-flows
Safe Playwright E2E patterns for Otgruzka — test env writes, production read-only unless explicitly allowed.
SKILL.md.cursor/skills/fst-e2e-critical-flows/SKILL.md
GitHubfst-e2e-critical-flows
Критические пользовательские цепочки. Production: по умолчанию только read-only проверки.
Environments
| Env | Data writes |
|---|---|
| Production Vercel | Read-only (login, navigate, assert visible state) unless user explicitly allows test writes |
Local npm run dev |
Same Firebase/SQL as prod — treat as prod data; prefer dedicated test accounts |
| Future CI test project | Only place for create/cleanup test entities |
Critical flows (read-safe on prod)
- Login — Firebase Auth
otgruzka-tovara(use test/sysadmin account only) - Navigate —
#/month,#/warehouse,#/hr,#/tasksload without console errors - Read store — tables render rows, sync indicator not error-stuck
- Print preview — open print modal, no crash (don't submit post)
Write flows (test env / explicit permission only)
Pattern:
login → navigate → create test entity (unique prefix E2E-<timestamp>) → save
→ assert SQL/post-condition via UI or test API
→ assert journal entry in #/journals
→ reload → state persists
→ cleanup: delete/archive only records created by test
Domains requiring fst-domain-invariants review before write tests:
- Timesheet cell edits (month close)
- Warehouse document post
- HR employee create
- Finance advance post
Playwright conventions (when adding tests)
- Project folder: prefer
e2e/ortests/e2e/(create when user requests automation) storageStatefor auth — never commit credentials file- Selectors:
data-coach, role, label — avoid brittle CSS - Screenshot on failure only
Post-conditions
| Change type | Check |
|---|---|
| Store mutation | Journal #/journals filter by action |
| Warehouse doc | Document status posted + movement row |
| Timesheet | Cell value after F5 |
Cleanup rules
- Delete only entities with test prefix created in same run
- Never
clear:*/ bulk wipe - Never import local JSON to SQL
Related
- Prod UX verify:
otgruzka-browser-verify - Pre-implementation:
project-guardian - Post-implementation:
product-verifier