DraftForge Testing Infrastructure
Self-Updating
This skill documents live code. When modifying test infrastructure, update the relevant reference file.
To verify current state, read the source files referenced in each section.
Critical Rules
- Always use
data-testid selectors in Playwright tests and demos. Never use getByLabel, getByText, or getByRole('combobox') for element interaction. See playwright-fixtures.md for the full policy and exceptions.
- Use
postWithCsrf/patchWithCsrf for all POST/PATCH calls to DRF ViewSet endpoints (not test endpoints). See playwright-fixtures.md for CSRF handling.
Architecture Overview
Two-layer test data system:
- Data definitions (
backend/tests/data/) - Pydantic models (TestUser, TestOrganization, TestLeague, TestTeam, TestTournament)
- Populate functions (
backend/tests/populate/) - Create DB records from data definitions
Backend exposes /api/tests/* endpoints (TEST=true only) so Playwright can login, reset state, and create test-specific data.
Key Principle: Feature-Isolated Test Data
Each feature's E2E tests MUST use dedicated test data. Never reuse another feature's org/league/tournament.
See references/feature-isolation.md for the full pattern.
Running Tests
# Backend (Docker - use --entrypoint "" to bypass daphne)
docker compose -f docker/docker-compose.test.yaml run --rm --entrypoint "" backend \
python manage.py test app.tests.test_csv_import -v 2
# Playwright
just test::pw::headless # All tests
just test::pw::spec csv-import # Specific suite
just test::pw::ui # Interactive UI mode
# Full setup (down, update, build, populate, up)
just test::setup
# Repopulate test data only
just db::populate::all
Cacheops and Test State Resets
Django cacheops is active in the test environment (1-hour TTL for Organization, League, etc.). M2M changes (.add(), .remove(), .clear()) do NOT auto-invalidate cacheops cache.
When writing test reset endpoints or backend views that modify M2M fields:
from cacheops import invalidate_obj
org.admins.clear()
org.admins.add(admin_user)
invalidate_obj(org) # REQUIRED after M2M changes
Without invalidate_obj(), subsequent GET requests return stale cached data — a common cause of flaky E2E tests where state resets appear to not take effect.
See references/backend-test-endpoints.md for the full pattern.
Reference Files
| Reference | When to read |
|---|
| populate-system.md | Adding test data, new populate functions, understanding data models |
| playwright-fixtures.md | Writing E2E tests, using login fixtures, auth patterns |
| backend-test-endpoints.md | Adding new test API endpoints, understanding backend-frontend test bridge |
| feature-isolation.md | Creating dedicated test data for a new feature's E2E tests |
| playwright-config.md | Test runner config, projects, workers, sharding, timeouts |
| mobile-iteration-workflow.md | Iterating on mobile overflow / hydration regressions across the brand, ui-styling, i18n-react, playwright skills |
Quick Reference: Current Test Data
| Entity | Name | PK | steam_league_id |
|---|
| Org | DTX | 1 | - |
| Org | Test Organization | 2 | - |
| Org | CSV Import Org | 3 | - |
| Org | Events Test Org | 7 | - |
| League | DTX League | 1 | 17929 |
| League | Test League | 2 | 17930 |
| League | CSV Import League | 3 | 17931 |
| League | Events Test League | 7 | 17935 |
| User | PK | Role | Login fixture |
|---|
| kettleofketchup | 1001 | superuser | loginAdmin() |
| hurk_ | 1002 | staff | loginStaff() |
| bucketoffish55 | 1003 | regular | loginUser() |
| org_admin_tester | 1020 | org admin (org 1) | loginOrgAdmin() |
| org_staff_tester | 1021 | org staff (org 1) | loginOrgStaff() |
| league_admin_tester | 1030 | league admin | loginLeagueAdmin() |
| league_staff_tester | 1031 | league staff | loginLeagueStaff() |
| event_org_admin | 1080 | org admin (org 7) | loginEventAdmin() |
| event_player_1 | 1081 | regular | loginEventPlayer() |
NOTE: When this table drifts from source, read backend/tests/data/users.py and backend/tests/data/organizations.py for truth.