DonaldFang 方士碩
a6af297623
變更內容： - 所有資料表加上 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>
6.7 KiB
6.7 KiB
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：系統截圖
（請參考系統實際畫面）
文件結束