db:
  image: postgres:15 # 使用 PostgreSQL 15 版的 Docker 映像檔
  container_name: app_db # 設定容器名稱，方便辨識
  environment:
    POSTGRES_USER: ${DB_USER:-postgres} # 資料庫使用者帳號，可由 DB_USER 環境變數指定，預設為 'postgres'
    POSTGRES_DB: ${DB_NAME:-app_db} # 資料庫名稱，可由 DB_NAME 環境變數指定，預設為 'app_db'
    POSTGRES_PASSWORD: ${DB_PASSWORD:-password} # 資料庫密碼，可由 DB_PASSWORD 環境變數指定，預設為 'password'
  healthcheck: # 健康檢查設定，確認資料庫服務是否正常運作
    test: [ "CMD-SHELL", "pg_isready -d ${DB_NAME:-app_db} -U ${DB_USER:-postgres}" ] # 檢查資料庫是否可連線，使用預設或指定的資料庫/使用者
    interval: 10s # 每 10 秒檢查一次
    timeout: 5s # 每次檢查的逾時時間
    retries: 5 # 失敗重試次數
  restart: unless-stopped # 容器停止後自動重啟，除非手動停止
  networks:
    - app_network # 將此容器加入 app_network 網路，方便與其他服務溝通
  volumes:
    - app_postgres_data:/var/lib/postgresql/data # 將資料庫數據持久化到 Docker Volume，避免容器移除後資料遺失
    - type: bind # 使用 bind mount 方式掛載
      source: ./database_init # 掛載本機端 ./database_init 資料夾 (請確保你的初始化腳本放在此處)
      target: /docker-entrypoint-initdb.d # 掛載到容器內 PostgreSQL 啟動時會自動執行 SQL/Shell 腳本的目錄
      consistency: cached # 快取一致性模式，提升效能
  command: > # 容器啟動時執行的命令，用於處理初始化腳本的換行符號及權限
    bash -c ' if command -v apt-get >/dev/null 2>&1; then # 檢查是否為 Debian/Ubuntu 系列系統
      apt-get update && apt-get install -y dos2unix # 安裝 dos2unix 工具
    elif command -v apk >/dev/null 2>&1; then # 檢查是否為 Alpine 系列系統
      apk add --no-cache dos2unix # 安裝 dos2unix 工具
    fi && find /docker-entrypoint-initdb.d -type f -name "*.sh" -exec sh -c '\'' # 尋找初始化目錄下的 .sh 腳本
      dos2unix "{}" 2>/dev/null || true # 轉換 Windows 換行符號為 Unix 格式 (忽略錯誤)
      chmod +x "{}" # 賦予腳本執行權限
    '\'' \; && exec docker-entrypoint.sh postgres ' # 執行 PostgreSQL 官方的入口點腳本

volumes:
  app_postgres_data: # 定義一個名為 app_postgres_data 的 Docker Volume，用來儲存 PostgreSQL 資料

networks:
  app_network: # 定義一個名為 app_network 的 Docker 網路，用於服務間的內部通訊