# Module Spec Template

## 1. 模組概要

- 模組名稱：
- 目標使用者：
- 問題定義：
- 成功指標（KPI）：

## 2. 範圍定義

- In scope：
- Out of scope：
- 與既有模組關係：

## 3. 架構與資料邊界

- API 入口（Admin / Editor / Runtime）：
- 主要 Entity：
- Directus / Native 歸屬（參照 Data Ownership Matrix）：
- revision 需求：
- 自動編碼規則（如 `EX+timestamp` / `VA+timestamp`）：
- 使用者可編輯欄位（只列可編輯）：

## 4. API 與 DTO

- 新增/調整端點：
- Request/Response DTO：
- 錯誤碼：
- 版本策略（是否影響 v1）：

## 5. Frontend 互動

- 使用流程（行銷視角）：
- 主要頁面與狀態：
- 中文化與簡化策略：

## 6. 驗收與測試

- 功能驗收案例：
- 回歸測試範圍：
- DoD：

## 7. 上線與回滾

- 發布步驟：
- 監控指標：
- 回滾條件：
- 回滾步驟：

## 8. 風險與假設

- 主要風險：
- 依賴與前置：
- 已採用假設：
