Files
usher-manage-stack/協會帳務資料分析報告.md
Gbanyan 642b879dd4 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>
2025-12-01 09:56:01 +08:00

366 lines
9.0 KiB
Markdown
Raw Permalink 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.
# 協會帳務資料分析報告
**分析日期:** 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年實際交易記錄。
需要我開始建立會計科目匯入功能嗎?