# 首頁公告管理：CC 道籍系統實作交接

日期：2026-08-22

正本規格：[`2026-08-22-announcement-management-spec.html`](2026-08-22-announcement-management-spec.html)

## 已建立的公告 Sheet

- 名稱：`峨眉道務平台－公告資料主表`
- Spreadsheet ID：`18I-CoOIfm_ebQk9W4OSuN5iqIcTuEPfmYxrAvgyJJLI`
- 連結：<https://docs.google.com/spreadsheets/d/18I-CoOIfm_ebQk9W4OSuN5iqIcTuEPfmYxrAvgyJJLI/edit>
- 建立狀態：六個分頁與欄名已核對，時區為 `Asia/Taipei`；尚未變更分享權限，也尚未連接正式 GAS／Google Sites。

CC 應將上述 Spreadsheet ID 寫入公告模組設定；若 CC 執行身分不是 Sheet 擁有者，須由平台管理者另行授予該執行身分最小必要權限。

## 目的

由 CC 統一實作道籍系統內的公告管理後台；Codex 負責 Google Sheet 資料契約、唯讀 GAS 公告模組、Google Sites 草稿嵌入與平台端驗證。兩端不得各自建立公告資料來源。

## CC 負責範圍

- 「道務平台管理」卡片及「公告管理」入口。
- 公告草稿、投稿、代編、審核、退回、預約發布、置頂、異動、下架及取消發布。
- 組長、區負責人、區文書、文書組、額外指定投稿者與平台管理員的角色範圍。
- 原稿、工作版本及發布版本的保存與操作紀錄。
- Google Sheet 的受控伺服端寫入。
- 每筆新投稿及異動申請的管理員 LINE 即時提醒。

## CC 不負責範圍

- Google Sites 頁面施工與發布。
- GAS 會員端公告列表、詳情或過往公告畫面。
- Drive 檔案搬移、複製、重新命名或分享權限變更。
- 中心「經理會議附件」資料夾同步。
- 班程報名及 Excel 名單彙整。
- Calendar。

## 固定資料契約

Google Sheet 為第一階段唯一公告資料來源，固定包含六個分頁：

- `公告`
- `公告版本`
- `公告附件`
- `公告資料夾`
- `公告操作紀錄`
- `公告異動申請`

每筆公告必須提供穩定的公告編號、狀態、原始版本號、工作版本號、發布版本號、投稿單位類型、投稿單位 ID、投稿單位名稱、發布時間、置頂截止時間、公告下架時間及可選填的活動／報名截止時間。`公告` 分頁按欄名讀寫，欄序可調整；其餘五個分頁須依正本第 7 節欄序建立。

所有時間欄由道籍系統以 ISO 8601 含 `+08:00` 寫入，例如 `2026-08-22T09:00:00+08:00`；GAS 依絕對時間解析。

附件與資料夾列均須包含公告編號及版本號。Drive 只保存正本；公告記錄只保存 Drive ID、顯示資料及權限檢查結果。

## 狀態規則

主要流程：

`草稿 → 待審核 → 退回修改／核准發布 → 已下架`

另保留「取消發布」。

- 投稿與異動送出後不得直接改變會員端內容。
- 平台管理員可保留原稿後代為編輯；代編說明必填。
- 文書組可協助代編，但不能自行發布。
- 置頂到期而公告仍有效時，公告轉為一般消息。
- 到達公告下架時間後，公告離開首頁並進入最近一年過往公告。
- 取消發布不進會員端過往公告，只保留後台紀錄。
- 長期公告可無固定下架日，但須設定下次檢視日，預設每三個月提醒。

## LINE 提醒

提醒只包含投稿單位、公告標題、待處理類型與道籍系統後台連結。不傳公告全文、附件、名單或個人資料。LINE 失敗不得改變投稿狀態。

## 平台端讀取邊界

GAS 只讀取狀態為「核准發布」、已到發布時間且未到公告下架時間的發布版本。發布時間邊界納入，下架時間邊界排除。會員端不取得投稿人 ID、審核人 ID、退回原因、操作紀錄或未發布版本。

平台端畫面已確認採：

- 3 則置頂＋3 則最新。
- 全部使用逐條橫式列表。
- 點擊公告後在同一 GAS 嵌入區切換詳情，提供返回列表。
- 會員可見發布、置頂截止、公告下架及活動／報名截止日期。
- 詳情閱讀順序為標題與單位、正文、日期、附件。
- Drive 檔案與資料夾以新分頁開啟。

## 變更規則

若 CC 需要改動欄位名稱、狀態值、版本規則或日期語意，須先更新正本規格並與平台端對齊；不得在道籍系統內另做一套只有 CC 知道的轉換規則。
