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
+205
View File
@@ -0,0 +1,205 @@
# River Of Life Christian Church In Arcadia
# 教會管理系統 — 理事會報告
**報告日期:** 2026 年 5 月 24 日
**系統名稱:** ROLAC Church Management System
**目標上線:** 2026 年 6 月(第一階段)
---
## 一、為什麼需要這套系統?
| 目前痛點 | 系統解決方案 |
|----------|-------------|
| 教友資料分散於多份 Excel | 集中管理,隨時查詢 |
| 奉獻記錄手工計算,容易出錯 | 系統自動加總,月底一鍵對帳 |
| 年底收據需人工製作 | 自動產生 IRS 合規 PDFEmail 寄出 |
| 支出報銷流程不透明 | 線上申請、財務審核、留存記錄 |
| 教會網站資訊無法即時更新 | 行政同工自行發佈消息,無需工程師 |
---
## 二、系統架構概覽
系統分為三個部分,**全部使用同一套系統管理**:
```
┌─────────────────────────────────────────────┐
│ rolac.org(教會公開網站) │
│ 供訪客、慕道友瀏覽 │
├─────────────────────────────────────────────┤
│ 後台管理系統(行政、財務、事工負責人使用) │
├─────────────────────────────────────────────┤
│ 教友 App(手機 App,教友查看個人資訊) │
└─────────────────────────────────────────────┘
```
**支援語言:** 英文 + 繁體中文雙語切換
**支援設備:** 電腦、平板、手機(iOS + Android App
---
## 四、開發階段規劃
---
### 🏗️ 準備階段(現在 → 6 月初,約 2 週)
> 建立技術基礎,為所有功能打地基。教友不會直接感受到,但這是系統能正常運作的前提。
**主要工作:**
- 架設雲端伺服器
- 建立系統骨架與帳號安全機制
- 設定自動部署流程
---
### 🚀 第一階段(Phase 1)— 目標 2026 年 6 月上線
> **核心目標:** 網站上線 + 教友資料數位化 + 財務透明化
#### 📌 功能 1:教會官方網站(rolac.org
| 功能 | 說明 |
|------|------|
| 教會首頁 | 歡迎頁面、教會簡介、異象 |
| 主日資訊 | 聚會時間、地點、Google Maps |
| 消息公告 | 行政同工自行發佈,雙語顯示 |
| 講道影片 | 嵌入 YouTube 最新講道 |
| 聯絡表單 | 訪客留言,通知指定同工 |
**誰受益:** 訪客、慕道友、全體教友
---
#### 📌 功能 2:教友管理
| 功能 | 說明 |
|------|------|
| 教友資料建檔 | 姓名(中英)、照片、聯絡資料、受洗日期 |
| 家庭單元 | 一個家庭多位成員,清楚呈現家庭關係 |
| 教友狀態 | 會員 / 訪客 / 前會員 分類管理 |
| 搜尋篩選 | 按姓名、狀態、事工快速搜尋 |
| 事工歸屬 | 記錄每位教友參與的事工部門 |
**誰受益:** 牧師、行政秘書、各事工負責人
---
#### 📌 功能 3:財務管理(奉獻 + 支出 + 月結)
**奉獻記錄**
| 功能 | 說明 |
|------|------|
| 主日奉獻快速錄入 | 財務同工開袋後逐筆輸入,系統即時加總,最後核對實收金額 |
| 支付方式 | 現金、支票(含支票號碼)、Zelle、PayPal |
| 個人奉獻查詢 | 教友可在 App 查看自己的歷年奉獻記錄 |
| **年度奉獻收據** | 年底自動產生 IRS 合規 PDF,Email 寄給每位教友 |
**支出記錄**
| 功能 | 說明 |
|------|------|
| 廠商付款 | 直接記錄(如:愛宴外燴支票),含支票號碼 |
| 同工代墊報銷 | 同工提交申請 + 拍收據照片 → 財務審核 → 標記已還款 |
| 支出分類 | 依事工部門 + 類別(餐飲、設備、教材…)分類 |
**月底對帳**
| 功能 | 說明 |
|------|------|
| 收支月結報表 | 期初餘額 + 奉獻收入 − 各項支出 = 帳面結餘 |
| 銀行對帳 | 輸入銀行對帳單餘額,系統顯示差異,目標為零 |
**誰受益:** 財務同工、牧師、理事會
---
### 📦 第二階段(Phase 2
| 功能模組 | 說明 |
|----------|------|
| **服事表排班** | 各事工排班、自動提醒(服事前 3 天通知)、缺席替換 |
| **主日出席統計** | 每週記錄大人 / 青少年 / 兒童人數,產生趨勢圖 |
| **小組管理** | 管理小組架構、組長指派、小組聚會出席記錄 |
### 📦 第三階段(Phase 3
| 功能模組 | 說明 |
|----------|------|
| **事工預算** | 各事工年度預算設定,對比實際支出,超支自動警示 |
### 📦 第四階段(Phase 4
| 功能模組 | 說明 |
|----------|------|
| **線上奉獻** | 網站直接刷卡奉獻(Stripe)、定期自動扣款 |
### ⏸️ 暫緩功能(未來再評估)
| 功能模組 | 說明 |
|----------|------|
| **敬拜歌曲庫** | 詩歌歌詞管理、敬拜歌單規劃(待 CCLI 版權確認後排入) |
| **事工報表** | 教友成長趨勢、出席率、奉獻摘要圖表 |
| **廣播通知** | 向全體或特定事工群發 Email / 推播 / 簡訊 |
---
## 五、各事工部門對應
以下 10 個事工部門已納入系統,各部門負責人擁有專屬的資料存取權限:
| 事工部門 | 可管理的資料 |
|----------|-------------|
| 行政 | 全教友資料、財務報表 |
| 講道 | 自身服事排班 |
| 司會 | 自身服事排班 |
| 敬拜 | 服事排班、敬拜歌曲庫 |
| PPT/影音 | 服事排班、影音設備支出 |
| 音控 | 服事排班 |
| 場地組 | 服事排班、場地支出 |
| 招待 | 服事排班 |
| 兒牧 | 自身教友資料、兒童出席 |
| 餐飲 | 服事排班、餐飲支出(愛宴) |
---
## 六、用戶角色與權限
不同角色的同工看到的功能不同,**確保敏感資料只有授權人員可查看**:
| 角色 | 可查看的資料範圍 |
|------|----------------|
| 牧師 | 全部,含財務摘要 |
| 理事 | 教友概覽、財務摘要(唯讀)|
| 同工會主席 | 教友資料、服事排班、小組管理、報表 |
| 事工領袖 | 僅限自身事工的教友與排班資料 |
| 區長 | 轄下小組的教友資料 |
| 小組長 | 自身小組成員資料 |
| 財務同工 | 全部奉獻與支出記錄 |
| 行政秘書 | 教友資料、排班管理 |
| 同工 | 自身事工資料、可申請費用報銷 |
| 一般教友 | 個人資料、個人奉獻記錄、公開服事表 |
---
## 七、里程碑時間表
```
Phase 0 → Phase 1 → Phase 2 → Phase 3 → Phase 4
準備 上線 服事/ 預算 線上
建設 網站+ 小組管理 奉獻
教友+
財務
```
| 里程碑 | 階段 |
|--------|------|
| 伺服器建置完成 | Phase 0 |
| 教會網站上線(rolac.org| Phase 1 |
| 教友管理系統上線 | Phase 1 |
| 財務記錄系統上線 | Phase 1 |
| 服事表 + 小組管理 | Phase 2 |
| 事工預算 | Phase 3 |
| 線上奉獻 | Phase 4 |