feat: bootstrap HoopScout scouting app

2026-06-03 21:37:15 +02:00
parent c4b1b6ee15
commit cc188468bc
52 changed files with 14505 additions and 126 deletions
@@ -1,19 +1,35 @@
 # Runbook

-Operational runbook for this project.
-
 ## Common tasks

-Document routine operational tasks here.
+Apply migrations:
+
+```bash
+docker compose run --rm backend python manage.py migrate
+```
+
+Seed demo data:
+
+```bash
+docker compose run --rm backend python manage.py seed_demo_data
+```
+
+Create an admin user:
+
+```bash
+docker compose run --rm backend python manage.py createsuperuser
+```

 ## Troubleshooting

-Document known issues, symptoms, checks, and remediation steps.
+- If the frontend shows an authentication error, sign in through `http://localhost:8000/admin/` or DRF login first.
+- 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

-Document rollback procedures here.
+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

-Document project-specific escalation paths if appropriate.
+Not configured for the local MVP.