# 分析：{計畫名稱}

> {PLAN 頁絕對網址}、{REPO 頁絕對網址} 由 `jsc-gitea/tools/gitea.sh wiki-url` 取得。
> 跨頁型連結一律用絕對網址：不同頁型可能落在不同存取庫，`[[頁名]]` 只在同一個 wiki 內解析。

- 頁名：`ANALYZE_{HASH}`
- HASH：`{HASH}`
- 對應計畫：[PLAN_{HASH}]({PLAN 頁絕對網址})
- 存取庫：`{owner}/{repo}`
- 來源分支：`origin/{使用者確認的分支}`（head sha：`{sha}`，取自遠端）
- 狀態：未完成 <!-- 未完成 | 已完成 -->
- 建立時間：{yyyy-MM-dd HH:mm:ss}

## 現況摘要

- 工作目錄：{關鍵檔案與結構摘要}
- 複用來源：[REPO_{HASH}]({REPO 頁絕對網址})（commit sha：`{sha}`）
- 複用決策：{複用哪些方法、端點、為什麼；不複用的原因}

## 未決項

<!-- 使用者尚未決定的項目；沒有就寫「無」。不得靜默消失。 -->

| 項目 | 影響 | 預設處理 | 待決定者 |
| --- | --- | --- | --- |
| {項目} | {不決定會怎樣} | {暫定做法} | {誰} |

## 工作分解結構（WBS）

`WP-01` 固定是交付、交接工作包，獨立成一包，不與實作合併；用到它規格的實作工作包相依於它。
交付型別於實作階段開工時確認（API 文件、由使用者輸入）。
資料來源欄記錄範例資料的出處：`真實：{source}` 或 `推論：無來源`。
PR 欄記錄該工作包的 PR 連結與編號；PR 未合併前不得開始下一個工作包。

| 編號 | 工作包名稱 | 交付 | 交付型別 | 相依 | 工時(h) | 天數 | 資料來源 | 工作證 | PR | 狀態 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| WP-01 | {交付、交接：規格與介面定義} | 是 | API 文件 | - | {h} | {d} | 真實：{source} | | | 未完成 |
| WP-02 | {實作類名稱} | 否 | - | WP-01 | {h} | {d} | 真實：{source} | | | 未完成 |
| WP-03 | {實作類名稱} | 否 | - | WP-01 | {h} | {d} | 推論：無來源 | | | 未完成 |

- 關鍵路徑：{WP-01 → WP-02 → ⋯⋯}，總天數 {d}
- 實作候補：{WP-02、WP-03、⋯⋯}

## 關鍵路徑（CPM）

甘特圖語法固定照 `references/cpm-chart.md`：`dateFormat YYYY-MM-DD` 配任意錨點日期、每個工作包一個 `id`、時長用整數小時、除第一個外全部 `after {上一個id}` 串接。**不得用 `dateFormat X` 或把工時換算成小數天數填進圖裡**，會炸出 `Invalid date`。

```mermaid
gantt
  title 關鍵路徑（單位：小時；錨點日期非真實排程，僅供相對呈現）
  dateFormat YYYY-MM-DD
  axisFormat %m-%d %H:%M
  section 關鍵路徑
  WP-01 {名稱} :crit, wp01, 2000-01-01, {h}h
  WP-02 {名稱} :crit, wp02, after wp01, {h}h
```

## 待辦事項（TDD）

### WP-01 {交付、交接工作包名稱}

- [ ] 盤點端點與參數：{對象}
- [ ] 產出規格與範例資料（標明真實、推論）
- [ ] 與使用者確認交付內容並產出交付文件

### WP-02 {工作包名稱}

- [ ] 撰寫 {對象} 的測試：{預期行為}
- [ ] 實作 {對象} 使測試通過
- [ ] 重構 {對象} 並保持測試綠燈