FRD · 功能需求文件

---
doc_type: "frd"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
  required: ["prd", "business-rules"]
  optional: ["data-model"]
---

# Functional Requirements: <product-or-epic-name>

**Status:** Draft v0.X · **Owner:** <BA name> · **Last updated:** YYYY-MM-DD

> [!IMPORTANT]
> **AI 填寫規則：** 本範本 5 段（編號 1, 2, 4, 10, 12），全部必填——刻意沿用完整版章節編號讓兩版可對照。每個欄位必含 type / required / validation；每條規則必含 rule ID + 觸發條件 + 動作；每結論行內 `（依據：PRD §X / BR-NNN）`；缺資料寫 `_TODO: 需要 XXX_` 不編造。

---

## 1. Executive Summary

<!-- ai-fill: 3-5 行：本 FRD 拆出 N 個功能模組、M 條 business rule、最高風險的 exception 情境 -->

<3-5 行說明>

> **TL;DR:** <一句話：本 FRD 把 PRD 哪一段拆成多少個可實作模組>

---

## 2. Functional Modules

<!-- ai-rule: 輕量版只列 P0 模組，2-4 個為宜。每個模組必含 input / output / 規則 / 相依 四件 -->

### FN-1: <module-name> · **P0** · **[H]**

- **Description:** <一句話>
- **Input fields:**

| Field | Type | Required | Validation | Default | Source |
|---|---|---|---|---|---|
| <field-a> | string | yes | regex `^...$` (BR-001) | `_` | PRD §FR-1 |
| <field-b> | int | yes | range 1-100 | `1` | PRD §FR-1 |

- **Output:**
  - **Success:** `{ id: uuid, status: "ok" }`
  - **Error:** `{ code: "VAL-001", message: i18n key, retryable: false }`
- **Processing rules:** BR-001, BR-002
- **Dependencies:** upstream `<auth-service>` · downstream `<event-bus>` · data `<orders 表>`
- **Source:** PRD §FR-1

### FN-2: <module-name> · **P0** · **[M]**

...

---

## 4. Business Rules（必要規則）

<!-- ai-rule: 每條規則必含 rule ID + when/then 條件 + exception。互斥規則須在 statement 明示 -->

| ID | Statement | Decision table / branches | Exceptions | Priority | Source |
|---|---|---|---|---|---|
| BR-001 | When <input> then <action> else <reject> | <參考表格或 N/A> | <例：admin 可繞過> | **must** | PRD §business rule |
| BR-002 | ... | ... | ... | **should** | ... |

---

## 10. Decision Log（key 1-2 條）

<!-- ai-rule: 每條必含 chosen + 至少 1 個 rejected option + 拒絕原因 -->

| Date | Decision | Options | Chosen | Rejected why |
|---|---|---|---|---|
| YYYY-MM-DD | <例：欄位 X 為何設為 required> | required / optional / 條件式 | required | optional (下游無法處理 null)、條件式 (規則過複雜) |

---

## 12. Confidence & Sources & TODO

- **最低 confidence 項：** <列出所有 [L] 與 [M]>
- **Fabricated assumptions（推測但 input 未明說）：**
  - <假設 1，例：上游 API 穩定性>
- **Highest-value next input:** <合規條款全文 / 上游 API spec / 既有欄位字典 三選一>

### TODO（缺資料）

- _TODO: 需要 XXX 補 BR-002 的 exception 處理_

---

> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 5 段 H2 章節齊全（編號 1, 2, 4, 10, 12，刻意不連號）
> - [ ] 每個 FN 含 input / output / 規則 / 相依 四件
> - [ ] 每個欄位含 type / required / validation 三件
> - [ ] 每條 BR 含 rule ID + when/then + exception
> - [ ] 每結論帶 `[H/M/L]` badge + `（依據：...）` 行內引用
> - [ ] Decision Log ≥ 1 條，每條有 rejected reason
> - [ ] 無 YAML / JSON schema 輸出（FRD 是給人讀的 markdown）