# ===================================================================
# 用途：本檔為 Gitea CD（持續部署）工作流程設定。
#       當 master 分支有 push 時自動觸發，使用公司 Gitea 上的
#       composite action「release-tag-version」對建置成品進行釋出與版本標註（tag）。
# 更新日期（台灣時區 Asia/Taipei）：2026/07/01 09:14:10
# ===================================================================

# 工作流程名稱，顯示於 Gitea Actions 介面，用以辨識此 CD 流程
name: CD
# 定義觸發此工作流程的事件
on:
  # 當有程式碼 push（推送）至指定分支時觸發
  push:
    # 限定僅特定分支的 push 才觸發
    branches:
    # 僅 master 分支（正式發布主線）push 時才執行此 CD 流程
    - master
# 定義此工作流程包含的所有 job（工作）
jobs:
  # job 識別代號：release-tag-version（釋出並標註版本）
  release-tag-version:
    # job 的顯示名稱，呈現於 Gitea Actions 執行畫面
    name: Release Tag Version
    # 指定此 job 執行所使用的 runner 標籤（ubuntu runner）
    runs-on: ubuntu
    # 定義此 job 依序執行的步驟清單
    steps:
    # 步驟名稱：釋出並標註成品版本
    - name: 釋出並標註成品版本
      # 引用公司 Gitea 上的 composite action「release-tag-version」執行釋出與打 tag。
      # 版本（@ 之後）由 Gitea 變數 vars.ACTION_RELEASE_TAG_VERSION 動態決定，
      # 便於集中管理所引用 action 的版本，不需修改本檔即可切換版本。
      # 需人工確認：此 action 之具體釋出/標註行為與所需 secrets/權限，須參閱該 composite action 定義。
      uses: https://gitea.jsc.idv.tw/composite-actions/release-tag-version@${{ vars.ACTION_RELEASE_TAG_VERSION }}