Chris Chen
9b28fbcfb6
- 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>
6.0 KiB
6.0 KiB
ROLAC — 年度奉獻收據 (IRS Annual Giving Statement)
文件版本: v0.1 (2026-05-24)
重要提示: 本文件為技術設計參考。正式收據的法律用語及符合性，請在發送前諮詢持牌會計師或稅務顧問。
法律背景
- ROLAC 為 IRS 501(c)(3) 免稅組織
- EIN:
42-2682968（儲存為環境變數CHURCH_EIN，不 hardcode） - 依 IRS 規定，單筆奉獻 $250 或以上 需提供書面確認
- 年度收據通常在每年 1 月 31 日前 寄出，供教友報稅使用
- 現金奉獻 若無同時期的銀行記錄，IRS 要求有組織的書面記錄
收據必要欄位（IRS 要求）
| 欄位 | 說明 |
|---|---|
| 組織全名 | River Of Life Christian Church In Arcadia |
| EIN | 42-2682968 |
| 教友姓名 | 依登錄姓名 |
| 奉獻年度 | 例：January 1 – December 31, 2025 |
| 奉獻明細 | 日期、金額、類型（每筆逐一列出） |
| 年度奉獻總計 | 所有非匿名奉獻的 Net Amount 加總 |
| 免稅聲明語 | 見下方標準語句 |
| 未提供商品或服務聲明 | 見下方標準語句 |
| 組織代表簽名 | 財務同工姓名、職稱、日期 |
標準免稅聲明語（中英雙語）
英文版（收據上必須包含）
River Of Life Christian Church In Arcadia is a tax-exempt organization
under Section 501(c)(3) of the Internal Revenue Code.
EIN: 42-2682968
No goods or services were provided in exchange for this contribution.
This letter serves as your official receipt for income tax purposes.
繁體中文版（附於英文後，供教友參考）
River Of Life Christian Church In Arcadia 為依據美國國稅局
第 501(c)(3) 條款登記之免稅組織。
稅務識別號碼 (EIN)：42-2682968
貴教友所奉獻之款項未換取任何商品或服務。
本信函作為您申報所得稅之正式收據。
PDF 收據版面設計
┌─────────────────────────────────────────────┐
│ [教會 Logo] │
│ River Of Life Christian Church In Arcadia │
│ [教會地址] | EIN: 42-2682968 │
├─────────────────────────────────────────────┤
│ Annual Giving Statement / 年度奉獻收據 │
│ Tax Year: January 1 – December 31, {Year} │
├─────────────────────────────────────────────┤
│ Prepared for: {Member Full Name} │
│ Date Issued: {Issue Date} │
├─────────────────────────────────────────────┤
│ Giving Detail / 奉獻明細 │
│ ───────────────────────────────────── │
│ Date Type Method Amount │
│ 2025-01-05 Tithe Check $500.00 │
│ 2025-01-05 Offering Cash $50.00 │
│ 2025-02-02 Tithe Zelle $500.00 │
│ ... │
│ ───────────────────────────────────── │
│ Total Contributions: $X,XXX.XX │
│ (PayPal fees are excluded) │
├─────────────────────────────────────────────┤
│ [免稅聲明語（英文）] │
│ [免稅聲明語（繁中）] │
├─────────────────────────────────────────────┤
│ Authorized by: {Finance Staff Name} │
│ Title: Church Finance │
│ Date: {Issue Date} │
└─────────────────────────────────────────────┘
金額計算規則
| 支付方式 | 收據金額 | 備注 |
|---|---|---|
| 現金 | Amount |
以信封記錄為準 |
| 支票 | Amount |
以支票金額為準 |
| Zelle | Amount |
以轉入金額為準 |
| PayPal | NetAmount（= Amount − FeeAmount） |
PayPal 手續費不計入可扣稅金額 |
| 匿名奉獻 | 不列入 個人收據 | 匿名奉獻無法與個人對應 |
系統流程
財務同工觸發 → 選擇年度
│
▼
系統查詢該年度所有
非匿名 Giving 記錄
│
▼
依 MemberId 分組加總
│
├── 產生個人 PDF（QuestPDF）
├── 上傳至 Azure Blob
│ receipts/{year}/{memberId}.pdf
└── Email 寄送給教友
（含 PDF 附件 + 語言偏好）
│
▼
記錄至 ReceiptLog
（誰產生、何時、寄送狀態）
資料模型補充
GivingReceipt
├── Id
├── MemberId
├── TaxYear (int, e.g. 2025)
├── TotalAmount (decimal)
├── PdfBlobPath (Azure Blob 路徑)
├── GeneratedAt
├── GeneratedByUserId
├── SentAt (Email 寄送時間，null = 未寄)
├── SentToEmail
└── IsVoided (bool, 作廢旗標)
重要注意事項
- 不要 hardcode EIN — 存於環境變數
CHURCH_EIN，設定頁面可修改 - 收據一旦發出即存檔 — 即使奉獻記錄事後修改，已發出的 PDF 不可覆蓋，只能補發新版
- 補發流程 — 財務同工可為特定教友重新產生，系統記錄「重新發出」事件至 Audit Log
- 作廢 — 設
IsVoided = true，但 PDF 原檔仍保留於 Blob，不可刪除 - 稅務諮詢 — 建議每年收據發出前，讓持牌會計師審閱格式一次