hoopscout-v3/docs/deployment.md

Deployment

The MVP supports local Docker Compose deployment only.

Local Environment

cp .env.example .env
docker compose up --build

Initialize the database:

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

Exposed Ports

• 8000: Django API and admin.
• 4200: Angular development server.

PostgreSQL is not published to the host.

During local development, the Angular dev server proxies /api, /api-auth, and /admin to the backend container.

Volumes

• postgres_data: PostgreSQL data.
• frontend_node_modules: frontend dependencies inside Docker.

Rollback

For code rollback, revert the relevant Git commit and rebuild the Compose services. For local data rollback, restore a database backup or remove the postgres_data volume if disposable demo data is acceptable.