azionelab-v2/docs/testing.md

Testing

All tests should run inside Docker containers.

Canonical test command

docker compose run --rm backend python manage.py test
docker compose run --rm frontend npm run check
docker compose run --rm frontend npm run build
docker compose run --rm nginx nginx -t
docker compose config --quiet

Test categories

The test suite covers:

• Django model and API integration tests;
• Astro static type and template validation;
• production frontend build;
• NGINX syntax and upstream configuration validation;
• Docker Compose configuration validation.

All commands run in containers. The backend test container starts PostgreSQL through Compose; the frontend checks use the checked-in lockfile for reproducible installs.

After seeding, smoke-test /health/, /api/site/home/, and the public page through NGINX using the azionelab.org host. Also verify that an unknown host returns 404. Basic keyboard navigation, responsive layout, and accessible names require a manual browser pass until browser automation is added.