docker-compose.yml

services:
  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      # PRODUCTION: override all three values in .env before the first database start.
      POSTGRES_USER: ${POSTGRES_USER:-admin}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-admin}
      POSTGRES_DB: ${POSTGRES_DB:-main_db}
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 10
    networks:
      - app-network

  server:
    build:
      context: ./backend
      dockerfile: Dockerfile
    restart: unless-stopped
    environment:
      DATABASE_URL: postgresql+asyncpg://${POSTGRES_USER:-admin}:${POSTGRES_PASSWORD:-admin}@db:5432/${POSTGRES_DB:-main_db}
      # PRODUCTION: JWT_SECRET_KEY must be a persistent random value from .env.
      JWT_SECRET_KEY: ${JWT_SECRET_KEY:-}
      JWT_EXPIRE_MINUTES: ${JWT_EXPIRE_MINUTES:-0}
      SESSION_MAX_AGE_SECONDS: ${SESSION_MAX_AGE_SECONDS:-315360000}
      # Keep true behind Caddy HTTPS. Use false only for local plain-HTTP development.
      COOKIE_SECURE: ${COOKIE_SECURE:-false}
      SQL_ECHO: ${SQL_ECHO:-false}
      REGISTRATION_ENABLED: ${REGISTRATION_ENABLED:-true}
      UPLOAD_DIR: /data/uploads
      ROOT_PATH: /api
    volumes:
      - uploads:/data/uploads
      - ./backend/uploads:/legacy-uploads:ro
    expose:
      - "8000"
    depends_on:
      db:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/system/health-check', timeout=3)"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 5s
    networks:
      - app-network

  frontend:
    build:
      context: ./frontend
      dockerfile: Dockerfile
      args:
        VITE_API_BASE_URL: /api
    restart: unless-stopped
    expose:
      - "80"
    depends_on:
      server:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1/"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - app-network

  caddy:
    image: caddy:2-alpine
    restart: unless-stopped
    environment:
      # PRODUCTION: DOMAIN must resolve publicly to this server before Caddy starts.
      DOMAIN: ${DOMAIN:-localhost}
    ports:
      # PRODUCTION: forward TCP 80/443 (and optionally UDP 443) from the router.
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
    depends_on:
      frontend:
        condition: service_healthy
    networks:
      - app-network

volumes:
  pgdata:
  uploads:
  caddy_data:
  caddy_config:

networks:
  app-network:
    driver: bridge