# 協會資料匯入規劃

## 一、資料現況盤點

### 1. 會員資料
**主要檔案：**
- `協會行政資料/協會會員名單/2024會員名冊/2024-01 會員名冊.xlsx` (14 KB, 2024-02-19)
- `協會行政資料/2024-11 法人登記/12-社團法人會員名冊.docx`
- `協會行政資料/協會會員名單/2024 理監事清單.docx`

**內容包含：**
- 會員基本資料
- 理監事名單
- 會員類別與狀態

### 2. 財務/帳務資料
**主要檔案：**
- `協會行政資料/協會帳務/2024尤塞氏症及視聽雙弱協會帳務.xlsx` (75 KB, 2025-07-29)
- `協會行政資料/協會帳務/2025 收入支出總表 (含會計科目編號).xlsx` (13 KB, 2025-08-12)
- `協會行政資料/協會帳務/2025 協會預算試編.xlsx`

**內容包含：**
- 2024年實際帳務記錄
- 2025年預算編列
- 會計科目編號對照表
- 收入支出明細

### 3. 文件與規範
**主要檔案：**
- `協會行政資料/協會帳務/會計政策與流程手冊_v1.docx`
- `協會行政資料/協會帳務/財務流程.docx`
- `協會行政資料/規範/理監事會議原則.docx`

### 4. 會議記錄
- 第一次會員大會記錄
- 理監事會議記錄
- 工作會議紀錄

### 5. 法人登記文件
- `20250220_法人登記謄本.pdf`
- `20250220_臺灣臺北地方法院公告.pdf`
- `20250220_臺灣臺北地方法院登記處函.pdf`

---

## 二、系統現有功能對應

### ✅ 已實作功能
1. **會員管理系統** (`members` table)
   - 可匯入會員基本資料
   - 支援會員狀態管理
   - 會員分類與權限

2. **財務管理系統**
   - 會計科目表 (`chart_of_accounts`)
   - 財務憑證 (`finance_documents`)
   - 交易記錄 (`accounting_transactions`)
   - 預算管理 (`budgets`, `budget_categories`)

3. **文件管理系統** (`documents`)
   - 可上傳並分類各類文件
   - 支援權限控管

4. **角色權限系統**
   - 可設定理事長、理事、監事等角色
   - 已有完整的權限管理

---

## 三、建議匯入步驟

### 階段一：基礎資料建立（優先）

#### 1.1 會員資料匯入
**來源檔案：** `2024-01 會員名冊.xlsx`

**需確認欄位：**
- 姓名 (name)
- 身分證字號 (id_number)
- 生日 (birthday)
- 性別 (gender)
- 聯絡電話 (phone)
- 電子郵件 (email)
- 地址 (address)
- 入會日期 (joined_date)
- 會員類別 (membership_type)
- 會員狀態 (status)

**匯入方式：**
- 使用系統現有的「會員匯入」功能
- 路徑：`/admin/members/import`

#### 1.2 理監事角色設定
**來源檔案：** `2024 理監事清單.docx`

**操作步驟：**
1. 確認理監事會員已匯入
2. 為理事長、理事、監事分配對應角色
3. 設定理監事任期資料

### 階段二：財務資料建立

#### 2.1 會計科目表建立
**來源檔案：** `2025 收入支出總表 (含會計科目編號).xlsx`

**需確認資訊：**
- 科目代碼 (code)
- 科目名稱 (name)
- 科目類別 (type): 資產/負債/收入/支出/權益
- 父科目 (parent_id)
- 是否啟用 (is_active)

**操作方式：**
- 檢視現有會計科目表是否需要調整
- 使用系統 Seeder 或手動建立

#### 2.2 2024年帳務資料匯入
**來源檔案：** `2024尤塞氏症及視聽雙弱協會帳務.xlsx`

**需轉換為：**
1. **財務憑證** (finance_documents)
   - 憑證日期
   - 憑證編號
   - 摘要說明
   - 總金額

2. **會計分錄** (accounting_transactions)
   - 借方科目
   - 貸方科目
   - 金額
   - 摘要

**建議：**
- 先分析 Excel 檔案結構
- 確認是否為複式簿記格式
- 建立資料轉換腳本

#### 2.3 2025年預算資料
**來源檔案：** `2025 協會預算試編.xlsx`

**匯入至：**
- `budgets` 表（預算主檔）
- `budget_categories` 表（預算科目）

### 階段三：文件與記錄上傳

#### 3.1 重要文件上傳
**文件類別建立：**
1. 法人登記文件
2. 會議記錄
3. 規範與流程
4. 財務報表

**上傳檔案：**
- 法人登記謄本、公告、函文
- 會員大會記錄
- 理監事會議記錄
- 會計政策手冊
- 財務流程文件

---

## 四、資料匯入前置作業

### 需要先執行的步驟：

1. **安裝 Excel 讀取套件**
   ```bash
   composer require maatwebsite/excel
   ```

2. **建立會計科目表**
   - 確認現有 `ChartOfAccountSeeder` 是否符合需求
   - 根據「2025 收入支出總表」調整科目

3. **準備資料轉換腳本**
   - 會員資料標準化
   - 財務資料格式轉換
   - 日期格式統一

4. **資料驗證規則**
   - 必填欄位檢查
   - 資料格式驗證
   - 重複資料檢查

---

## 五、技術實作建議

### 5.1 建立匯入指令

```php
php artisan make:command ImportMembers
php artisan make:command ImportFinanceData
php artisan make:command ImportDocuments
```

### 5.2 資料驗證流程

1. 讀取 Excel 檔案
2. 驗證欄位格式
3. 檢查重複資料
4. 建立匯入預覽
5. 確認後執行匯入
6. 產生匯入報告

### 5.3 錯誤處理

- 記錄匯入失敗的資料列
- 提供錯誤原因說明
- 支援部分匯入成功
- 可回溯或修正後重新匯入

---

## 六、後續待辦事項

### 高優先級
- [ ] 安裝並設定 Laravel Excel 套件
- [ ] 分析會員名冊 Excel 檔案結構
- [ ] 分析帳務資料 Excel 檔案結構
- [ ] 確認會計科目對照表

### 中優先級
- [ ] 建立會員資料匯入功能
- [ ] 建立財務資料匯入功能
- [ ] 上傳重要法人文件
- [ ] 建立文件分類系統

### 低優先級
- [ ] 歷史會議記錄數位化
- [ ] 建立文件全文搜尋
- [ ] 資料統計與分析報表

---

## 七、注意事項

1. **資料隱私**
   - 會員個人資料需加密保護
   - 限制存取權限
   - 符合個資法規範

2. **資料備份**
   - 匯入前先備份資料庫
   - 保留原始 Excel 檔案
   - 記錄匯入時間與版本

3. **資料品質**
   - 清理重複資料
   - 統一資料格式
   - 補齊缺漏資訊

4. **測試環境**
   - 先在測試環境驗證
   - 確認資料正確性
   - 再於正式環境匯入

---

## 八、需要進一步確認的資訊

1. **會員名冊格式**
   - 請確認 Excel 檔案的欄位名稱與順序
   - 是否有特殊的會員編號規則
   - 理監事如何標記

2. **帳務資料格式**
   - 是否為複式簿記格式
   - 憑證編號規則
   - 科目代碼對照

3. **匯入時程**
   - 預計何時開始匯入
   - 是否需要分批次匯入
   - 匯入後的驗證方式

---

**建立日期：** 2025-11-30
**文件版本：** v1.0
**負責人：** Claude Code