feat: 新增崗位描述與清單整合功能 v2.1

主要功能更新:
- 崗位描述保存功能:保存後資料寫入資料庫
- 崗位清單自動刷新:切換模組時自動載入最新資料
- 崗位清單檢視功能:點擊「檢視」按鈕載入對應描述
- 管理者頁面擴充:新增崗位資料管理與匯出功能
- CSV 批次匯入:支援崗位與職務資料批次匯入

後端 API 新增:
- Position Description CRUD APIs
- Position List Query & Export APIs
- CSV Template Download & Import APIs

文件更新:
- SDD.md 更新至版本 2.1
- README.md 更新功能說明與版本歷史

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-12-04 12:46:36 +08:00
parent d17af39bf4
commit b2584772c4
31 changed files with 6795 additions and 365 deletions

View File

@@ -1,6 +1,6 @@
# HR Position Management System
人力資源崗位管理系統 v2.0
人力資源崗位管理系統 v2.1
## 功能特色
@@ -27,19 +27,24 @@
- 技能要求
- 工作環境描述
- 職涯發展路徑
- **保存功能**:點擊「保存並退出」或「保存並新增」將資料寫入資料庫
### 4. 崗位清單(新功能)
### 4. 崗位清單
- 顯示所有崗位資料(表格形式)
- 自動刷新:切換到崗位清單時自動載入最新資料
- 點擊「檢視」按鈕開啟對應的崗位描述
- 點擊欄位標題排序(升序/降序切換)
- 支援匯出 CSV
### 5. 管理者頁面(新功能)
- 使用者管理(新增/編輯/刪除)
- 三種權限等級:
### 5. 管理者頁面
- **使用者管理**(新增/編輯/刪除)
- 一般使用者(綠色標籤)
- 管理者(橘色標籤)
- 最高權限管理者(紅色標籤)
- 匯出使用者清單 CSV
- **崗位資料管理**
- 匯出完整崗位資料為 CSV
- 即時統計資訊(總數、已描述、未描述)
- 自動更新統計資料
### 6. 通用功能
- **CSV 匯入/匯出**:所有頁籤皆支援
@@ -115,6 +120,29 @@ python start_server.py
| GET | `/api/jobs` | 獲取所有職務 |
| POST | `/api/jobs` | 新增職務 |
### 崗位描述 API
| 方法 | 路徑 | 說明 |
|------|------|------|
| GET | `/api/position-descriptions` | 獲取所有崗位描述 |
| GET | `/api/position-descriptions/<code>` | 獲取單一崗位描述 |
| POST | `/api/position-descriptions` | 新增或更新崗位描述 |
| PUT | `/api/position-descriptions/<code>` | 更新崗位描述 |
| DELETE | `/api/position-descriptions/<code>` | 刪除崗位描述 |
### 崗位清單 API
| 方法 | 路徑 | 說明 |
|------|------|------|
| GET | `/api/position-list` | 獲取崗位清單 |
| GET | `/api/position-list/export` | 匯出完整崗位清單 CSV |
### CSV 匯入匯出 API
| 方法 | 路徑 | 說明 |
|------|------|------|
| GET | `/api/positions/csv-template` | 下載崗位資料 CSV 範本 |
| POST | `/api/positions/import-csv` | 批次匯入崗位資料 |
| GET | `/api/jobs/csv-template` | 下載職務資料 CSV 範本 |
| POST | `/api/jobs/import-csv` | 批次匯入職務資料 |
### LLM API
| 方法 | 路徑 | 說明 |
|------|------|------|
@@ -157,6 +185,23 @@ hr-position-system/
## 版本歷史
### v2.1 (2024-12-04)
- **新增崗位描述保存功能**
- 保存並退出:資料寫入資料庫後切換至崗位清單
- 保存並新增:資料寫入資料庫後清空表單
- **崗位清單功能增強**
- 切換至崗位清單時自動刷新資料
- 點擊「檢視」按鈕載入對應崗位描述
- 更新表頭欄位(移除事業體/部門,新增崗位性質/等級)
- **管理者頁面新增崗位資料管理**
- 匯出完整崗位資料為 CSV
- 顯示即時統計(總數、已描述、未描述)
- 自動更新統計資料
- **後端 API 擴充**
- 崗位描述 CRUD API
- 崗位清單查詢與匯出 API
- CSV 批次匯入 API
### v2.0 (2024-12-04)
- 新增 CSV 匯入匯出功能(所有頁籤)
- 新增崗位清單頁籤(含欄位排序)
@@ -167,7 +212,7 @@ hr-position-system/
- 改善錯誤訊息顯示(可複製)
- 修正 Windows 編碼問題
### v1.0 (2024-12-04)
### v1.0 (2024-12-03)
- 初始版本
- 崗位基礎資料維護
- 職務基礎資料維護