# ROLAC — 需求稽核報告 (Requirements Review)

**稽核日期:** 2026-05-24  
**稽核基準:** 原始需求清單 + 後續對話確認的所有決策

---

## 稽核結果總覽

| 狀態 | 數量 |
|------|------|
| ✅ 已完整涵蓋 | 16 |
| ⚠️ 已涵蓋但細節不足（不影響開工） | 5 |
| ⏳ 暫緩（未來再評估） | 2 |
| ❌ 缺漏 | 0 |
| 🆕 新需求（本輪新��） | 1 |

---

## 原始需求清單稽核

| # | 需求 | 狀態 | 文件位置 | 備注 |
|---|------|------|----------|------|
| 1 | 教友管理 | ✅ | PLANNING §3.1 | 含家庭單元、標籤、生日提�� |
| 2 | 權限控管 | ✅ | PLANNING §3.2 + §4 | RBAC 矩陣完整 |
| 3 | 小組架構 | ✅ | PLANNING §3.3 | 樹狀結構、組長指派、出席 |
| 4 | 服事表 | ✅ | PLANNING §3.4 | Kendo Scheduler，衝突檢查 |
| 5 | 教會首頁 CMS | ✅ | PLANNING §3.5 | 雙語、SEO、草稿/排程 |
| 6 | 奉獻追蹤 | ✅ | PLANNING §3.6 | 現金/支票/Zelle/PayPal 手續費 |
| 7 | 年度收據 | ✅ | PLANNING §3.7 + IRS_RECEIPT.md | EIN 確認，QuestPDF |
| 8 | Audit Log | ✅ | PLANNING §3.8 | 完整欄位，不可刪除 |
| 9 | 多角色權限 | ✅ | PLANNING §3.2 + §4 | 9 個角色 |
| 10 | Ministry Scope | ✅ | PLANNING §3.10 | API Middleware 強制過濾 |
| 11 | 報表 | ✅ | PLANNING §3.9 | 6 種報表，Kendo Charts |
| 12 | 未來 AI 整合 | ✅ | PLANNING §3.11 | Phase 5，API 預留擴展點 |
| — | 主日出席記錄 | ✅ | PLANNING §3.3b | 大人/青少年/兒童三欄 |
| — | 雙語 EN/zh-TW | ✅ | PLANNING §6 + UI_ARCH | 全系統，含網站 |
| — | 敬拜歌曲庫 | 🆕 | PLANNING §3.12（待新增） | 本輪新需求 |

---

## ⚠️ 已涵蓋但細節不足（建議補充）

### W1 — 小組出席記錄（個人層級）
- **現況：** §3.3 只提到「出席記錄（每次小組聚會）」，未設計資料模型
- **缺少：** 每次聚會的個別成員出席/缺席記���
- **建議補充：**
  ```
  CellGroupMeeting
  ├── Id
  ├── CellGroupId
  ├── MeetingDate
  ��── Topic / Notes
  └── Attendances[]
      ├── MemberId
      └── IsPresent (bool)
  ```

### W2 — 訪客/新人跟進流程（Visitor Follow-up）
- **現況：** §3.1 有「訪客」狀態，§3.9 有「新人追蹤報表」
- **��少：** 具體的跟進工作流程（誰負責聯絡、記錄跟進次數、轉為會員的流程）
- **建議補充：** 簡單的 CareRecord 模型，組長/牧師可記錄每次跟進

### W3 — 活動報名表單（Event Registration）
- **現況：** §3.5 CMS 事件只提到「可連結報名表單」，實際並未���計
- **缺少：** 系統內的報名表單，或是否只用外部 Google Form / Jotform
- **建議決策：** 初期用外部表單連結即可，Phase 3+ 再考慮內建表單

### W4 — 廣播訊��（Broadcast Messaging）
- **現況：** 通知系統設計了個別觸發通知
- **缺少：** 管理員向「全體」或「特定小組/Ministry」發送群發通知的功能
- **建議補充：** Admin 界面新增「發送廣播」，選擇對象群組，透過 Email + Push + SMS 發送

### W5 — CCLI 版權合規
- **現況：** 沒有提到
- **缺少：** 教會通常需要 CCLI License 才能合法使用/投影/錄製詩歌
- **與新敬拜歌曲庫需求直接相關** — 見 §3.12

---

## ❌ 明確缺漏（需決策）

### M1 ~~— 禱告代禱管理~~ ✅ 已決定：納入 Phase 1
- 4 個可見範圍：Private / CellGroup / AllLeaders / Public
- 詳見 PLANNING §3.13

### M2 — 會員目錄 / 通訊錄（Member Directory）
- **說明：** 教友彼此可查看聯絡資訊的「教會通訊錄」App 功能
- **考量：** 隱私問題需要謹慎，需要教友明確 Opt-in 才顯示聯絡資料
- **建議：** 確認是否需要？

### M3 — 兒童/青少年事工特殊欄���
- **說明：** 兒童部門常需要：緊��聯絡人、過敏資訊、家長同意書、接送授權人
- **現況：** 3.1 教友資料沒有這些欄位
- **建議：** 在 Member 模型加 `ChildProfile` 子記錄，存放兒童特殊欄位

### M4 ~~— 線上奉獻整合~~ ✅ 已決定：Phase 4，Stripe + PayPal Checkout
- Stripe Nonprofit 費率 1.5% + $0.30（需申請）
- Stripe Webhook 自動建立 Giving 記錄
- 定期奉獻：Stripe Subscription
- 詳見 PLANNING §3.6b

---

## 🆕 新增需求：敬拜歌曲庫（見 PLANNING §3.12）

���在本輪加入設計，詳見下方。

---

## 建議下一步

1. **確認 M1–M4 四個缺漏** 是否要納入範疇
2. **W1–W5 的細節補充** 可在進入該模組開發前再細化
3. **敬拜歌曲庫（§3.12）** 本文件已納入規劃
