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>
This commit is contained in:
Chris Chen
2026-05-24 20:54:10 -07:00
commit 9b28fbcfb6
11 changed files with 4215 additions and 0 deletions
+115
View File
@@ -0,0 +1,115 @@
# 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** 本文件已納入規劃