# HR Portal 代碼移動記錄

## 移動資訊

- **移動日期**: 2026-02-10
- **原位置**: `W:\DevOps-Workspace\hr-portal`
- **新位置**: `W:\DevOps-Workspace\3.Develop\4.HR_Portal`
- **執行人**: Claude AI
- **審核人**: Porsche Chen

---

## 移動原因

根據工作區規範 (README.md),開發中的程式碼應放置在 `3.Develop` 目錄。

---

## 現有功能狀態

### ✅ 已實作功能

1. **基礎架構** (完整)
   - FastAPI 後端
   - React + TypeScript 前端
   - PostgreSQL 資料庫
   - Docker 容器化部署

2. **Keycloak SSO 整合** (可運行)
   - 單點登入
   - Token 管理
   - 自動刷新

3. **員工管理** (基本功能)
   - 員工 CRUD
   - 列表、搜尋、篩選
   - 分頁顯示

4. **部署配置** (完整)
   - docker-compose.yml
   - Traefik 反向代理
   - Let's Encrypt SSL

### ⚠️ 需要重構部分

根據最新的「員工多身份設計文件.md」,需要進行以下調整:

1. **資料庫架構重構**
   - 新增 `business_units` 表 (事業部)
   - 新增 `departments` 表 (部門)
   - 新增 `employee_identities` 表 (員工身份)
   - 修改 `employees` 表結構

2. **後端 API 調整**
   - 支援員工多身份管理
   - 支援跨事業部查詢
   - 新增 NAS 整合 API

3. **前端 UI 調整**
   - 支援多事業部選擇
   - 支援多身份顯示
   - 新增 NAS 配額管理介面

---

## 下一步計畫

### Phase 1: 資料庫重構 (優先)
1. 更新資料庫 schema
2. 創建 migration 腳本
3. 初始化事業部和部門資料

### Phase 2: 後端重構
1. 更新 Model 定義
2. 重構 API 端點
3. 新增 NAS 服務整合

### Phase 3: 前端調整
1. 更新資料結構
2. 調整 UI 組件
3. 測試整合

---

## 資源文件

- **設計文件**: `w:\DevOps-Workspace\2.專案設計區\4.HR_Portal\`
  - [員工多身份設計文件.md](../../2.專案設計區/4.HR_Portal/員工多身份設計文件.md)
  - [HR Portal設計文件.md](../../2.專案設計區/4.HR_Portal/HR Portal設計文件.md)
  - [NAS整合設計文件.md](../../2.專案設計區/4.HR_Portal/NAS整合設計文件.md)
  - [開發階段規劃.md](../../2.專案設計區/4.HR_Portal/開發階段規劃.md)

- **規劃文件**: `w:\DevOps-Workspace\1.專案規劃區\4.HR_Portal\`

---

## 重要注意事項

1. ✅ 保留所有現有代碼和文檔
2. ✅ 保留 Docker 配置和部署腳本
3. ✅ 保留 image 目錄中的截圖
4. ⚠️ 資料庫需要重構,舊資料可能需要遷移
5. ⚠️ API 端點可能會有破壞性變更

---

## 聯絡資訊

如有問題,請聯繫:
- **技術負責人**: Porsche Chen (porsche.chen@porscheworld.tw)