ROLAC/docs/REQUIREMENTS_REVIEW.md

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） 本文件已納入規劃