hoopscout-v3/docs/runbook.md

Runbook

Common tasks

Apply migrations:

docker compose run --rm backend python manage.py migrate

Seed demo data:

docker compose run --rm backend python manage.py seed_demo_data

The seed command is idempotent and refreshes the synthetic scouting board.

Create an admin user:

docker compose run --rm backend python manage.py createsuperuser

Troubleshooting

• If the frontend shows an authentication error, sign in through http://localhost:8000/admin/ or DRF login first.
• If the frontend serves a blank page, check docker compose logs frontend. Cache permission errors should be resolved by the configured /tmp/angular-cache path; restart with docker compose up -d frontend.
• If the frontend loads but player data does not, confirm that frontend/proxy.conf.json is active and restart the frontend container.
• If backend startup fails, check database readiness with docker compose logs db.
• If dependencies change, rebuild with docker compose build --no-cache backend frontend.

Rollback

Revert the Git commit containing the change and rebuild containers. If local database state must also be reverted, restore a database dump or recreate the postgres_data volume for disposable data.

Emergency contacts

Not configured for the local MVP.