# Deployment Guide

## Docker Compose Setup

Run the full stack locally or on a VPS:
```bash
# 1. Copy environment template
cp .env.example .env

# 2. Start services
docker compose up -d

# 3. Apply database migrations
docker compose exec api alembic upgrade head

# 4. Seed system roles & permissions
docker compose exec api python scripts/seed_plans.py

# 5. Create superadmin account
docker compose exec api python scripts/create_superadmin.py admin@yourdomain.com YourSecurePassword123!
```

## Scaling Individual Services
- Scale background workers:
  ```bash
  docker compose up -d --scale worker=4
  ```
- Scale API instances:
  ```bash
  docker compose up -d --scale api=3
  ```
