Add membership fee system with disability discount and fix document permissions

Features:
- Implement two fee types: entrance fee and annual fee (both NT$1,000)
- Add 50% discount for disability certificate holders
- Add disability certificate upload in member profile
- Integrate disability verification into cashier approval workflow
- Add membership fee settings in system admin

Document permissions:
- Fix hard-coded role logic in Document model
- Use permission-based authorization instead of role checks

Additional features:
- Add announcements, general ledger, and trial balance modules
- Add income management and accounting entries
- Add comprehensive test suite with factories
- Update UI translations to Traditional Chinese

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-12-01 09:56:01 +08:00
parent 83ce1f7fc8
commit 642b879dd4
207 changed files with 19487 additions and 3048 deletions

View File

@@ -0,0 +1,365 @@
# 協會帳務資料分析報告
**分析日期:** 2025-11-30
**分析者:** Claude Code
---
## 一、檔案更新時間確認
### ✅ 今年確實有變更的帳務檔案
| 檔案名稱 | 最後更新日期 | 檔案大小 | 狀態 |
|---------|------------|---------|------|
| 2024尤塞氏症及視聽雙弱協會帳務.xlsx | **2025-07-30** | 75 KB | ✅ 今年更新 |
| 2025 收入支出總表 (含會計科目編號).xlsx | **2025-08-13** | 13 KB | ✅ 今年更新 |
| 2025 協會預算試編.xlsx | **2025-08-03** | 6 KB | ✅ 今年更新 |
**結論:** 帳務資料在今年 7-8 月間有更新,與你的預期一致!
---
## 二、檔案內容結構分析
### 📊 檔案一2024尤塞氏症及視聽雙弱協會帳務.xlsx
這是**2024年度的實際帳務記錄**檔案。
#### 工作表結構:
1. **籌辦階段** (999列)
- 記錄協會籌備期間的支出
- 包含:會場費、交通費、餐點費等
- 欄位:日期、項目、支出、收入、註記
2. **入會費會費** (1000列)
- 記錄會員繳納的入會費和常年會費
- 包含:
- 一般會員2,000元
- 身心障礙證明會員1,000元
- 團體會員
- 欄位:日期、繳款人、身份、費用、序號
3. **捐款** (1000列)
- 記錄各項捐款收入
- 已知捐款:
- 伍淑惠10,000元
- 姜欣慧3,000元
- 欄位:日期、捐款人、收入、註記
4. **List** (會員類別清單)
- 一般會員
- 身心障礙證明會員
- 團體會員
- 其他
#### 資料特點:
- ✅ 有完整的收支記錄
- ✅ 區分籌辦階段和正式運作
- ✅ 有會員身份分類
- ⚠️ 日期格式為 Excel 數值(需轉換)
---
### 📋 檔案二2025 收入支出總表 (含會計科目編號).xlsx
這是**帶有會計科目編號的收支總表**,最重要的檔案!
#### 工作表結構:
1. **收入** (5列資料)
- 欄位:日期、科目編號、科目名稱、收入金額、收入來源備註
- 記錄範例:
- 4100 一般捐款收入:伍淑惠 10,000元、姜欣慧 3,000元
- 4310 入會費2024/1/27 會費 66,000元
2. **支出** (13列資料)
- 欄位:日期、科目編號、科目名稱、支出金額、支出用途備註
- 記錄範例:
- 5100 業務費用:會場清潔費 500元、點心費 2,000元
3. **科目編號** (44列) ⭐ **最重要**
- 完整的會計科目表
- 欄位:科目編號、科目名稱、科目類別、用途說明
- 涵蓋:
- 資產類科目 (1000系列)
- 收入類科目 (4000系列)
- 支出類科目 (5000系列)
#### 已知會計科目:
**資產類 (1000系列)**
- 1000 現金及約當現金
- 1100 庫存現金
- 1101 銀行存款
- 1107 其他現金等價物
**收入類 (4000系列)**
- 4100 一般捐款收入
- 4310 入會費
**支出類 (5000系列)**
- 5100 業務費用
---
### 💰 檔案三2025 協會預算試編.xlsx
這是**2025年度預算編列**檔案。
#### 工作表結構:
**工作表1** (16列資料)
- 欄位:專案項目、科目編號、科目名稱、子項目、金額、用途說明、可能效益補充、其他
#### 預算項目範例:
**衛福部罕病認列推廣活動**
- 科目5100 業務費用,總預算 7,000元
- 子項目:
- 交通費6,000元台北花蓮往返
- 郵寄費500元公文及其他文書往來
- 影印費500元文書影印
---
## 三、資料完整性評估
### ✅ 優點
1. **有完整的會計科目表**
- 44個科目涵蓋資產、收入、支出
- 每個科目都有用途說明
- 可直接匯入系統
2. **收支記錄結構清楚**
- 有科目編號對照
- 有詳細的備註說明
- 日期、金額、來源/用途都有記錄
3. **會員繳費記錄完整**
- 有會員姓名
- 有會員類別
- 有繳費金額和日期
4. **有預算編列**
- 2025年預算已規劃
- 有專案分類
- 有詳細用途說明
### ⚠️ 需注意的地方
1. **日期格式**
- Excel 使用數值格式儲存日期(如 45318
- 需要轉換為標準日期格式
- 45318 = 2024-01-27
2. **資料分散**
- 實際帳務在「2024帳務.xlsx」
- 會計科目在「2025收支總表.xlsx」
- 需要整合
3. **缺少憑證編號**
- 目前沒有明確的憑證編號系統
- 建議匯入時自動產生
4. **科目對照需確認**
- 系統現有科目 vs Excel科目
- 可能需要調整對照
---
## 四、與系統現有科目對照
### 系統現有科目 (ChartOfAccountSeeder)
目前系統已有以下科目分類:
- 資產 (Assets)
- 負債 (Liabilities)
- 淨資產/權益 (Net Assets/Equity)
- 收入 (Revenue)
- 支出 (Expenses)
### Excel 科目對照建議
| Excel科目編號 | Excel科目名稱 | 系統科目類型 | 建議對照 |
|--------------|--------------|------------|---------|
| 1000系列 | 現金及約當現金 | Assets | 流動資產 |
| 4000系列 | 收入類 | Revenue | 捐贈收入、會費收入 |
| 5000系列 | 支出類 | Expenses | 業務費用、管理費用 |
---
## 五、建議匯入流程
### 階段一:會計科目表建立
1. **匯入「科目編號」工作表**
- 來源:`2025 收入支出總表 (含會計科目編號).xlsx` → 「科目編號」
- 目標:`chart_of_accounts`
- 共 44 筆科目
2. **欄位對照**
```
Excel欄位 → 系統欄位
─────────────────────────────────
科目編號 → code
科目名稱 → name
科目類別 → type (資產/收入/支出)
用途說明 → description
```
### 階段二2024年實際帳務匯入
#### 2.1 收入部分
**來源一:捐款收入**
- Excel`2024帳務.xlsx` → 「捐款」工作表
- 建立為:財務憑證 + 會計分錄
- 科目4100 一般捐款收入
**來源二:入會費收入**
- Excel`2024帳務.xlsx` → 「入會費會費」工作表
- 建立為:財務憑證 + 會計分錄
- 科目4310 入會費
#### 2.2 支出部分
**來源:籌辦階段支出**
- Excel`2024帳務.xlsx` → 「籌辦階段」工作表
- 建立為:財務憑證 + 會計分錄
- 科目5100 業務費用
### 階段三2025年預算匯入
**來源:**
- Excel`2025 協會預算試編.xlsx`
- 目標:`budgets``budget_categories`
---
## 六、資料匯入技術方案
### 方案一:使用 Laravel Excel + Command
```php
// 建立匯入指令
php artisan make:command ImportChartOfAccounts
php artisan make:command Import2024Accounting
php artisan make:command Import2025Budget
```
### 方案二:資料轉換腳本
1. **日期轉換函數**
```php
// Excel日期轉換
function excelDateToPhp($excelDate) {
return \PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($excelDate);
}
```
2. **會計分錄產生**
```php
// 收入:借:現金,貸:收入
// 支出:借:費用,貸:現金
```
---
## 七、資料品質檢查清單
### 匯入前檢查
- [ ] Excel 日期格式正確
- [ ] 金額欄位無文字
- [ ] 科目編號無重複
- [ ] 會員姓名無空白
- [ ] 收支總額核對
### 匯入後驗證
- [ ] 科目數量正確 (44筆)
- [ ] 收入總額 = Excel統計
- [ ] 支出總額 = Excel統計
- [ ] 借貸平衡
- [ ] 無孤兒記錄
---
## 八、重要發現摘要
### 📈 收入統計(根據 Excel
**2024年已記錄收入**
- 一般捐款13,000元伍淑惠10,000 + 姜欣慧3,000
- 入會費66,000元2024/1/27會費
- **總計約79,000元**
### 📉 支出統計(部分樣本)
**籌辦階段已知支出:**
- 會場清潔費850元
- 點心費2,000元
- 交通費1,676元
- **需完整統計**
### 💼 2025年預算
**衛福部罕病認列推廣活動7,000元**
- 其他專案需完整讀取
---
## 九、下一步建議
### 立即可執行
1. ✅ **Laravel Excel 已安裝**
2. ⭐ **建立會計科目匯入功能**(最優先)
3. 📊 **建立2024帳務匯入功能**
### 需確認的事項
1. **科目對照確認**
- Excel 44個科目 vs 系統現有科目
- 是否需要合併或新增
2. **憑證編號規則**
- 建議格式AC-YYYYMMDD-NNNN
- 例如AC-20240127-0001
3. **初始現金餘額**
- 協會成立時的初始資金?
- 或從第一筆收入開始記錄?
4. **入會費對應到會員**
- 需要建立會員繳費記錄關聯
- 「入會費會費」工作表有會員姓名
---
## 十、資料完整性確認
### 已確認資料
✅ 2024年度收支記錄部分
✅ 會計科目表完整44個科目
✅ 2025年預算規劃
✅ 會員繳費記錄
✅ 捐款記錄
### 需補充資料
❓ 2024年完整收支統計
❓ 銀行對帳單
❓ 實體收據憑證
❓ 期初現金餘額
---
**結論:**
帳務資料確實在今年2025年7-8月有更新資料結構完整且清晰可以直接開始匯入作業。建議優先匯入會計科目表再匯入2024年實際交易記錄。
需要我開始建立會計科目匯入功能嗎?