企業管理系統項目HR模塊人員基本信息增刪改查接口文檔
HR模塊人員基本信息增刪改查接口主要提供了以下四個功能。1. 增加人員基本信息（POST /hr/personnel/add）。操作信息（成功時為"添加成功"，失敗時為具體錯誤信息）。操作信息（成功時為"刪除成功"，失敗時為具體錯誤信息）。3. 修改人員基本信息（PUT /hr/personnel/update/{id}）。其他參數與增加人員基本信息相同，用于更新對應字段的值。操作信息（成功時為"修改成功"，失敗時為具體錯誤信息）。4. 查詢人員基本信息（GET /hr/personnel/query）。操作信息（成功時為"查詢成功"，失敗時為具體錯誤信息）。
一、引言
隨著企業規模的擴大和業務需求的增長，對人力資源（HR）管理的要求也越來越高。為了提高企業人力資源管理的效率和準確性，我們為企業管理系統開發了一套HR模塊，該模塊包含了人員基本信息的增刪改查功能。本文檔旨在詳細介紹這些接口的功能、參數、返回值及使用方法，以便開發人員能夠正確集成和使用這些接口。
二、接口概述
HR模塊人員基本信息增刪改查接口主要提供了以下四個功能：
1. 增加人員基本信息（Add）2. 刪除人員基本信息（Delete）3. 修改人員基本信息（Update）4. 查詢人員基本信息（Query）
這些接口通過HTTP協議進行通信，采用RESTful設計風格，使用JSON格式進行數據傳輸。
三、接口詳解
1. 增加人員基本信息（POST /hr/personnel/add）
功能：向系統中添加一個新的人員基本信息記錄。
請求參數：
- name：姓名（必填）
- gender：性別（可選，默認為“男”）
- age：年齡（可選）
- department：部門（必填）
- position：職位（必填）
- email：郵箱（可選）
- phone：電話（可選）
- address：地址（可選）
請求示例：
json
{"name": "張三","gender": "男","age": 30,"department": "銷售部","position": "銷售經理","email": "zhangsan@example.com",
"phone": "13800138000","address": "北京市朝陽區"}響應參數：
- id：人員ID（系統自動生成）
- status：操作狀態（成功為"success"，失敗為"fail"）
- message：操作信息（成功時為"添加成功"，失敗時為具體錯誤信息）
響應示例：
json
{"id": 1001,
"status": "success","message": "添加成功"}2. 刪除人員基本信息（DELETE /hr/personnel/delete/{id}）
功能：從系統中刪除指定ID的人員基本信息記錄。
請求參數：
- id：要刪除的人員ID（必填）
請求示例：
bash
DELETE /hr/personnel/delete/1001響應參數：
- status：操作狀態（成功為"success"，失敗為"fail"）
- message：操作信息（成功時為"刪除成功"，失敗時為具體錯誤信息）
響應示例：
json
{"status": "success","message": "刪除成功"}3. 修改人員基本信息（PUT /hr/personnel/update/{id}）
功能：修改指定ID的人員基本信息記錄。
請求參數：
- id：要修改的人員ID（必填）
- 其他參數與增加人員基本信息相同，用于更新對應字段的值。
請求示例：
json
{"name": "張三豐","department": "技術部"}響應參數：
- status：操作狀態（成功為"success"，失敗為"fail"）
- message：操作信息（成功時為"修改成功"，失敗時為具體錯誤信息）
響應示例：
json
{"status": "success","message": "修改成功"}4. 查詢人員基本信息（GET /hr/personnel/query）
功能：根據條件查詢人員基本信息記錄。
請求參數：
- name：姓名（可選，模糊查詢）
- department：部門（可選，精確查詢）
- position：職位（可選，精確查詢）
響應參數：
- list：人員基本信息列表（包含id、name、gender、age、department、position、email、phone、address字段）
- status：操作狀態（成功為"success"，失敗為"fail"）
- message：操作信息（成功時為"查詢成功"，失敗時為具體錯誤信息）