# =============================================================================
# 用途：CD（Continuous Delivery）持續交付 workflow。
#       當有 commit push 到 master 分支時觸發，呼叫 release-tag-version
#       composite action 進行「釋出並標註正式成品版本」（建立 release / 打 tag），
#       將 master 上的成果標記為一個正式可發布的版本。
# 更新日期：2026/06/29 14:18:26
# =============================================================================

# workflow 顯示名稱，會出現在 Gitea Actions 的 workflow 清單與執行紀錄中，方便辨識。
name: CD
# 觸發條件：監聽 push 事件。
on:
  push:
    # 只在指定分支發生 push 時觸發，避免其他分支誤觸發正式釋出流程。
    branches:
    # 僅限 master 分支：master 視為正式（穩定）分支，push 進來代表要正式釋出成品版本。
    - master
# 此 workflow 包含的 job 清單。
jobs:
  # job 識別碼：release-tag-version，負責釋出並標註成品版本。
  release-tag-version:
    # job 顯示名稱，呈現於 Actions 執行畫面，便於辨識此 job 的職責。
    name: Release Tag Version
    # 指定執行此 job 的 runner 標籤；使用 ubuntu runner 執行後續步驟。
    runs-on: ubuntu
    # 此 job 的執行步驟序列。
    steps:
    # 步驟名稱：釋出並標註成品版本（建立 release / 打版本 tag）。
    - name: 釋出並標註成品版本
      # 呼叫外部 composite action「release-tag-version」執行實際的釋出與 tag 標註邏輯。
      # 版本以變數 vars.ACTION_RELEASE_TAG_VERSION 釘選，確保使用指定版本的 action，
      # 避免上游 action 變動造成釋出行為不可預期。
      # 副作用：此步驟會在遠端建立 release 或推送版本 tag（正式釋出動作）。
      # 需人工確認：vars.ACTION_RELEASE_TAG_VERSION 變數需在 repo / org 層級正確設定，否則 action 解析會失敗。
      uses: https://gitea.jsc.idv.tw/composite-actions/release-tag-version@${{ vars.ACTION_RELEASE_TAG_VERSION }}