# 定義 Docker 網絡，前端和後端分離以提高安全性
networks:
  frontend:  # 前端網絡，用於連接代理服務器和web服務
  backend:   # 後端網絡，用於內部服務之間的通信

# 定義持久化存儲卷
volumes:
  pgdata:    # PostgreSQL 資料庫數據存儲
  opdata:    # OpenProject 資產存儲

# 定義錨點(anchors)，用於在YAML中復用配置
x-op-restart-policy: &restart_policy
  restart: unless-stopped  # 容器自動重啟策略，除非手動停止

x-op-image: &image
  image: openproject/openproject:${TAG:-15-slim}  # 使用的鏡像，預設為15-slim版本

# 定義基本應用配置，所有OpenProject服務都會繼承這個配置
x-op-app: &app
  <<: [*image, *restart_policy]  # 引用前面定義的image和restart_policy
  environment:
    # HTTPS相關設置
    OPENPROJECT_HTTPS: "${OPENPROJECT_HTTPS:-false}"  # 是否啟用HTTPS，預設為true
    OPENPROJECT_HOST__NAME: "${OPENPROJECT_HOST__NAME:-localhost:3535}"  # 主機名，已修改為3535端口
    OPENPROJECT_HSTS: "${OPENPROJECT_HSTS:-true}"  # HTTP嚴格傳輸安全，預設啟用
    
    # 緩存和資料庫設置
    RAILS_CACHE_STORE: "memcache"  # 使用memcached作為緩存
    OPENPROJECT_CACHE__MEMCACHE__SERVER: "cache:11211"  # memcached服務地址和端口
    OPENPROJECT_RAILS__RELATIVE__URL__ROOT: "${OPENPROJECT_RAILS__RELATIVE__URL__ROOT:-}"  # 相對URL根路徑，如果部署在子路徑
    DATABASE_URL: "${DATABASE_URL:-postgres://postgres:p4ssw0rd@db/openproject?pool=20&encoding=unicode&reconnect=true}"  # 資料庫連接URL
    
    # 執行緒配置
    RAILS_MIN_THREADS: ${RAILS_MIN_THREADS:-4}  # 最小執行緒數
    RAILS_MAX_THREADS: ${RAILS_MAX_THREADS:-16}  # 最大執行緒數
    
    # 郵件設置
    IMAP_ENABLED: "${IMAP_ENABLED:-false}"  # 是否啟用郵件接收功能，預設關閉
  
  volumes:
    - "${OPDATA:-opdata}:/var/openproject/assets"  # 掛載資產存儲卷

# 定義具體服務
services:
  # PostgreSQL 資料庫服務
  db:
    image: postgres:13  # 使用PostgreSQL 13版本
    <<: *restart_policy
    stop_grace_period: "3s"  # 優雅停止時間
    volumes:
      - "${PGDATA:-pgdata}:/var/lib/postgresql/data"  # 掛載資料庫數據卷
    environment:
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-p4ssw0rd}  # 資料庫密碼
      POSTGRES_DB: openproject  # 資料庫名稱
    networks:
      - backend  # 連接到後端網絡

  # Memcached 緩存服務
  cache:
    image: memcached
    <<: *restart_policy
    networks:
      - backend

  # Nginx代理服務
  proxy:
    build:
      context: ./proxy
      args:
        APP_HOST: web  # 指定應用主機為web服務
    image: openproject/proxy
    <<: *restart_policy
    ports:
      - "${PORT:-3535}:80"  # 將容器的80端口映射到主機的3535端口，已修改
    depends_on:
      - web  # 依賴web服務
    networks:
      - frontend  # 連接到前端網絡

  # OpenProject Web服務
  web:
    <<: *app
    command: "./docker/prod/web"  # 啟動命令
    networks:
      - frontend  # 連接到前端網絡
      - backend   # 連接到後端網絡
    depends_on:
      - db
      - cache
      - seeder
    labels:
      - autoheal=true  # 啟用自動修復標籤
    healthcheck:  # 健康檢查配置
      test: ["CMD", "curl", "-f", "http://localhost:8080${OPENPROJECT_RAILS__RELATIVE__URL__ROOT:-}/health_checks/default"]
      interval: 10s
      timeout: 3s
      retries: 3
      start_period: 30s

  # 自動修復服務，用於重啟不健康的容器
  autoheal:
    image: willfarrell/autoheal:1.2.0
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock"  # 掛載Docker socket以控制容器
    environment:
      AUTOHEAL_CONTAINER_LABEL: autoheal  # 要監控的容器標籤
      AUTOHEAL_START_PERIOD: 600  # 啟動後等待時間(秒)
      AUTOHEAL_INTERVAL: 30  # 檢查間隔(秒)

  # 後台工作服務，處理異步任務
  worker:
    <<: *app
    command: "./docker/prod/worker"
    networks:
      - backend
    depends_on:
      - db
      - cache
      - seeder

  # 計劃任務服務，處理定時任務
  cron:
    <<: *app
    command: "./docker/prod/cron"
    networks:
      - backend
    depends_on:
      - db
      - cache
      - seeder

  # 資料填充服務，負責初始化資料
  seeder:
    <<: *app
    command: "./docker/prod/seeder"
    restart: on-failure  # 只在失敗時重啟
    networks:
      - backend