jiantw83
9e71474bfb
What：PLAN、ANALYZE、DELIVER、MAINTAIN、REPO 五個目錄頁改由 wiki-repo CONTENTS 解析並透過 wiki-contents.sh upsert 寫入，內容頁仍各走自己的型別。MAINTAIN 只有 目錄頁，整個型別都在專用存取庫。 Why：目錄頁與內容頁不再同庫，跨庫沒有 wiki 連結語法可用，一律改 wiki-url 的絕對 網址。原本四處取網址都沒有退出碼分流，5 被讀成空字串就寫出空連結，7 被讀成 4 就 把活著的頁當成沒寫成。 How：plan 與 analyze 會上階段鎖，而寫入閘門只看鎖不看路徑，所以流程要產的列檔與 暫存檔會被自己的閘門擋掉。兩支的限制段明寫這些檔一律用 heredoc 或 mktemp 產出。 wp-gate.sh 讀的是分析內容頁，維持走 ANALYZE，原地註明不得改成 CONTENTS。 Who：jsc-sdlc
13 lines
1.4 KiB
Markdown
13 lines
1.4 KiB
Markdown
# 交付目錄
|
|
|
|
> 存放位置：本頁是目錄頁，落在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫（沒設定就退回 `JSC_WIKI_REPO`，都沒設定就停）。交付頁 `DELIVER_{HASH}` 住在 `JSC_WIKI_REPO_DELIVER` 那一邊，兩者不同存取庫。
|
|
> 寫入語意：一列代表一個工作包的交付。一律用 `jsc-gitea/tools/wiki-contents.sh upsert DELIVER 6 {HASH} {列檔} {本範本}` 單列寫回：該工作包已經有列就更新那一列，沒有才附加一列，整頁一起送出。禁止整頁覆蓋，也不得改動別人的列。
|
|
> 連結寫法：交付頁欄位放 `jsc-gitea/tools/gitea.sh wiki-url` 給的絕對網址。`[[...]]` 只在同一個 wiki 內解析，從本頁指過去會是死連結。
|
|
> HASH：由 `jsc-gitea/tools/hash-id` 對 `{owner}/{repo}` 加工作包編號（例 `plugins/sdlc#WP-01`）算出的完整 40 碼大寫十六進位，不截短、不加前綴。一個工作包一頁，彼此不覆蓋。
|
|
|
|
<!-- 交付欄：是 = 交付、交接工作包（WP-01），接手者要據此動工；否 = 實作類工作包。 -->
|
|
|
|
| 計畫名稱 | 工作包 | 交付 | 交付型別 | 交付頁 | HASH | 存取庫 | 交付時間 |
|
|
| --- | --- | --- | --- | --- | --- | --- | --- |
|
|
| {計畫名稱} | WP-01 {工作包名稱} | 是 | API 文件 | [{WP-01 工作包名稱}](https://{gitea 主機}/{owner}/{repo}/wiki/DELIVER_{HASH}) | {HASH} | {owner}/{repo} | {yyyy-MM-dd HH:mm:ss} |
|