Porsche Chen
360533393f
Major Features: - ✅ Multi-tenant architecture (tenant isolation) - ✅ Employee CRUD with lifecycle management (onboarding/offboarding) - ✅ Department tree structure with email domain management - ✅ Company info management (single-record editing) - ✅ System functions CRUD (permission management) - ✅ Email account management (multi-account per employee) - ✅ Keycloak SSO integration (auth.lab.taipei) - ✅ Redis session storage (10.1.0.254:6379) - Solves Cookie 4KB limitation - Cross-system session sharing - Sliding expiration (8 hours) - Automatic token refresh Technical Stack: Backend: - FastAPI + SQLAlchemy - PostgreSQL 16 (10.1.0.20:5433) - Keycloak Admin API integration - Docker Mailserver integration (SSH) - Alembic migrations Frontend: - Next.js 14 (App Router) - NextAuth 4 with Keycloak Provider - Redis session storage (ioredis) - Tailwind CSS Infrastructure: - Redis 7 (10.1.0.254:6379) - Session + Cache - Keycloak 26.1.0 (auth.lab.taipei) - Docker Mailserver (10.1.0.254) Architecture Highlights: - Session管理由 Keycloak + Redis 統一控制 - 支援多系統 (HR/WebMail/Calendar/Drive/Office) 共享 session - Token 自動刷新,異質服務整合 - 未來可無縫遷移到雲端 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
271 lines
5.6 KiB
Markdown
271 lines
5.6 KiB
Markdown
# HR Portal 資料庫測試指南
|
|
|
|
## 🎯 測試目的
|
|
|
|
驗證資料庫 schema 是否正確創建,包括:
|
|
- 表格結構
|
|
- 外鍵約束
|
|
- 唯一約束
|
|
- 索引
|
|
- 初始資料
|
|
- 視圖
|
|
|
|
---
|
|
|
|
## 🚀 快速測試 (使用 Docker)
|
|
|
|
### 1. 啟動測試資料庫
|
|
|
|
```bash
|
|
cd W:\DevOps-Workspace\3.Develop\4.HR_Portal\database
|
|
|
|
# 啟動 PostgreSQL 和 pgAdmin
|
|
docker-compose up -d
|
|
|
|
# 等待資料庫初始化完成 (約 10 秒)
|
|
docker-compose logs -f postgres
|
|
```
|
|
|
|
資料庫會自動執行 `schema.sql` 進行初始化。
|
|
|
|
### 2. 執行測試腳本
|
|
|
|
```bash
|
|
# 執行測試
|
|
docker exec -i hr-portal-db-test psql -U hr_admin -d hr_portal < test_schema.sql
|
|
|
|
# 或使用 Docker Compose
|
|
docker-compose exec postgres psql -U hr_admin -d hr_portal -f /test_schema.sql
|
|
```
|
|
|
|
### 3. 查看測試結果
|
|
|
|
測試腳本會輸出以下資訊:
|
|
- ✓ 表格是否存在
|
|
- ✓ 視圖是否存在
|
|
- ✓ 初始資料是否正確
|
|
- ✓ 外鍵約束
|
|
- ✓ 唯一約束
|
|
- ✓ 索引
|
|
- ✓ 模擬員工資料插入
|
|
- ✓ 唯一約束測試
|
|
|
|
### 4. 使用 pgAdmin 查看
|
|
|
|
訪問 http://localhost:5050
|
|
|
|
- **Email**: admin@lab.taipei
|
|
- **Password**: admin
|
|
|
|
添加伺服器:
|
|
- **Name**: HR Portal Test
|
|
- **Host**: postgres
|
|
- **Port**: 5432
|
|
- **Database**: hr_portal
|
|
- **Username**: hr_admin
|
|
- **Password**: hr_dev_password_2026
|
|
|
|
### 5. 停止測試環境
|
|
|
|
```bash
|
|
# 停止容器 (保留資料)
|
|
docker-compose stop
|
|
|
|
# 停止並刪除容器 (保留資料)
|
|
docker-compose down
|
|
|
|
# 完全清理 (刪除資料和容器)
|
|
docker-compose down -v
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 手動測試 (本地 PostgreSQL)
|
|
|
|
### 前置需求
|
|
|
|
- PostgreSQL 16 已安裝
|
|
- 已創建資料庫使用者
|
|
|
|
### 1. 創建資料庫
|
|
|
|
```bash
|
|
# 使用 createdb
|
|
createdb -U postgres hr_portal
|
|
|
|
# 或使用 psql
|
|
psql -U postgres -c "CREATE DATABASE hr_portal;"
|
|
```
|
|
|
|
### 2. 執行 Schema
|
|
|
|
```bash
|
|
psql -U postgres -d hr_portal -f schema.sql
|
|
```
|
|
|
|
### 3. 執行測試
|
|
|
|
```bash
|
|
psql -U postgres -d hr_portal -f test_schema.sql
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 測試項目說明
|
|
|
|
### 1. 表格存在性測試
|
|
|
|
檢查以下 6 個核心表格是否創建:
|
|
- `employees` - 員工基本資料
|
|
- `business_units` - 事業部
|
|
- `departments` - 部門
|
|
- `employee_identities` - 員工身份
|
|
- `network_drives` - 網路硬碟
|
|
- `audit_logs` - 審計日誌
|
|
|
|
### 2. 視圖測試
|
|
|
|
檢查 `v_employee_full_info` 視圖是否創建。
|
|
|
|
### 3. 初始資料測試
|
|
|
|
驗證初始資料是否正確插入:
|
|
- 3 個事業部
|
|
- 9 個部門
|
|
|
|
### 4. 外鍵約束測試
|
|
|
|
檢查以下外鍵約束:
|
|
- `departments.business_unit_id` → `business_units.id`
|
|
- `employee_identities.employee_id` → `employees.id`
|
|
- `employee_identities.business_unit_id` → `business_units.id`
|
|
- `employee_identities.department_id` → `departments.id`
|
|
- `network_drives.employee_id` → `employees.id`
|
|
|
|
### 5. 唯一約束測試
|
|
|
|
檢查以下唯一約束:
|
|
- `employees.employee_id` - 員工編號唯一
|
|
- `employees.username_base` - 基礎帳號唯一
|
|
- `business_units.code` - 事業部代碼唯一
|
|
- `business_units.email_domain` - 郵件網域唯一
|
|
- `employee_identities.username` - SSO 帳號唯一
|
|
- `employee_identities.keycloak_id` - Keycloak UUID 唯一
|
|
- `employee_identities(employee_id, business_unit_id)` - 一個員工在同一事業部只能有一個身份
|
|
- `network_drives.drive_name` - NAS 帳號名稱唯一
|
|
- `network_drives.employee_id` - 一個員工只有一個 NAS 帳號
|
|
|
|
### 6. 索引測試
|
|
|
|
檢查所有索引是否創建,包括:
|
|
- 主鍵索引
|
|
- 外鍵索引
|
|
- 查詢優化索引
|
|
|
|
### 7. 模擬資料插入測試
|
|
|
|
模擬真實場景插入資料:
|
|
1. 創建員工 (porsche.chen)
|
|
2. 創建第一個身份 (智能發展部 - 資訊部)
|
|
3. 創建第二個身份 (業務發展部 - 顧問部)
|
|
4. 創建 NAS 帳號
|
|
5. 查詢視圖驗證資料
|
|
6. 回滾 (不影響資料庫)
|
|
|
|
### 8. 約束違反測試
|
|
|
|
測試唯一約束是否生效:
|
|
- 嘗試為同一員工在同一事業部創建兩個身份 (應該失敗)
|
|
- 驗證錯誤訊息
|
|
|
|
---
|
|
|
|
## 🐛 常見問題
|
|
|
|
### Q1: 測試腳本執行失敗
|
|
|
|
**錯誤**: `psql: error: connection to server failed`
|
|
|
|
**解決**:
|
|
```bash
|
|
# 檢查 PostgreSQL 是否運行
|
|
docker-compose ps
|
|
|
|
# 查看日誌
|
|
docker-compose logs postgres
|
|
```
|
|
|
|
### Q2: Schema 初始化失敗
|
|
|
|
**錯誤**: `relation "xxx" already exists`
|
|
|
|
**解決**:
|
|
```bash
|
|
# 完全重置資料庫
|
|
docker-compose down -v
|
|
docker-compose up -d
|
|
```
|
|
|
|
### Q3: 無法連線到 pgAdmin
|
|
|
|
**錯誤**: `Unable to connect to server`
|
|
|
|
**解決**:
|
|
- 確認 pgAdmin 容器運行: `docker-compose ps`
|
|
- 確認使用 `postgres` (容器名稱) 作為 Host,而非 `localhost`
|
|
|
|
---
|
|
|
|
## 📊 預期輸出
|
|
|
|
測試成功時應該看到:
|
|
|
|
```
|
|
=========================================
|
|
HR Portal Database Schema 測試
|
|
=========================================
|
|
|
|
1. 檢查表格是否存在...
|
|
|
|
table_name | status
|
|
--------------------+--------
|
|
audit_logs | ✓ 存在
|
|
business_units | ✓ 存在
|
|
departments | ✓ 存在
|
|
employee_identities| ✓ 存在
|
|
employees | ✓ 存在
|
|
network_drives | ✓ 存在
|
|
|
|
2. 檢查視圖是否存在...
|
|
|
|
view_name | status
|
|
------------------------+--------
|
|
v_employee_full_info | ✓ 存在
|
|
|
|
...
|
|
|
|
✓ 唯一約束測試成功: 正確阻止重複身份
|
|
|
|
=========================================
|
|
測試完成!
|
|
=========================================
|
|
```
|
|
|
|
---
|
|
|
|
## 📝 下一步
|
|
|
|
測試通過後,可以進行:
|
|
|
|
1. **開發後端 API** - 創建 FastAPI 專案
|
|
2. **建立 ORM 模型** - SQLAlchemy 模型定義
|
|
3. **整合測試** - 後端 API 與資料庫整合測試
|
|
|
|
---
|
|
|
|
## 📖 相關文件
|
|
|
|
- [schema.sql](./schema.sql) - 資料庫 Schema
|
|
- [README.md](./README.md) - 資料庫設計說明
|
|
- [員工多身份設計文件](../../../2.專案設計區/4.HR_Portal/員工多身份設計文件.md)
|