# 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
```

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 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.