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