Files
ROLAC/docs/REQUIREMENTS_REVIEW.md
T
Chris Chen 9b28fbcfb6 Initial commit: monorepo scaffold for ROLAC
- Add .gitignore covering C#/.NET and Angular/Node
- Add placeholder structure for API (C#) and APP (Angular)
- Add project docs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-24 20:54:10 -07:00

116 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 5API 預留擴展點 |
| — | 主日出席記錄 | ✅ | 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 4Stripe + PayPal Checkout
- Stripe Nonprofit 費率 1.5% + $0.30(需申請)
- Stripe Webhook 自動建立 Giving 記錄
- 定期奉獻:Stripe Subscription
- 詳見 PLANNING §3.6b
---
## 🆕 新增需求:敬拜歌曲庫(見 PLANNING §3.12
在本輪加入設計,詳見下方。
---
## 建議下一步
1. **確認 M1M4 四個缺漏** 是否要納入範疇
2. **W1W5 的細節補充** 可在進入該模組開發前再細化
3. **敬拜歌曲庫(§3.12** 本文件已納入規劃