# 公益組織會員管理系統 --- 技術規格說明書

*Version 1.0*

## 1. 系統概述

本系統為公益組織打造，用於管理會員資料、會費繳納、會籍期限及後續財務簽核流程。
系統目標包含：

-   會員可自助查詢：
    -   會籍期限
    -   繳費紀錄
    -   個人資料
-   協會內部可管理：
    -   會員資料
    -   會費紀錄
    -   財務文件簽核流程（會計 → 出納 → 理事長）
-   高度無障礙支援（WCAG 2.1 AA）

## 2. 系統架構

### 2.1 技術選型（後端）

-   Laravel 10+
-   PHP 8.2+
-   MySQL 8+
-   Laravel Queue（Redis 或 DB）
-   Google Workspace SMTP

### 2.2 前端架構

-   Phase 1：Blade + Tailwind + Alpine.js
-   Phase 2：必要頁面用 Inertia.js + Vue 3
-   無障礙 HTML-first 原則

## 3. 功能規格

### 3.1 會員端

-   登入（Email + 密碼）
-   查看會員資料
-   查看繳費紀錄
-   修改密碼
-   忘記密碼

### 3.2 後台

-   會員管理（新增/編輯/匯入）
-   帳號啟用連結寄送
-   會費管理
-   到期提醒
-   RBAC 角色管理

### 3.3 財務簽核（第二階段）

-   財務文件申請
-   出納 → 會計 → 理事長簽核流程
-   Audit Log

## 4. 資料庫 Schema（摘要）

-   members
-   users
-   roles / permissions（spatie/laravel-permission）
-   membership_payments
-   finance_documents
-   audit_logs

## 5. 註冊與啟用流程

### 既有會員

-   匯入資料 → 寄啟用連結 → 設密碼

### 新申請會員

-   前台表單 → pending → 管理員審核 → 寄啟用連結

## 6. 寄信規格

-   使用 Google Workspace SMTP
-   App Password 模式
-   Laravel Mailable + queue

## 7. 無障礙規格

-   HTML 語意化
-   所有表單必須有 label
-   aria-live
-   表格必須使用 table/th/thead/tbody
-   Email 為純文字友好格式

## 8. 安全性

-   bcrypt/argon2 密碼
-   身分證 encrypted + hash
-   Rate limiting
-   Audit Log 必須覆蓋所有敏感操作

## 9. 部署建議

-   Linux VPS
-   Nginx + PHP-FPM
-   MySQL/MariaDB
-   Redis（optional）
-   Daily backup
-   HTTPS（Let's Encrypt）

## 10. Roadmap

### Phase 1

-   會員登入、資料檢視、繳費紀錄
-   後台會員管理與匯入
-   寄信與啟用流程

### Phase 2

-   RBAC
-   到期提醒
-   Audit Log

### Phase 3

-   財務簽核流程與附件
-   Vue + Inertia 強化互動頁面