First-Run Validation¶

Purpose¶

Confirm your local environment is healthy enough for feature development.

When To Use This Page¶

• immediately after first setup
• after major dependency/runtime changes
• before starting high-impact implementation work

Validation Ladder¶

flowchart LR
    Config["Config Checks"] --> Schema["Schema Checks"]
    Schema --> Smoke["Smoke Tests"]
    Smoke --> Focused["Focused Module Tests"]

Core Commands¶

docker compose run --rm app python manage.py check
docker compose run --rm app python manage.py showmigrations
./scripts/run_smoke_tests.sh
./scripts/run_tests.sh

Functional Checklist¶

1. Login page loads.
2. Dashboard and project context load.
3. Requirements, scope, V&V, and ops pages render.
4. Celery worker responds to ping.
5. App/worker logs show no blocking exceptions.

Targeted Follow-up by Failure Type¶