# 服务平台
版本 |  创建时间   | 作者 |  备注信息
---|---|---|---
v1.0|2022-01-20|zxfei| 接口文档

## 数据类型
类型名称|类型描述|参考样例
---|---|---
String |字符串|A、a、ab
Integer|数字类型|1、12、-1
Long|长整型数字|1、12、-1
date|时间类型,单位纳秒数字|167988745573
BigDecimal|小数类型|545.256
object|对象类型|{"name":"zhang3"}
arrays|数组类型|[{"name":"zhang3"},{"name":"zhang2"}]


## 系统服务
### 登录

**请求URL:** login/login

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 用户登录

**请求参数:**

参数名称|类型|备注|必填|其它
---|---|---|---|---
loginName|String|用户名称|是|-
password|String|用户密码|是|-
securityCode|String|校验码|是|-

**请求样例:**
```

{
"loginName":"zhang3",
"password":"123456",
"securityCode":"5455"
}

```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-


**响应消息样例:**
```

{
"msg":"登录成功",
"code":1,
"data":{

}
}

```

### 登出

**请求URL:** login/logout

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 用户退出注销

**请求参数:**

参数名称|类型|备注|必填|其它
---|---|---|---|---

**请求样例:**
```

```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-


**响应消息样例:**
```


```

### 修改密码

**请求URL:** user/change/password

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 用户修改密码

**请求参数:**

参数名称|类型|备注|必填|其它
---|---|---|---|---
loginName|String|用户名称|是|-
oldPwd|String|用户加密后密码|是|-
newPwd|String|用户加密后新密码|是|-

**请求样例:**
```

{
"loginName":"zhang3",
"oldPwd":"123456",
"newPwd":"5455"
}

```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-


**响应消息样例:**
```

{
"msg":"修改密码成功",
"code":1,
"data":{}
}

```



### 获取验证码

**请求URL:** securitycode/createCode

**请求方式:** GET

**内容类型:** image/gif

**简要描述:** 用户退出注销

**请求参数:**

参数名称|类型|备注|必填|其它
---|---|---|---|---

**请求样例:**
```

```
**响应参数:**



**响应消息样例:**
```

```


### 上传附件

**请求URL:** file/commonupload

**请求方式:** POST


**内容类型:** multipart/form-data

**简要描述:** 用户上传附件

**请求参数:**

参数名称|类型|备注|必填|其它
---|---|---|---|---
file|multipart|附件|是|-
prePath|String|附件存放相对路径|否|不填时候默认为/file/fileupload

**请求样例:**
```
http://127.0.0.1/file/commonupload?prePath=/file/fileupload
Content-Type: multipart/form-data; boundary=WebAppBoundary

--WebAppBoundary
Content-Disposition: form-data; name="file"; filename="1.excel"
Content-Type: multipart/form-data
```
**响应参数:**



**响应消息样例:**
```

```

## 员工基本信息

### 查询员工基本信息列表

**请求URL:** staff/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询员工基本信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
name|String|否|员工姓名,字段前后添加%%模糊查询
gender|Integer|否|性别(1.男,2.女)
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
staffType|Integer|否|员工类型（1.全职,2.兼职,3.实习)
status|Integer|否|员工状态(1.正式,2.试用,3.离职)

**请求样例:**
```
  {
        "name":"y5p5ef",
        "gender":8939,
        "politicalstatus":1774,
        "staffType":7837,
        "status":1525,
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;name|String|员工姓名
&emsp;&emsp;gender|Integer|性别(1.男,2.女)
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;positionId|Long|职位ID
&emsp;&emsp;positionName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型（1.全职,2.兼职,3.实习)
&emsp;&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;&emsp;registerPath|String|入职登记表
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;regularDate|Date|转正时间
&emsp;&emsp;leaveDate|Date|离职时间
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;gender|object|字典属性对象，详见附录
&emsp;status|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看员工基本信息

**请求URL:** staff/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看员工基本信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/staff/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;name|String|员工姓名
&emsp;gender|Integer|性别(1.男,2.女)
&emsp;birthday|Date|出生日期
&emsp;photoPath|String|照片
&emsp;phoneNumber|String|联系电话
&emsp;idCard|String|身份证号码
&emsp;workNum|String|工号
&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;deptId|Long|所属部门
&emsp;deptName|String|所属部门名称
&emsp;positionId|Long|职位ID
&emsp;positionName|String|职位名称
&emsp;staffType|Integer|员工类型（1.全职,2.兼职,3.实习)
&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;registerPath|String|入职登记表
&emsp;entryDate|Date|入职时间
&emsp;regularDate|Date|转正时间
&emsp;leaveDate|Date|离职时间
&emsp;remark|String|备注
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;gender|object|字典属性对象，详见附录
&emsp;status|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":6337,
            "name":"p32q2z",
            "gender":8839,
            "birthday":"2023-04-07",
            "photoPath":"6ls1ck",
            "phoneNumber":"zu01rs",
            "idCard":"8twbzr",
            "workNum":"y5knh2",
            "politicalstatus":9857,
            "deptId":7655,
            "deptName":"809k34",
            "positionId":4476,
            "positionName":"8sz14l",
            "staffType":4327,
            "status":3062,
            "registerPath":"uos02u",
            "entryDate":"2023-04-07",
            "regularDate":"2023-04-07",
            "leaveDate":"2023-04-07",
            "remark":"mt5x41",
            "createUserId":1356,
            "createTime":"2023-04-07",
            "updateUserId":3615,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新员工基本信息

**请求URL:** staff/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新员工基本信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
name|String|是|员工姓名
gender|Integer|否|性别(1.男,2.女)
birthday|Date|否|出生日期
photoPath|String|否|照片
phoneNumber|String|否|联系电话
idCard|String|否|身份证号码
workNum|String|否|工号
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
deptId|Long|否|所属部门
deptName|String|否|所属部门名称
positionId|Long|否|职位ID
positionName|String|否|职位名称
staffType|Integer|否|员工类型（1.全职,2.兼职,3.实习)
status|Integer|否|员工状态(1.正式,2.试用,3.离职)
registerPath|String|否|入职登记表
entryDate|Date|否|入职时间
regularDate|Date|否|转正时间
leaveDate|Date|否|离职时间
remark|String|否|备注

**请求样例:**
```
{
    "name":"jgufgp",
    "gender":4538,
    "birthday":"2023-04-07",
    "photoPath":"lonu8w",
    "phoneNumber":"y218v1",
    "idCard":"386nlp",
    "workNum":"lt1x1j",
    "politicalstatus":4498,
    "deptId":7309,
    "deptName":"c4s2zd",
    "positionId":5928,
    "positionName":"tx79ta",
    "staffType":3392,
    "status":4928,
    "registerPath":"wx2htz",
    "entryDate":"2023-04-07",
    "regularDate":"2023-04-07",
    "leaveDate":"2023-04-07",
    "remark":"1yr820",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;name|String|员工姓名
&emsp;&emsp;gender|Integer|性别(1.男,2.女)
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;positionId|Long|职位ID
&emsp;&emsp;positionName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型（1.全职,2.兼职,3.实习)
&emsp;&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;&emsp;registerPath|String|入职登记表
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;regularDate|Date|转正时间
&emsp;&emsp;leaveDate|Date|离职时间
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除员工基本信息

**请求URL:** staff/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除员工基本信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/staff/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 员工关怀信息

### 查询员工关怀信息列表

**请求URL:** staff/care/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询员工关怀信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
staffName|String|否|员工姓名,字段前后添加%%模糊查询
careType|Integer|否|关怀类型(1.生日关怀,2.入职周年关怀)
sendStatus|Integer|否|发送状态(0.未发送,1.已发送)

**请求样例:**
```
  {
        "staffName":"cadpn6",
        "careType":9743,
        "sendStatus":9996,
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;careType|Integer|关怀类型(1.生日关怀,2.入职周年关怀)
&emsp;&emsp;sendStatus|Integer|发送状态(0.未发送,1.已发送)
&emsp;&emsp;content|String|关怀内容
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;careType|object|字典属性对象，详见附录
&emsp;sendStatus|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看员工关怀信息

**请求URL:** staff/care/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看员工关怀信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/staff/care/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;staffId|Long|员工ID
&emsp;staffName|String|员工姓名
&emsp;birthday|Date|出生日期
&emsp;deptId|Long|所属部门
&emsp;deptName|String|所属部门名称
&emsp;jobId|Long|职位ID
&emsp;jobName|String|职位名称
&emsp;entryDate|Date|入职时间
&emsp;careType|Integer|关怀类型(1.生日关怀,2.入职周年关怀)
&emsp;sendStatus|Integer|发送状态(0.未发送,1.已发送)
&emsp;content|String|关怀内容
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;careType|object|字典属性对象，详见附录
&emsp;sendStatus|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":5406,
            "staffId":7718,
            "staffName":"ilxlcv",
            "birthday":"2023-04-07",
            "deptId":6568,
            "deptName":"ki0rxs",
            "jobId":8748,
            "jobName":"q7m4sb",
            "entryDate":"2023-04-07",
            "careType":1674,
            "sendStatus":6743,
            "content":"5i5zxm",
            "createUserId":2195,
            "createTime":"2023-04-07",
            "updateUserId":9342,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新员工关怀信息

**请求URL:** staff/care/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新员工关怀信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
staffId|Long|否|员工ID
staffName|String|是|员工姓名
birthday|Date|否|出生日期
deptId|Long|否|所属部门
deptName|String|否|所属部门名称
jobId|Long|否|职位ID
jobName|String|否|职位名称
entryDate|Date|否|入职时间
careType|Integer|否|关怀类型(1.生日关怀,2.入职周年关怀)
sendStatus|Integer|否|发送状态(0.未发送,1.已发送)
content|String|否|关怀内容

**请求样例:**
```
{
    "staffId":1830,
    "staffName":"i72ef6",
    "birthday":"2023-04-07",
    "deptId":9811,
    "deptName":"4pd139",
    "jobId":9724,
    "jobName":"2ecuwq",
    "entryDate":"2023-04-07",
    "careType":6520,
    "sendStatus":7035,
    "content":"hl1z18",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;careType|Integer|关怀类型(1.生日关怀,2.入职周年关怀)
&emsp;&emsp;sendStatus|Integer|发送状态(0.未发送,1.已发送)
&emsp;&emsp;content|String|关怀内容
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除员工关怀信息

**请求URL:** staff/care/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除员工关怀信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/staff/care/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 关怀问候信息

### 查询关怀问候信息列表

**请求URL:** care/template/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询关怀问候信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
careType|Integer|否|关怀类型(1.生日关怀,2.入职周年关怀)
sms|Integer|否|是否短信提示(1.是,0.否)

**请求样例:**
```
  {
        "careType":2949,
        "sms":8579,
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;careType|Integer|关怀类型(1.生日关怀,2.入职周年关怀)
&emsp;&emsp;sms|Integer|是否短信提示(1.是,0.否)
&emsp;&emsp;smsTemplate|String|短信模板内容
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;careType|object|字典属性对象，详见附录
&emsp;sms|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看关怀问候信息

**请求URL:** care/template/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看关怀问候信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/care/template/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;careType|Integer|关怀类型(1.生日关怀,2.入职周年关怀)
&emsp;sms|Integer|是否短信提示(1.是,0.否)
&emsp;smsTemplate|String|短信模板内容
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;careType|object|字典属性对象，详见附录
&emsp;sms|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":1530,
            "careType":1020,
            "sms":3175,
            "smsTemplate":"ictzu5",
            "createUserId":1322,
            "createTime":"2023-04-07",
            "updateUserId":1047,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新关怀问候信息

**请求URL:** care/template/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新关怀问候信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
careType|Integer|否|关怀类型(1.生日关怀,2.入职周年关怀)
sms|Integer|否|是否短信提示(1.是,0.否)
smsTemplate|String|否|短信模板内容

**请求样例:**
```
{
    "careType":7326,
    "sms":1136,
    "smsTemplate":"mvb4ga",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;careType|Integer|关怀类型(1.生日关怀,2.入职周年关怀)
&emsp;&emsp;sms|Integer|是否短信提示(1.是,0.否)
&emsp;&emsp;smsTemplate|String|短信模板内容
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除关怀问候信息

**请求URL:** care/template/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除关怀问候信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/care/template/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 职位信息

### 查询职位信息列表

**请求URL:** job/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询职位信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
groupName|String|否|分组名称,字段前后添加%%模糊查询
jobCode|String|否|职位编码,字段前后添加%%模糊查询
jobName|String|否|职位名称,字段前后添加%%模糊查询

**请求样例:**
```
  {
        "groupName":"221sgc",
        "jobCode":"buzhdj",
        "jobName":"vduagu",
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|主键，自增长
&emsp;&emsp;groupId|Long|分组id
&emsp;&emsp;groupName|String|分组名称
&emsp;&emsp;jobCode|String|职位编码
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|修改时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看职位信息

**请求URL:** job/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看职位信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/job/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|主键，自增长
&emsp;groupId|Long|分组id
&emsp;groupName|String|分组名称
&emsp;jobCode|String|职位编码
&emsp;jobName|String|职位名称
&emsp;remark|String|备注
&emsp;createTime|Date|创建时间
&emsp;createUserId|Long|创建用户
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|修改时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":3224,
            "groupId":5192,
            "groupName":"y8zckh",
            "jobCode":"djdvg1",
            "jobName":"k2657g",
            "remark":"ajxdd3",
            "createTime":"2023-04-07",
            "createUserId":4686,
            "updateUserId":8121,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新职位信息

**请求URL:** job/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新职位信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
groupId|Long|否|分组id
groupName|String|否|分组名称
jobCode|String|否|职位编码
jobName|String|否|职位名称
remark|String|否|备注

**请求样例:**
```
{
    "groupId":3140,
    "groupName":"q8jukx",
    "jobCode":"38mrsx",
    "jobName":"fxtzka",
    "remark":"owe9bs",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|主键，自增长
&emsp;&emsp;groupId|Long|分组id
&emsp;&emsp;groupName|String|分组名称
&emsp;&emsp;jobCode|String|职位编码
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|修改时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除职位信息

**请求URL:** job/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除职位信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/job/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 员工黑名单信息

### 查询员工黑名单信息列表

**请求URL:** staff/black/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询员工黑名单信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
staffName|String|否|员工姓名,字段前后添加%%模糊查询

**请求样例:**
```
  {
        "staffName":"2cf8le",
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;leaveDate|Date|离职时间
&emsp;&emsp;leaveReason|String|离职原因
&emsp;&emsp;blackDate|Date|拉黑时间
&emsp;&emsp;blackReason|String|拉黑原因
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看员工黑名单信息

**请求URL:** staff/black/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看员工黑名单信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/staff/black/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;staffId|Long|员工ID
&emsp;staffName|String|员工姓名
&emsp;phoneNumber|String|联系电话
&emsp;idCard|String|身份证号码
&emsp;leaveDate|Date|离职时间
&emsp;leaveReason|String|离职原因
&emsp;blackDate|Date|拉黑时间
&emsp;blackReason|String|拉黑原因
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":7976,
            "staffId":2059,
            "staffName":"v6h05h",
            "phoneNumber":"rnp4s4",
            "idCard":"kqgdik",
            "leaveDate":"2023-04-07",
            "leaveReason":"vec2zy",
            "blackDate":"2023-04-07",
            "blackReason":"i2bgph",
            "createUserId":6606,
            "createTime":"2023-04-07",
            "updateUserId":8949,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新员工黑名单信息

**请求URL:** staff/black/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新员工黑名单信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
staffId|Long|否|员工ID
staffName|String|是|员工姓名
phoneNumber|String|否|联系电话
idCard|String|否|身份证号码
leaveDate|Date|否|离职时间
leaveReason|String|否|离职原因
blackDate|Date|否|拉黑时间
blackReason|String|否|拉黑原因

**请求样例:**
```
{
    "staffId":9777,
    "staffName":"0wnybk",
    "phoneNumber":"jtmkf2",
    "idCard":"u2dtvz",
    "leaveDate":"2023-04-07",
    "leaveReason":"cqi42n",
    "blackDate":"2023-04-07",
    "blackReason":"z8ydfe",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;leaveDate|Date|离职时间
&emsp;&emsp;leaveReason|String|离职原因
&emsp;&emsp;blackDate|Date|拉黑时间
&emsp;&emsp;blackReason|String|拉黑原因
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除员工黑名单信息

**请求URL:** staff/black/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除员工黑名单信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/staff/black/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 员工调岗信息

### 查询员工调岗信息列表

**请求URL:** staff/adjust/log/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询员工调岗信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
fullName|String|否|员工姓名,字段前后添加%%模糊查询
gender|Integer|否|性别1男2女
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
staffType|Integer|否|员工类型1全职2兼职3实习
status|Integer|否|员工状态1正式2试用3离职
auditStatus|Integer|否|审核状态0待审核1通过2拒绝

**请求样例:**
```
  {
        "fullName":"77rlzh",
        "gender":6563,
        "politicalstatus":677,
        "staffType":5884,
        "status":4855,
        "auditStatus":4704,
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;fullName|String|员工姓名
&emsp;&emsp;gender|Integer|性别1男2女
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型1全职2兼职3实习
&emsp;&emsp;status|Integer|员工状态1正式2试用3离职
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;newDeptId|Long|调岗后所属部门
&emsp;&emsp;newDeptName|String|调岗后所属部门名称
&emsp;&emsp;newJobId|Long|调岗后职位ID
&emsp;&emsp;newJobName|String|调岗后职位名称
&emsp;&emsp;auditStatus|Integer|审核状态0待审核1通过2拒绝
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看员工调岗信息

**请求URL:** staff/adjust/log/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看员工调岗信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/staff/adjust/log/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;staffId|Long|员工ID
&emsp;fullName|String|员工姓名
&emsp;gender|Integer|性别1男2女
&emsp;birthday|Date|出生日期
&emsp;photoPath|String|照片
&emsp;phoneNumber|String|联系电话
&emsp;idCard|String|身份证号码
&emsp;workNum|String|工号
&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;deptId|Long|所属部门
&emsp;deptName|String|所属部门名称
&emsp;jobId|Long|职位ID
&emsp;jobName|String|职位名称
&emsp;staffType|Integer|员工类型1全职2兼职3实习
&emsp;status|Integer|员工状态1正式2试用3离职
&emsp;entryDate|Date|入职时间
&emsp;newDeptId|Long|调岗后所属部门
&emsp;newDeptName|String|调岗后所属部门名称
&emsp;newJobId|Long|调岗后职位ID
&emsp;newJobName|String|调岗后职位名称
&emsp;auditStatus|Integer|审核状态0待审核1通过2拒绝
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":8552,
            "staffId":957,
            "fullName":"h2hfnd",
            "gender":3656,
            "birthday":"2023-04-07",
            "photoPath":"zqh2nl",
            "phoneNumber":"l8qdhi",
            "idCard":"o5147u",
            "workNum":"prbbri",
            "politicalstatus":9101,
            "deptId":3017,
            "deptName":"rin5u3",
            "jobId":7376,
            "jobName":"zy8daw",
            "staffType":1956,
            "status":1007,
            "entryDate":"2023-04-07",
            "newDeptId":3421,
            "newDeptName":"lpqb3j",
            "newJobId":5327,
            "newJobName":"cyt3el",
            "auditStatus":6705,
            "createUserId":6435,
            "createTime":"2023-04-07",
            "updateUserId":5359,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新员工调岗信息

**请求URL:** staff/adjust/log/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新员工调岗信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
staffId|Long|否|员工ID
fullName|String|是|员工姓名
gender|Integer|否|性别1男2女
birthday|Date|否|出生日期
photoPath|String|否|照片
phoneNumber|String|否|联系电话
idCard|String|否|身份证号码
workNum|String|否|工号
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
deptId|Long|否|所属部门
deptName|String|否|所属部门名称
jobId|Long|否|职位ID
jobName|String|否|职位名称
staffType|Integer|否|员工类型1全职2兼职3实习
status|Integer|否|员工状态1正式2试用3离职
entryDate|Date|否|入职时间
newDeptId|Long|否|调岗后所属部门
newDeptName|String|否|调岗后所属部门名称
newJobId|Long|否|调岗后职位ID
newJobName|String|否|调岗后职位名称
auditStatus|Integer|否|审核状态0待审核1通过2拒绝

**请求样例:**
```
{
    "staffId":3217,
    "fullName":"td8xic",
    "gender":63,
    "birthday":"2023-04-07",
    "photoPath":"24fmdl",
    "phoneNumber":"7wvn1t",
    "idCard":"ccwqzx",
    "workNum":"lddz8i",
    "politicalstatus":278,
    "deptId":4406,
    "deptName":"mjwu8i",
    "jobId":1252,
    "jobName":"4veo60",
    "staffType":2611,
    "status":4389,
    "entryDate":"2023-04-07",
    "newDeptId":1373,
    "newDeptName":"69ywom",
    "newJobId":9937,
    "newJobName":"adanq7",
    "auditStatus":6942,
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;fullName|String|员工姓名
&emsp;&emsp;gender|Integer|性别1男2女
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型1全职2兼职3实习
&emsp;&emsp;status|Integer|员工状态1正式2试用3离职
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;newDeptId|Long|调岗后所属部门
&emsp;&emsp;newDeptName|String|调岗后所属部门名称
&emsp;&emsp;newJobId|Long|调岗后职位ID
&emsp;&emsp;newJobName|String|调岗后职位名称
&emsp;&emsp;auditStatus|Integer|审核状态0待审核1通过2拒绝
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除员工调岗信息

**请求URL:** staff/adjust/log/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除员工调岗信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/staff/adjust/log/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 员工转正信息

### 查询员工转正信息列表

**请求URL:** staff/regular/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询员工转正信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
staffName|String|否|员工姓名,字段前后添加%%模糊查询
gender|Integer|否|性别(1.男,2.女)
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
staffType|Integer|否|员工类型(1.全职,2.兼职,3.实习)
status|Integer|否|员工状态(1.正式,2.试用,3.离职)
auditStatus|Integer|否|审核状态(0.待审核,1.通过,2.拒绝)

**请求样例:**
```
  {
        "staffName":"jkx5dg",
        "gender":7367,
        "politicalstatus":8324,
        "staffType":5393,
        "status":5788,
        "auditStatus":5888,
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;gender|Integer|性别(1.男,2.女)
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型(1.全职,2.兼职,3.实习)
&emsp;&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;regularDate|Date|计划转正时间
&emsp;&emsp;auditStatus|Integer|审核状态(0.待审核,1.通过,2.拒绝)
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;gender|object|字典属性对象，详见附录
&emsp;staffType|object|字典属性对象，详见附录
&emsp;status|object|字典属性对象，详见附录
&emsp;auditStatus|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看员工转正信息

**请求URL:** staff/regular/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看员工转正信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/staff/regular/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;staffId|Long|员工ID
&emsp;staffName|String|员工姓名
&emsp;gender|Integer|性别(1.男,2.女)
&emsp;birthday|Date|出生日期
&emsp;photoPath|String|照片
&emsp;phoneNumber|String|联系电话
&emsp;idCard|String|身份证号码
&emsp;workNum|String|工号
&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;deptId|Long|所属部门
&emsp;deptName|String|所属部门名称
&emsp;jobId|Long|职位ID
&emsp;jobName|String|职位名称
&emsp;staffType|Integer|员工类型(1.全职,2.兼职,3.实习)
&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;entryDate|Date|入职时间
&emsp;regularDate|Date|计划转正时间
&emsp;auditStatus|Integer|审核状态(0.待审核,1.通过,2.拒绝)
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;gender|object|字典属性对象，详见附录
&emsp;staffType|object|字典属性对象，详见附录
&emsp;status|object|字典属性对象，详见附录
&emsp;auditStatus|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":4284,
            "staffId":9737,
            "staffName":"wkc6ll",
            "gender":7249,
            "birthday":"2023-04-07",
            "photoPath":"kekt4t",
            "phoneNumber":"a538xt",
            "idCard":"rx3ylf",
            "workNum":"u5nxj5",
            "politicalstatus":6419,
            "deptId":4844,
            "deptName":"y9qfq5",
            "jobId":1808,
            "jobName":"ljq3w6",
            "staffType":9203,
            "status":8869,
            "entryDate":"2023-04-07",
            "regularDate":"2023-04-07",
            "auditStatus":6208,
            "createUserId":9806,
            "createTime":"2023-04-07",
            "updateUserId":8254,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新员工转正信息

**请求URL:** staff/regular/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新员工转正信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
staffId|Long|否|员工ID
staffName|String|是|员工姓名
gender|Integer|否|性别(1.男,2.女)
birthday|Date|否|出生日期
photoPath|String|否|照片
phoneNumber|String|否|联系电话
idCard|String|否|身份证号码
workNum|String|否|工号
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
deptId|Long|否|所属部门
deptName|String|否|所属部门名称
jobId|Long|否|职位ID
jobName|String|否|职位名称
staffType|Integer|否|员工类型(1.全职,2.兼职,3.实习)
status|Integer|否|员工状态(1.正式,2.试用,3.离职)
entryDate|Date|否|入职时间
regularDate|Date|否|计划转正时间
auditStatus|Integer|否|审核状态(0.待审核,1.通过,2.拒绝)

**请求样例:**
```
{
    "staffId":7978,
    "staffName":"ig68k5",
    "gender":9468,
    "birthday":"2023-04-07",
    "photoPath":"zmv9yo",
    "phoneNumber":"130ex1",
    "idCard":"hc8efe",
    "workNum":"zh36g8",
    "politicalstatus":5568,
    "deptId":3112,
    "deptName":"ziho5o",
    "jobId":7487,
    "jobName":"225bc2",
    "staffType":6798,
    "status":7410,
    "entryDate":"2023-04-07",
    "regularDate":"2023-04-07",
    "auditStatus":1101,
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;gender|Integer|性别(1.男,2.女)
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型(1.全职,2.兼职,3.实习)
&emsp;&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;regularDate|Date|计划转正时间
&emsp;&emsp;auditStatus|Integer|审核状态(0.待审核,1.通过,2.拒绝)
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除员工转正信息

**请求URL:** staff/regular/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除员工转正信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/staff/regular/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 员工离职信息

### 查询员工离职信息列表

**请求URL:** staff/leave/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询员工离职信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
staffName|String|否|员工姓名,字段前后添加%%模糊查询
gender|Integer|否|性别(1.男,2.女)
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
staffType|Integer|否|员工类型(1.全职,2.兼职,3.实习)
status|Integer|否|员工状态(1.正式,2.试用,3.离职)
auditStatus|Integer|否|审核状态(0.待审,1.通过,2.拒绝)

**请求样例:**
```
  {
        "staffName":"jaqqtt",
        "gender":2456,
        "politicalstatus":5558,
        "staffType":2880,
        "status":1533,
        "auditStatus":7974,
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;gender|Integer|性别(1.男,2.女)
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型(1.全职,2.兼职,3.实习)
&emsp;&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;leaveDate|Date|离职时间
&emsp;&emsp;leaveReason|String|离职原因
&emsp;&emsp;auditStatus|Integer|审核状态(0.待审,1.通过,2.拒绝)
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;gender|object|字典属性对象，详见附录
&emsp;staffType|object|字典属性对象，详见附录
&emsp;status|object|字典属性对象，详见附录
&emsp;auditStatus|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看员工离职信息

**请求URL:** staff/leave/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看员工离职信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/staff/leave/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;staffId|Long|员工ID
&emsp;staffName|String|员工姓名
&emsp;gender|Integer|性别(1.男,2.女)
&emsp;birthday|Date|出生日期
&emsp;photoPath|String|照片
&emsp;phoneNumber|String|联系电话
&emsp;idCard|String|身份证号码
&emsp;workNum|String|工号
&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;deptId|Long|所属部门
&emsp;deptName|String|所属部门名称
&emsp;jobId|Long|职位ID
&emsp;jobName|String|职位名称
&emsp;staffType|Integer|员工类型(1.全职,2.兼职,3.实习)
&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;entryDate|Date|入职时间
&emsp;leaveDate|Date|离职时间
&emsp;leaveReason|String|离职原因
&emsp;auditStatus|Integer|审核状态(0.待审,1.通过,2.拒绝)
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;gender|object|字典属性对象，详见附录
&emsp;staffType|object|字典属性对象，详见附录
&emsp;status|object|字典属性对象，详见附录
&emsp;auditStatus|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":4180,
            "staffId":5460,
            "staffName":"tizt3f",
            "gender":5441,
            "birthday":"2023-04-07",
            "photoPath":"oi0ykl",
            "phoneNumber":"tgql5q",
            "idCard":"60co5x",
            "workNum":"po141l",
            "politicalstatus":3158,
            "deptId":3888,
            "deptName":"7apyah",
            "jobId":4805,
            "jobName":"h8reg1",
            "staffType":4093,
            "status":4331,
            "entryDate":"2023-04-07",
            "leaveDate":"2023-04-07",
            "leaveReason":"0naxip",
            "auditStatus":9167,
            "createUserId":107,
            "createTime":"2023-04-07",
            "updateUserId":5996,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新员工离职信息

**请求URL:** staff/leave/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新员工离职信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
staffId|Long|否|员工ID
staffName|String|是|员工姓名
gender|Integer|否|性别(1.男,2.女)
birthday|Date|否|出生日期
photoPath|String|否|照片
phoneNumber|String|否|联系电话
idCard|String|否|身份证号码
workNum|String|否|工号
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
deptId|Long|否|所属部门
deptName|String|否|所属部门名称
jobId|Long|否|职位ID
jobName|String|否|职位名称
staffType|Integer|否|员工类型(1.全职,2.兼职,3.实习)
status|Integer|否|员工状态(1.正式,2.试用,3.离职)
entryDate|Date|否|入职时间
leaveDate|Date|否|离职时间
leaveReason|String|否|离职原因
auditStatus|Integer|否|审核状态(0.待审,1.通过,2.拒绝)

**请求样例:**
```
{
    "staffId":1747,
    "staffName":"zs2b8y",
    "gender":230,
    "birthday":"2023-04-07",
    "photoPath":"xvb4pa",
    "phoneNumber":"163lt1",
    "idCard":"7hkmuo",
    "workNum":"pcldym",
    "politicalstatus":1344,
    "deptId":7170,
    "deptName":"d685vo",
    "jobId":5375,
    "jobName":"gwbl8f",
    "staffType":7543,
    "status":5308,
    "entryDate":"2023-04-07",
    "leaveDate":"2023-04-07",
    "leaveReason":"g8ntbg",
    "auditStatus":6655,
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;gender|Integer|性别(1.男,2.女)
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型(1.全职,2.兼职,3.实习)
&emsp;&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;leaveDate|Date|离职时间
&emsp;&emsp;leaveReason|String|离职原因
&emsp;&emsp;auditStatus|Integer|审核状态(0.待审,1.通过,2.拒绝)
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除员工离职信息

**请求URL:** staff/leave/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除员工离职信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/staff/leave/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 员工合同信息

### 查询员工合同信息列表

**请求URL:** staff/contract/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询员工合同信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
staffName|String|否|员工姓名,字段前后添加%%模糊查询
gender|Integer|否|性别(1.男,2.女)
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
staffType|Integer|否|员工类型(1.全职,2.兼职,3.实习)
status|Integer|否|员工状态(1.正式,2.试用,3.离职)
contractType|Integer|否|合同类型(1.纸质)
auditStatus|Integer|否|审核状态(0.待审核,1.通过,2.拒绝)

**请求样例:**
```
  {
        "staffName":"u3my55",
        "gender":9973,
        "politicalstatus":3486,
        "staffType":3695,
        "status":8414,
        "contractType":8004,
        "auditStatus":387,
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;gender|Integer|性别(1.男,2.女)
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型(1.全职,2.兼职,3.实习)
&emsp;&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;contractStartDate|Date|现合同开始时间
&emsp;&emsp;contractEndDate|Date|现合同到期时间
&emsp;&emsp;contractCompany|String|合同公司
&emsp;&emsp;contractType|Integer|合同类型(1.纸质)
&emsp;&emsp;newStartDate|Date|新合同开始时间
&emsp;&emsp;newEndDate|Date|新合同到期时间
&emsp;&emsp;auditStatus|Integer|审核状态(0.待审核,1.通过,2.拒绝)
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;gender|object|字典属性对象，详见附录
&emsp;staffType|object|字典属性对象，详见附录
&emsp;status|object|字典属性对象，详见附录
&emsp;contractType|object|字典属性对象，详见附录
&emsp;auditStatus|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看员工合同信息

**请求URL:** staff/contract/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看员工合同信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/staff/contract/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;staffId|Long|员工ID
&emsp;staffName|String|员工姓名
&emsp;gender|Integer|性别(1.男,2.女)
&emsp;birthday|Date|出生日期
&emsp;photoPath|String|照片
&emsp;phoneNumber|String|联系电话
&emsp;idCard|String|身份证号码
&emsp;workNum|String|工号
&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;deptId|Long|所属部门
&emsp;deptName|String|所属部门名称
&emsp;jobId|Long|职位ID
&emsp;jobName|String|职位名称
&emsp;staffType|Integer|员工类型(1.全职,2.兼职,3.实习)
&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;entryDate|Date|入职时间
&emsp;contractStartDate|Date|现合同开始时间
&emsp;contractEndDate|Date|现合同到期时间
&emsp;contractCompany|String|合同公司
&emsp;contractType|Integer|合同类型(1.纸质)
&emsp;newStartDate|Date|新合同开始时间
&emsp;newEndDate|Date|新合同到期时间
&emsp;auditStatus|Integer|审核状态(0.待审核,1.通过,2.拒绝)
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;gender|object|字典属性对象，详见附录
&emsp;staffType|object|字典属性对象，详见附录
&emsp;status|object|字典属性对象，详见附录
&emsp;contractType|object|字典属性对象，详见附录
&emsp;auditStatus|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":4417,
            "staffId":3135,
            "staffName":"ykurug",
            "gender":6749,
            "birthday":"2023-04-07",
            "photoPath":"cpli2q",
            "phoneNumber":"aloc3u",
            "idCard":"dfw5hu",
            "workNum":"9urejv",
            "politicalstatus":5459,
            "deptId":4605,
            "deptName":"nt2lnt",
            "jobId":434,
            "jobName":"h3i6se",
            "staffType":7033,
            "status":3252,
            "entryDate":"2023-04-07",
            "contractStartDate":"2023-04-07",
            "contractEndDate":"2023-04-07",
            "contractCompany":"dy5z30",
            "contractType":6891,
            "newStartDate":"2023-04-07",
            "newEndDate":"2023-04-07",
            "auditStatus":1114,
            "createUserId":773,
            "createTime":"2023-04-07",
            "updateUserId":9939,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新员工合同信息

**请求URL:** staff/contract/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新员工合同信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
staffId|Long|否|员工ID
staffName|String|是|员工姓名
gender|Integer|否|性别(1.男,2.女)
birthday|Date|否|出生日期
photoPath|String|否|照片
phoneNumber|String|否|联系电话
idCard|String|否|身份证号码
workNum|String|否|工号
politicalstatus|Integer|否|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
deptId|Long|否|所属部门
deptName|String|否|所属部门名称
jobId|Long|否|职位ID
jobName|String|否|职位名称
staffType|Integer|否|员工类型(1.全职,2.兼职,3.实习)
status|Integer|否|员工状态(1.正式,2.试用,3.离职)
entryDate|Date|否|入职时间
contractStartDate|Date|否|现合同开始时间
contractEndDate|Date|否|现合同到期时间
contractCompany|String|否|合同公司
contractType|Integer|否|合同类型(1.纸质)
newStartDate|Date|否|新合同开始时间
newEndDate|Date|否|新合同到期时间
auditStatus|Integer|否|审核状态(0.待审核,1.通过,2.拒绝)

**请求样例:**
```
{
    "staffId":371,
    "staffName":"6wpjf7",
    "gender":2270,
    "birthday":"2023-04-07",
    "photoPath":"x487to",
    "phoneNumber":"q53ei5",
    "idCard":"2bto6t",
    "workNum":"u994n8",
    "politicalstatus":3031,
    "deptId":411,
    "deptName":"v5i8ev",
    "jobId":7655,
    "jobName":"bqoujx",
    "staffType":9429,
    "status":2415,
    "entryDate":"2023-04-07",
    "contractStartDate":"2023-04-07",
    "contractEndDate":"2023-04-07",
    "contractCompany":"nbdeyt",
    "contractType":3242,
    "newStartDate":"2023-04-07",
    "newEndDate":"2023-04-07",
    "auditStatus":2994,
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;gender|Integer|性别(1.男,2.女)
&emsp;&emsp;birthday|Date|出生日期
&emsp;&emsp;photoPath|String|照片
&emsp;&emsp;phoneNumber|String|联系电话
&emsp;&emsp;idCard|String|身份证号码
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;politicalstatus|Integer|政治面貌 （1.中共党员，2.中共预备党员，3.共青团员，4.群众，5.其它)
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;jobId|Long|职位ID
&emsp;&emsp;jobName|String|职位名称
&emsp;&emsp;staffType|Integer|员工类型(1.全职,2.兼职,3.实习)
&emsp;&emsp;status|Integer|员工状态(1.正式,2.试用,3.离职)
&emsp;&emsp;entryDate|Date|入职时间
&emsp;&emsp;contractStartDate|Date|现合同开始时间
&emsp;&emsp;contractEndDate|Date|现合同到期时间
&emsp;&emsp;contractCompany|String|合同公司
&emsp;&emsp;contractType|Integer|合同类型(1.纸质)
&emsp;&emsp;newStartDate|Date|新合同开始时间
&emsp;&emsp;newEndDate|Date|新合同到期时间
&emsp;&emsp;auditStatus|Integer|审核状态(0.待审核,1.通过,2.拒绝)
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除员工合同信息

**请求URL:** staff/contract/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除员工合同信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/staff/contract/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 考勤打卡记录信息

### 查询考勤打卡记录信息列表

**请求URL:** attendance/record/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询考勤打卡记录信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
staffName|String|否|员工姓名,字段前后添加%%模糊查询

**请求样例:**
```
  {
        "staffName":"mlzydy",
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;positionId|Long|职位ID
&emsp;&emsp;positionName|String|职位名称
&emsp;&emsp;attendanceGroupId|Long|所属考勤组ID
&emsp;&emsp;attendanceGroupName|String|所属考勤组名称
&emsp;&emsp;shiftsId|Long|班次ID
&emsp;&emsp;shiftsName|String|班次名称
&emsp;&emsp;attendanceDate|Date|打卡日期
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看考勤打卡记录信息

**请求URL:** attendance/record/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看考勤打卡记录信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/attendance/record/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;staffId|Long|员工ID
&emsp;staffName|String|员工姓名
&emsp;workNum|String|工号
&emsp;deptId|Long|所属部门
&emsp;deptName|String|所属部门名称
&emsp;positionId|Long|职位ID
&emsp;positionName|String|职位名称
&emsp;attendanceGroupId|Long|所属考勤组ID
&emsp;attendanceGroupName|String|所属考勤组名称
&emsp;shiftsId|Long|班次ID
&emsp;shiftsName|String|班次名称
&emsp;attendanceDate|Date|打卡日期
&emsp;remark|String|备注
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":2586,
            "staffId":5116,
            "staffName":"7kuu34",
            "workNum":"lj56io",
            "deptId":3778,
            "deptName":"zbaaql",
            "positionId":464,
            "positionName":"8vy7xa",
            "attendanceGroupId":1461,
            "attendanceGroupName":"s6rlqf",
            "shiftsId":4405,
            "shiftsName":"b0bxn4",
            "attendanceDate":"2023-04-07",
            "remark":"rhqww2",
            "createUserId":6842,
            "createTime":"2023-04-07",
            "updateUserId":1948,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新考勤打卡记录信息

**请求URL:** attendance/record/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新考勤打卡记录信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
staffId|Long|否|员工ID
staffName|String|是|员工姓名
workNum|String|否|工号
deptId|Long|否|所属部门
deptName|String|否|所属部门名称
positionId|Long|否|职位ID
positionName|String|否|职位名称
attendanceGroupId|Long|否|所属考勤组ID
attendanceGroupName|String|否|所属考勤组名称
shiftsId|Long|否|班次ID
shiftsName|String|否|班次名称
attendanceDate|Date|否|打卡日期
remark|String|否|备注

**请求样例:**
```
{
    "staffId":855,
    "staffName":"ygm2p4",
    "workNum":"1e1e7n",
    "deptId":9452,
    "deptName":"zs79jr",
    "positionId":8785,
    "positionName":"w42mkz",
    "attendanceGroupId":5411,
    "attendanceGroupName":"4oibg9",
    "shiftsId":6600,
    "shiftsName":"gi9dun",
    "attendanceDate":"2023-04-07",
    "remark":"mhnalt",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工ID
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;workNum|String|工号
&emsp;&emsp;deptId|Long|所属部门
&emsp;&emsp;deptName|String|所属部门名称
&emsp;&emsp;positionId|Long|职位ID
&emsp;&emsp;positionName|String|职位名称
&emsp;&emsp;attendanceGroupId|Long|所属考勤组ID
&emsp;&emsp;attendanceGroupName|String|所属考勤组名称
&emsp;&emsp;shiftsId|Long|班次ID
&emsp;&emsp;shiftsName|String|班次名称
&emsp;&emsp;attendanceDate|Date|打卡日期
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除考勤打卡记录信息

**请求URL:** attendance/record/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除考勤打卡记录信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/attendance/record/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 考勤打卡记录详细信息

### 查询考勤打卡记录详细信息列表

**请求URL:** attendance/record/detail/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询考勤打卡记录详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录

**请求样例:**
```
  {
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;recordId|Long|考勤记录ID
&emsp;&emsp;shiftsId|Long|班次ID
&emsp;&emsp;shiftsName|String|班次名称
&emsp;&emsp;goWorkDate|Date|上班打卡时间
&emsp;&emsp;goWorkResult|Integer|上班打卡结果(1.正常,2.请假,3.缺卡,4.迟到,5.早退)
&emsp;&emsp;offWorkDate|Date|下班打卡时间
&emsp;&emsp;offWorkResult|Integer|下班打卡结果(1.正常,2.请假,3.缺卡,4.迟到,5.早退)
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;goWorkResult|object|字典属性对象，详见附录
&emsp;offWorkResult|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看考勤打卡记录详细信息

**请求URL:** attendance/record/detail/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看考勤打卡记录详细信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/attendance/record/detail/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;recordId|Long|考勤记录ID
&emsp;shiftsId|Long|班次ID
&emsp;shiftsName|String|班次名称
&emsp;goWorkDate|Date|上班打卡时间
&emsp;goWorkResult|Integer|上班打卡结果(1.正常,2.请假,3.缺卡,4.迟到,5.早退)
&emsp;offWorkDate|Date|下班打卡时间
&emsp;offWorkResult|Integer|下班打卡结果(1.正常,2.请假,3.缺卡,4.迟到,5.早退)
&emsp;remark|String|备注
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;goWorkResult|object|字典属性对象，详见附录
&emsp;offWorkResult|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":1910,
            "recordId":1937,
            "shiftsId":5294,
            "shiftsName":"soiqwj",
            "goWorkDate":"2023-04-07",
            "goWorkResult":563,
            "offWorkDate":"2023-04-07",
            "offWorkResult":7958,
            "remark":"8ojw39",
            "createUserId":6290,
            "createTime":"2023-04-07",
            "updateUserId":4630,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新考勤打卡记录详细信息

**请求URL:** attendance/record/detail/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新考勤打卡记录详细信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
recordId|Long|否|考勤记录ID
shiftsId|Long|否|班次ID
shiftsName|String|否|班次名称
goWorkDate|Date|否|上班打卡时间
goWorkResult|Integer|否|上班打卡结果(1.正常,2.请假,3.缺卡,4.迟到,5.早退)
offWorkDate|Date|否|下班打卡时间
offWorkResult|Integer|否|下班打卡结果(1.正常,2.请假,3.缺卡,4.迟到,5.早退)
remark|String|否|备注

**请求样例:**
```
{
    "recordId":7042,
    "shiftsId":7648,
    "shiftsName":"83n5td",
    "goWorkDate":"2023-04-07",
    "goWorkResult":8654,
    "offWorkDate":"2023-04-07",
    "offWorkResult":3196,
    "remark":"lbe8hm",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;recordId|Long|考勤记录ID
&emsp;&emsp;shiftsId|Long|班次ID
&emsp;&emsp;shiftsName|String|班次名称
&emsp;&emsp;goWorkDate|Date|上班打卡时间
&emsp;&emsp;goWorkResult|Integer|上班打卡结果(1.正常,2.请假,3.缺卡,4.迟到,5.早退)
&emsp;&emsp;offWorkDate|Date|下班打卡时间
&emsp;&emsp;offWorkResult|Integer|下班打卡结果(1.正常,2.请假,3.缺卡,4.迟到,5.早退)
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除考勤打卡记录详细信息

**请求URL:** attendance/record/detail/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除考勤打卡记录详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/attendance/record/detail/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 考勤组信息

### 查询考勤组信息列表

**请求URL:** attendance/group/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询考勤组信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录

**请求样例:**
```
  {
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;groupName|String|考勤组名称
&emsp;&emsp;personNum|Integer|人数
&emsp;&emsp;responsiblePerson|String|负责人
&emsp;&emsp;type|Integer|类型(1.固定班指)
&emsp;&emsp;attendanceTime|Integer|考勤时间
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;type|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看考勤组信息

**请求URL:** attendance/group/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看考勤组信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/attendance/group/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;groupName|String|考勤组名称
&emsp;personNum|Integer|人数
&emsp;responsiblePerson|String|负责人
&emsp;type|Integer|类型(1.固定班指)
&emsp;attendanceTime|Integer|考勤时间
&emsp;remark|String|备注
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;type|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":6607,
            "groupName":"invhp0",
            "personNum":2170,
            "responsiblePerson":"dc42ge",
            "type":2507,
            "attendanceTime":7039,
            "remark":"7a3ekk",
            "createUserId":5569,
            "createTime":"2023-04-07",
            "updateUserId":3591,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新考勤组信息

**请求URL:** attendance/group/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新考勤组信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
groupName|String|否|考勤组名称
personNum|Integer|否|人数
responsiblePerson|String|否|负责人
type|Integer|否|类型(1.固定班指)
attendanceTime|Integer|否|考勤时间
remark|String|否|备注

**请求样例:**
```
{
    "groupName":"be65ae",
    "personNum":6975,
    "responsiblePerson":"tpl0kp",
    "type":8308,
    "attendanceTime":583,
    "remark":"2it8mw",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;groupName|String|考勤组名称
&emsp;&emsp;personNum|Integer|人数
&emsp;&emsp;responsiblePerson|String|负责人
&emsp;&emsp;type|Integer|类型(1.固定班指)
&emsp;&emsp;attendanceTime|Integer|考勤时间
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除考勤组信息

**请求URL:** attendance/group/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除考勤组信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/attendance/group/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 考勤班次信息

### 查询考勤班次信息列表

**请求URL:** attendance/class/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询考勤班次信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录

**请求样例:**
```
  {
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;className|String|班次名称
&emsp;&emsp;classResponsiblePersonId|Long|班次负责人ID
&emsp;&emsp;classResponsiblePersonName|String|班次负责人名称
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看考勤班次信息

**请求URL:** attendance/class/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看考勤班次信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/attendance/class/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;className|String|班次名称
&emsp;classResponsiblePersonId|Long|班次负责人ID
&emsp;classResponsiblePersonName|String|班次负责人名称
&emsp;remark|String|备注
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":7820,
            "className":"imnac5",
            "classResponsiblePersonId":7049,
            "classResponsiblePersonName":"qm4l4x",
            "remark":"kb2kk7",
            "createUserId":3785,
            "createTime":"2023-04-07",
            "updateUserId":5742,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新考勤班次信息

**请求URL:** attendance/class/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新考勤班次信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
className|String|否|班次名称
classResponsiblePersonId|Long|否|班次负责人ID
classResponsiblePersonName|String|否|班次负责人名称
remark|String|否|备注

**请求样例:**
```
{
    "className":"5olksb",
    "classResponsiblePersonId":3400,
    "classResponsiblePersonName":"qmo5fi",
    "remark":"rxigqg",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;className|String|班次名称
&emsp;&emsp;classResponsiblePersonId|Long|班次负责人ID
&emsp;&emsp;classResponsiblePersonName|String|班次负责人名称
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除考勤班次信息

**请求URL:** attendance/class/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除考勤班次信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/attendance/class/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 考勤班次详细信息

### 查询考勤班次详细信息列表

**请求URL:** attendance/class/detail/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询考勤班次详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录

**请求样例:**
```
  {
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;shiftsId|Long|班次ID
&emsp;&emsp;shiftsName|String|班次名称
&emsp;&emsp;goWorkDate|Date|上班打卡时间
&emsp;&emsp;goWorkDateBefore|Integer|上班打卡前时间段,单位分钟
&emsp;&emsp;goWorkDateAfter|Integer|上班打卡前时间段,单位分钟
&emsp;&emsp;offWorkDate|Date|下班打卡时间
&emsp;&emsp;offWorkDateBefore|Integer|下班打卡前时间段,单位分钟
&emsp;&emsp;offWorkDateAfter|Integer|下班打卡前时间段,单位分钟
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看考勤班次详细信息

**请求URL:** attendance/class/detail/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看考勤班次详细信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/attendance/class/detail/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;shiftsId|Long|班次ID
&emsp;shiftsName|String|班次名称
&emsp;goWorkDate|Date|上班打卡时间
&emsp;goWorkDateBefore|Integer|上班打卡前时间段,单位分钟
&emsp;goWorkDateAfter|Integer|上班打卡前时间段,单位分钟
&emsp;offWorkDate|Date|下班打卡时间
&emsp;offWorkDateBefore|Integer|下班打卡前时间段,单位分钟
&emsp;offWorkDateAfter|Integer|下班打卡前时间段,单位分钟
&emsp;remark|String|备注
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":4340,
            "shiftsId":866,
            "shiftsName":"jhwk0q",
            "goWorkDate":"2023-04-07",
            "goWorkDateBefore":8021,
            "goWorkDateAfter":9782,
            "offWorkDate":"2023-04-07",
            "offWorkDateBefore":5344,
            "offWorkDateAfter":4281,
            "remark":"otkz6r",
            "createUserId":727,
            "createTime":"2023-04-07",
            "updateUserId":6429,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新考勤班次详细信息

**请求URL:** attendance/class/detail/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新考勤班次详细信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
shiftsId|Long|否|班次ID
shiftsName|String|否|班次名称
goWorkDate|Date|否|上班打卡时间
goWorkDateBefore|Integer|否|上班打卡前时间段,单位分钟
goWorkDateAfter|Integer|否|上班打卡前时间段,单位分钟
offWorkDate|Date|否|下班打卡时间
offWorkDateBefore|Integer|否|下班打卡前时间段,单位分钟
offWorkDateAfter|Integer|否|下班打卡前时间段,单位分钟
remark|String|否|备注

**请求样例:**
```
{
    "shiftsId":3006,
    "shiftsName":"qyaevn",
    "goWorkDate":"2023-04-07",
    "goWorkDateBefore":275,
    "goWorkDateAfter":9117,
    "offWorkDate":"2023-04-07",
    "offWorkDateBefore":2806,
    "offWorkDateAfter":7820,
    "remark":"uztsoc",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;shiftsId|Long|班次ID
&emsp;&emsp;shiftsName|String|班次名称
&emsp;&emsp;goWorkDate|Date|上班打卡时间
&emsp;&emsp;goWorkDateBefore|Integer|上班打卡前时间段,单位分钟
&emsp;&emsp;goWorkDateAfter|Integer|上班打卡前时间段,单位分钟
&emsp;&emsp;offWorkDate|Date|下班打卡时间
&emsp;&emsp;offWorkDateBefore|Integer|下班打卡前时间段,单位分钟
&emsp;&emsp;offWorkDateAfter|Integer|下班打卡前时间段,单位分钟
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除考勤班次详细信息

**请求URL:** attendance/class/detail/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除考勤班次详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/attendance/class/detail/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 请假记录信息

### 查询请假记录信息列表

**请求URL:** attendance/leave/record/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询请假记录信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
leavePersonId|Long|否|请假人id
deptName|String|否|所属部门,字段前后添加%%模糊查询
phoneNumber|String|否|电话号码,字段前后添加%%模糊查询
leaveType|Integer|否|请假类型(1.事假,2.调休,3.病假,4.年假,5.产假,6.陪产假,7.婚假,8.例假,9.哺乳假,10.丧假)
startTime|Date|否|开始时间
endTime|Date|否|结束时间

**请求样例:**
```
  {
        "leavePersonId":8612,
        "deptName":"dvnd9m",
        "phoneNumber":"3jg6fe",
        "leaveType":6078,
        "startTime":"2023-04-07",
        "endTime":"2023-04-07",
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;leavePersonId|Long|请假人id
&emsp;&emsp;leavePerson|String|请假人
&emsp;&emsp;deptId|Long|所属部门id
&emsp;&emsp;deptName|String|所属部门
&emsp;&emsp;phoneNumber|String|电话号码
&emsp;&emsp;leaveType|Integer|请假类型(1.事假,2.调休,3.病假,4.年假,5.产假,6.陪产假,7.婚假,8.例假,9.哺乳假,10.丧假)
&emsp;&emsp;startTime|Date|开始时间
&emsp;&emsp;endTime|Date|结束时间
&emsp;&emsp;duration|Integer|时长,单位秒
&emsp;&emsp;reason|String|请假事由
&emsp;&emsp;approverId|Long|审批负责人Id
&emsp;&emsp;approver|String|审批负责人
&emsp;&emsp;attachment|String|附件
&emsp;&emsp;attachmentPath|String|附件路径
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;leaveType|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看请假记录信息

**请求URL:** attendance/leave/record/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看请假记录信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/attendance/leave/record/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;leavePersonId|Long|请假人id
&emsp;leavePerson|String|请假人
&emsp;deptId|Long|所属部门id
&emsp;deptName|String|所属部门
&emsp;phoneNumber|String|电话号码
&emsp;leaveType|Integer|请假类型(1.事假,2.调休,3.病假,4.年假,5.产假,6.陪产假,7.婚假,8.例假,9.哺乳假,10.丧假)
&emsp;startTime|Date|开始时间
&emsp;endTime|Date|结束时间
&emsp;duration|Integer|时长,单位秒
&emsp;reason|String|请假事由
&emsp;approverId|Long|审批负责人Id
&emsp;approver|String|审批负责人
&emsp;attachment|String|附件
&emsp;attachmentPath|String|附件路径
&emsp;remark|String|备注
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象
&emsp;leaveType|object|字典属性对象，详见附录

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":5047,
            "leavePersonId":683,
            "leavePerson":"5lalt7",
            "deptId":1094,
            "deptName":"spdie5",
            "phoneNumber":"c5pyqc",
            "leaveType":988,
            "startTime":"2023-04-07",
            "endTime":"2023-04-07",
            "duration":8044,
            "reason":"hyz3gn",
            "approverId":5200,
            "approver":"fry8xq",
            "attachment":"3izx2v",
            "attachmentPath":"f1ezw2",
            "remark":"ehtzoe",
            "createUserId":7895,
            "createTime":"2023-04-07",
            "updateUserId":2130,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新请假记录信息

**请求URL:** attendance/leave/record/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新请假记录信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
leavePersonId|Long|是|请假人id
leavePerson|String|否|请假人
deptId|Long|否|所属部门id
deptName|String|否|所属部门
phoneNumber|String|否|电话号码
leaveType|Integer|否|请假类型(1.事假,2.调休,3.病假,4.年假,5.产假,6.陪产假,7.婚假,8.例假,9.哺乳假,10.丧假)
startTime|Date|否|开始时间
endTime|Date|否|结束时间
duration|Integer|否|时长,单位秒
reason|String|否|请假事由
approverId|Long|否|审批负责人Id
approver|String|否|审批负责人
attachment|String|否|附件
attachmentPath|String|否|附件路径
remark|String|否|备注

**请求样例:**
```
{
    "leavePersonId":9958,
    "leavePerson":"55dery",
    "deptId":4600,
    "deptName":"gzttbb",
    "phoneNumber":"01kn2r",
    "leaveType":4797,
    "startTime":"2023-04-07",
    "endTime":"2023-04-07",
    "duration":9355,
    "reason":"oqz29j",
    "approverId":1250,
    "approver":"nvwm3j",
    "attachment":"5cn6cu",
    "attachmentPath":"r4bzfg",
    "remark":"zmj5e1",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;leavePersonId|Long|请假人id
&emsp;&emsp;leavePerson|String|请假人
&emsp;&emsp;deptId|Long|所属部门id
&emsp;&emsp;deptName|String|所属部门
&emsp;&emsp;phoneNumber|String|电话号码
&emsp;&emsp;leaveType|Integer|请假类型(1.事假,2.调休,3.病假,4.年假,5.产假,6.陪产假,7.婚假,8.例假,9.哺乳假,10.丧假)
&emsp;&emsp;startTime|Date|开始时间
&emsp;&emsp;endTime|Date|结束时间
&emsp;&emsp;duration|Integer|时长,单位秒
&emsp;&emsp;reason|String|请假事由
&emsp;&emsp;approverId|Long|审批负责人Id
&emsp;&emsp;approver|String|审批负责人
&emsp;&emsp;attachment|String|附件
&emsp;&emsp;attachmentPath|String|附件路径
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除请假记录信息

**请求URL:** attendance/leave/record/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除请假记录信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/attendance/leave/record/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 员工假期余额信息

### 查询员工假期余额信息列表

**请求URL:** attendance/vacation/balance/list

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 查询员工假期余额信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
page|Integer|否|当前页
size|Integer|否|每页条数，值为-1，查询所有记录
staffId|Long|否|员工id
staffName|String|否|员工姓名,字段前后添加%%模糊查询
deptId|Long|否|部门id
deptName|String|否|部门名称,字段前后添加%%模糊查询
entryTime|Date|否|入职时间
personalLeaveDays|BigDecimal|否|事假（天）
compensatedLeaveDays|BigDecimal|否|调休（天）
sickLeaveDays|BigDecimal|否|病假（天）
annualLeaveDays|BigDecimal|否|年假（天）
marriageLeaveDays|BigDecimal|否|婚假（天）

**请求样例:**
```
  {
        "staffId":9144,
        "staffName":"th922m",
        "deptId":2036,
        "deptName":"pntg03",
        "entryTime":"2023-04-07",
        "personalLeaveDays":0.95,
        "compensatedLeaveDays":0.42,
        "sickLeaveDays":0.18,
        "annualLeaveDays":0.05,
        "marriageLeaveDays":0.19,
        "page":1,
        "size":10
  }

```
**响应参数:**

参数名称|参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;per_page|Integer|每页条数
&emsp;total|Integer|总条数
&emsp;last_page|Integer|总页数
&emsp;current_page|Integer|当前页
&emsp;data|array|结果集列表|数组
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工id
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;deptId|Long|部门id
&emsp;&emsp;deptName|String|部门名称
&emsp;&emsp;entryTime|Date|入职时间
&emsp;&emsp;personalLeaveDays|BigDecimal|事假（天）
&emsp;&emsp;compensatedLeaveDays|BigDecimal|调休（天）
&emsp;&emsp;sickLeaveDays|BigDecimal|病假（天）
&emsp;&emsp;annualLeaveDays|BigDecimal|年假（天）
&emsp;&emsp;marriageLeaveDays|BigDecimal|婚假（天）
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code":1,
    "data":{
    }
}
```

### 查看员工假期余额信息

**请求URL:** attendance/vacation/balance/info

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 查看员工假期余额信息，返回实例详细信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|Long|是|ID

**请求样例:**
```
    http://localhost/attendance/vacation/balance/info?id=549
```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:-------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|序号，主键，自增长
&emsp;staffId|Long|员工id
&emsp;staffName|String|员工姓名
&emsp;deptId|Long|部门id
&emsp;deptName|String|部门名称
&emsp;entryTime|Date|入职时间
&emsp;personalLeaveDays|BigDecimal|事假（天）
&emsp;compensatedLeaveDays|BigDecimal|调休（天）
&emsp;sickLeaveDays|BigDecimal|病假（天）
&emsp;annualLeaveDays|BigDecimal|年假（天）
&emsp;marriageLeaveDays|BigDecimal|婚假（天）
&emsp;remark|String|备注
&emsp;createUserId|Long|创建用户
&emsp;createTime|Date|创建时间
&emsp;updateUserId|Long|更新用户
&emsp;updateTime|Date|更新时间
dict|object|字典对象

**响应消息样例:**
```
{
    "code": 1,
    "data": {
            "id":4062,
            "staffId":3961,
            "staffName":"39vtrt",
            "deptId":3250,
            "deptName":"cmn42l",
            "entryTime":"2023-04-07",
            "personalLeaveDays":0.21,
            "compensatedLeaveDays":0.24,
            "sickLeaveDays":0.33,
            "annualLeaveDays":0.09,
            "marriageLeaveDays":0.68,
            "remark":"iltzm1",
            "createUserId":3323,
            "createTime":"2023-04-07",
            "updateUserId":8630,
            "updateTime":"2023-04-07"
        }
}
```

### 保存更新员工假期余额信息

**请求URL:** attendance/vacation/balance/save

**请求方式:** POST

**内容类型:** application/json;charset=utf-8

**简要描述:** 保存或更新员工假期余额信息：id为空时为新增保存，否则为更新提交

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:-------
staffId|Long|否|员工id
staffName|String|否|员工姓名
deptId|Long|否|部门id
deptName|String|否|部门名称
entryTime|Date|否|入职时间
personalLeaveDays|BigDecimal|否|事假（天）
compensatedLeaveDays|BigDecimal|否|调休（天）
sickLeaveDays|BigDecimal|否|病假（天）
annualLeaveDays|BigDecimal|否|年假（天）
marriageLeaveDays|BigDecimal|否|婚假（天）
remark|String|否|备注

**请求样例:**
```
{
    "staffId":5626,
    "staffName":"e2rs4j",
    "deptId":9498,
    "deptName":"o2fvb6",
    "entryTime":"2023-04-07",
    "personalLeaveDays":0.8,
    "compensatedLeaveDays":0.17,
    "sickLeaveDays":0.24,
    "annualLeaveDays":0.64,
    "marriageLeaveDays":0.11,
    "remark":"ylqz26",
}

```
**响应参数:**

参数名称 |参数类型|描述
:---|:---|:------
code|Integer|结果码（-1.失败，1.成功）
msg|String|消息
data|object|数据对象
&emsp;id|Long|保存后主键id
&emsp;entity|object|保存更新实体
&emsp;&emsp;id|Long|序号，主键，自增长
&emsp;&emsp;staffId|Long|员工id
&emsp;&emsp;staffName|String|员工姓名
&emsp;&emsp;deptId|Long|部门id
&emsp;&emsp;deptName|String|部门名称
&emsp;&emsp;entryTime|Date|入职时间
&emsp;&emsp;personalLeaveDays|BigDecimal|事假（天）
&emsp;&emsp;compensatedLeaveDays|BigDecimal|调休（天）
&emsp;&emsp;sickLeaveDays|BigDecimal|病假（天）
&emsp;&emsp;annualLeaveDays|BigDecimal|年假（天）
&emsp;&emsp;marriageLeaveDays|BigDecimal|婚假（天）
&emsp;&emsp;remark|String|备注
&emsp;&emsp;createUserId|Long|创建用户
&emsp;&emsp;createTime|Date|创建时间
&emsp;&emsp;updateUserId|Long|更新用户
&emsp;&emsp;updateTime|Date|更新时间

**响应消息样例:**
```
{
    "msg":"新增模块成功",
    "code":1,
    "data":{}
    }
}

```

### 删除员工假期余额信息

**请求URL:** attendance/vacation/balance/delete

**请求方式:** GET

**内容类型:** application/json;charset=utf-8

**简要描述:** 删除员工假期余额信息

**请求参数:**

参数名称|类型|必填|描述
:---|:---|:---|:------
id|String|是|数组

**请求样例:**
```
    http://localhost:8080/attendance/vacation/balance/delete?id=1&id=2'
```
**响应参数:**

参数名称 |参数类型|备注|其它
---|---|---|---
code|Integer|结果码（-1.失败，1.成功）|-
msg|String|消息|-

**响应消息样例:**
```
{
    "code":1,
	"msg":"成功"
}

```
## 字典附录
### gender
字典参数key|字典参数值|其它
:---|:---|:---
1|男|-
2|女|-
### status
字典参数key|字典参数值|其它
:---|:---|:---
1|正式|-
2|试用|-
3|离职|-
### careType
字典参数key|字典参数值|其它
:---|:---|:---
1|生日关怀|-
2|入职周年关怀|-
### sendStatus
字典参数key|字典参数值|其它
:---|:---|:---
0|未发送|-
1|已发送|-
### careType
字典参数key|字典参数值|其它
:---|:---|:---
1|生日关怀|-
2|入职周年关怀|-
### sms
字典参数key|字典参数值|其它
:---|:---|:---
1|是|-
0|否|-
### gender
字典参数key|字典参数值|其它
:---|:---|:---
1|男|-
2|女|-
### staffType
字典参数key|字典参数值|其它
:---|:---|:---
1|全职|-
2|兼职|-
3|实习|-
### status
字典参数key|字典参数值|其它
:---|:---|:---
1|正式|-
2|试用|-
3|离职|-
### auditStatus
字典参数key|字典参数值|其它
:---|:---|:---
0|待审核|-
1|通过|-
2|拒绝|-
### gender
字典参数key|字典参数值|其它
:---|:---|:---
1|男|-
2|女|-
### staffType
字典参数key|字典参数值|其它
:---|:---|:---
1|全职|-
2|兼职|-
3|实习|-
### status
字典参数key|字典参数值|其它
:---|:---|:---
1|正式|-
2|试用|-
3|离职|-
### auditStatus
字典参数key|字典参数值|其它
:---|:---|:---
0|待审|-
1|通过|-
2|拒绝|-
### gender
字典参数key|字典参数值|其它
:---|:---|:---
1|男|-
2|女|-
### staffType
字典参数key|字典参数值|其它
:---|:---|:---
1|全职|-
2|兼职|-
3|实习|-
### status
字典参数key|字典参数值|其它
:---|:---|:---
1|正式|-
2|试用|-
3|离职|-
### contractType
字典参数key|字典参数值|其它
:---|:---|:---
1|纸质|-
### auditStatus
字典参数key|字典参数值|其它
:---|:---|:---
0|待审核|-
1|通过|-
2|拒绝|-
### goWorkResult
字典参数key|字典参数值|其它
:---|:---|:---
1|正常|-
2|请假|-
3|缺卡|-
4|迟到|-
5|早退|-
### offWorkResult
字典参数key|字典参数值|其它
:---|:---|:---
1|正常|-
2|请假|-
3|缺卡|-
4|迟到|-
5|早退|-
### type
字典参数key|字典参数值|其它
:---|:---|:---
1|固定班指|-
### leaveType
字典参数key|字典参数值|其它
:---|:---|:---
1|事假|-
2|调休|-
3|病假|-
4|年假|-
5|产假|-
6|陪产假|-
7|婚假|-
8|例假|-
9|哺乳假|-
10|丧假|-
