docs(release-cleanup): 補齊 CI workflow 註解、統一日誌格式並重建 README

- .gitea/workflows/ci.yaml、cd.yaml:新增用途/更新日期區塊與逐行註解(指令邏輯不變)
- app/index.js:日誌統一為 [等級][台灣時間]: 訊息(新增 timestamp helper,INF/WRN/ERR;行為、控制流、exit code、stdout/stderr 皆等價)
- README.md:重建專案列表三表/功能列表/使用範例,新增日誌格式說明與 timestamp 功能

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jeffery
2026-06-30 18:03:10 +08:00
co-authored by Claude Opus 4.8
parent cee5b2f67f
commit 15381d07a7
4 changed files with 124 additions and 31 deletions
+20
View File
@@ -1,12 +1,32 @@
# 用途:本檔為 Gitea CD(持續部署)工作流程設定。
# 當 master 分支有 push 時自動觸發,使用公司 Gitea 上的
# composite action「release-tag-version」對建置成品進行釋出與版本標註(tag)。
# 更新日期(台灣時區 Asia/Taipei):2026/06/30 16:44:09
# 工作流程名稱,顯示於 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 }}