hoopscout-v3/docs/testing.md

Testing

All tests must run inside Docker containers.

Canonical Test Command

Run these commands from the repository root:

docker compose run --rm backend ruff check .
docker compose run --rm backend pytest
docker compose run --rm frontend npm test
docker compose config

Test categories

• Backend API tests use pytest and pytest-django.
• Backend linting uses ruff.
• Frontend unit tests use vitest.
• Docker Compose validation uses docker compose config.

The initial TDD coverage verifies authentication requirements, player filtering, default ranking, profile performance summaries, user roles, and frontend filter serialization.