generated from bisco/codex-bootstrap
bisco
40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
# Runbook
|
|
|
|
## Common tasks
|
|
|
|
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
|
|
```
|
|
|
|
The seed command is idempotent and refreshes the synthetic scouting board.
|
|
|
|
Create an admin user:
|
|
|
|
```bash
|
|
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.
|