donald/hr-position-system
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

backup: 完成 HR_position_ 表格前綴重命名與欄位對照表整理

Browse Source 
變更內容：
- 所有資料表加上 HR_position_ 前綴
- 整理完整欄位顯示名稱與 ID 對照表
- 模組化 JS 檔案 (admin.js, ai.js, csv.js 等)
- 專案結構優化 (docs/, scripts/, tests/ 等)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
DonaldFang 方士碩
2025-12-09 12:05:20 +08:00
parent a068ef9704
commit a6af297623
82 changed files with 8685 additions and 4933 deletions
Download Patch File Download Diff File Expand all files Collapse all files

265
docs/需求確認文件.md Normal file
View File

@@ -0,0 +1,265 @@
# HR 基礎資料維護系統 - 需求確認文件
**文件版本**：1.0
**建立日期**：2024-12-06
**最後更新**：2024-12-06
**文件狀態**：待確認
---
## 1. 專案基本資訊
| 項目 | 內容 |
|------|------|
| 專案名稱 | HR 基礎資料維護系統 |
| 專案目的 | 提供人力資源部門維護崗位、職務、部門職責等基礎資料的工具 |
| 目標用戶 | HR 人員、部門主管、系統管理員 |
| 開發狀態 | 開發中 |
---
## 2. 功能模組確認
### 2.1 崗位基礎資料模組
| 功能項目 | 狀態 | 備註 |
|----------|------|------|
| 新增崗位 | 已實現 | |
| 編輯崗位 | 已實現 | |
| 刪除崗位 | 已實現 | |
| 崗位編號變更 | 已實現 | |
| 基礎資料頁籤 | 已實現 | 15 個欄位 |
| 招聘要求頁籤 | 已實現 | 18 個欄位 |
| 組織層級聯動 | 已實現 | BU → 處 → 部 → 課 |
**確認問題**：
- [ ] 崗位編號格式是否需要強制規範？（目前接受任意格式）
- [ ] 是否需要崗位編號自動生成功能？
- [ ] 編制人數是否有上限限制？
---
### 2.2 職務基礎資料模組
| 功能項目 | 狀態 | 備註 |
|----------|------|------|
| 新增職務 | 已實現 | |
| 編輯職務 | 已實現 | |
| 刪除職務 | 已實現 | |
| 職務類別聯動 | 已實現 | 6 種類別 |
| Toggle 開關 | 已實現 | 全勤獎金、住房補貼 |
| 職務層級（保密欄位） | 已實現 | |
**確認問題**：
- [ ] 職務類別是否需要擴充？
- [ ] 保密欄位的顯示邏輯是否正確？
- [ ] 是否需要職務與崗位的關聯功能？
---
### 2.3 部門職責模組
| 功能項目 | 狀態 | 備註 |
|----------|------|------|
| 新增部門職責 | 已實現 | |
| 編輯部門職責 | 已實現 | |
| 刪除部門職責 | 已實現 | |
| 組織層級聯動 | 已實現 | |
| 使命願景維護 | 已實現 | |
| 核心職責維護 | 已實現 | |
| KPI 維護 | 已實現 | |
**確認問題**：
- [ ] 部門職責是否需要與崗位建立關聯？
- [ ] 是否需要審核流程？
- [ ] 狀態變更是否需要記錄歷史？
---
### 2.4 崗位描述模組
| 功能項目 | 狀態 | 備註 |
|----------|------|------|
| 新增崗位描述 | 已實現 | |
| 編輯崗位描述 | 已實現 | |
| 版本管理 | 部分實現 | 僅記錄版本日期 |
| 主要職責清單 | 已實現 | 編號格式 |
| 崗位要求維護 | 已實現 | |
**確認問題**：
- [ ] 是否需要完整版本歷史記錄？
- [ ] 崗位描述是否需要審核流程？
- [ ] 是否需要匯出為 PDF/Word 格式？
---
### 2.5 三個錦囊 AI 功能
| 功能項目 | 狀態 | 備註 |
|----------|------|------|
| 自動補齊 | 已實現 | 根據已填內容生成 |
| 範例模板 | 已實現 | 生成範例資料 |
| 驗證檢查 | 已實現 | 檢查資料完整性 |
| Prompt 編輯 | 已實現 | 可自訂 Prompt |
| 多 LLM 支援 | 已實現 | Ollama, Gemini, DeepSeek, OpenAI |
**確認問題**：
- [ ] 預設 Prompt 是否符合需求？
- [ ] 是否需要限制 LLM 使用次數？
- [ ] 是否需要記錄 AI 生成歷史？
---
### 2.6 崗位清單與匯出
| 功能項目 | 狀態 | 備註 |
|----------|------|------|
| 崗位清單顯示 | 已實現 | |
| 搜尋過濾 | 已實現 | |
| 檢視描述 | 已實現 | |
| 匯出 CSV | 已實現 | |
| 下載 CSV 範本 | 已實現 | 崗位、職務 |
| 匯入 CSV | 已實現 | 崗位、職務 |
**確認問題**：
- [ ] 是否需要 Excel 格式支援？
- [ ] 匯出時是否需要選擇欄位？
- [ ] 批次匯入的錯誤處理是否符合需求？
---
## 3. 技術規格確認
### 3.1 前端技術
| 項目 | 當前實現 | 確認狀態 |
|------|----------|----------|
| 框架 | 純 HTML5/CSS3/ES6 JavaScript | |
| 模組化 | ES6 Modules (import/export) | |
| 樣式 | CSS Modules | |
| UI 元件 | 自訂元件 | |
**確認問題**：
- [ ] 是否考慮使用前端框架（Vue/React）？
- [ ] 是否需要 TypeScript 支援？
### 3.2 後端技術
| 項目 | 當前實現 | 確認狀態 |
|------|----------|----------|
| 框架 | Python Flask | |
| API 風格 | RESTful | |
| 資料庫 | In-Memory (Dict) | |
| LLM 服務 | 多 LLM 支援 | |
**確認問題**：
- [ ] 是否需要遷移至正式資料庫（MySQL/PostgreSQL）？
- [ ] 是否需要用戶認證功能？
- [ ] 是否需要與現有 HR 系統整合？
---
## 4. 欄位規格確認
### 4.1 標準化 HTML ID
系統已規劃欄位 ID 標準化，詳見「更新欄位名稱.md」。
| 模組 | 前綴 | 欄位數 | 狀態 |
|------|------|--------|------|
| 崗位基礎資料 | pos_ | 15 | 待實施 |
| 招聘要求 | rec_ | 18 | 待實施 |
| 職務基礎資料 | job_ | 12 | 待實施 |
| 部門職責 | df_ | 18 | 待實施 |
| 崗位描述 | jd_ | 16 | 待實施 |
**確認問題**：
- [ ] 是否同意欄位 ID 標準化方案？
- [ ] 重命名是否會影響現有資料？
---
## 5. 使用者介面確認
### 5.1 視覺設計
| 項目 | 當前狀態 | 確認 |
|------|----------|------|
| 主色調 | 藍色系 (#1a5276) | |
| 字型 | Noto Sans TC | |
| 響應式設計 | 支援手機/平板 | |
| 深色模式 | 未實現 | |
**確認問題**：
- [ ] 是否需要深色模式？
- [ ] 是否需要自訂主題色？
### 5.2 操作流程
| 流程 | 當前實現 | 確認 |
|------|----------|------|
| 新增 → 保存 | 一步完成 | |
| 保存並新增 | 支援 | |
| 刪除確認 | 彈窗確認 | |
| 快捷鍵 | Ctrl+S, Ctrl+N | |
**確認問題**：
- [ ] 是否需要草稿保存功能？
- [ ] 是否需要操作歷史（Undo/Redo）？
---
## 6. 待確認事項清單
### 6.1 優先級高
| # | 事項 | 負責人 | 截止日期 |
|---|------|--------|----------|
| 1 | 確認是否需要用戶認證功能 | | |
| 2 | 確認資料庫選型（In-Memory vs MySQL） | | |
| 3 | 確認欄位 ID 標準化方案 | | |
| 4 | 確認 AI 功能的使用政策 | | |
### 6.2 優先級中
| # | 事項 | 負責人 | 截止日期 |
|---|------|--------|----------|
| 5 | 確認 Excel 匯出需求 | | |
| 6 | 確認審核流程需求 | | |
| 7 | 確認與現有系統整合需求 | | |
### 6.3 優先級低
| # | 事項 | 負責人 | 截止日期 |
|---|------|--------|----------|
| 8 | 確認深色模式需求 | | |
| 9 | 確認多語言支援需求 | | |
---
## 7. 簽核記錄
| 角色 | 姓名 | 簽核日期 | 簽核狀態 |
|------|------|----------|----------|
| 專案負責人 | | | 待簽核 |
| 業務代表 | | | 待簽核 |
| 技術負責人 | | | 待簽核 |
---
## 8. 附錄
### 附錄 A：相關文件
- SDD.md - 軟體設計文件
- TDD.md - 測試設計文件
- 更新欄位名稱.md - 欄位規範書
- ID重命名對照表.md - 欄位 ID 對照表
### 附錄 B：系統截圖
（請參考系統實際畫面）
---
**文件結束**