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