docs: 同步人员分配模块文档
更新内容：
1. API接口文档.md
- 新增「四、人员分配管理接口」章节（159行）
- 5个核心接口文档：
* 4.1 分页查询用户分配列表（支持多条件过滤）
* 4.2 根据部门ID查询用户列表
* 4.3 分配用户到部门和岗位
* 4.4 批量分配用户
* 4.5 移除用户分配
- 完整的请求参数、响应示例、字段说明
- 包含部门名称、岗位名称的VO结构
- 调整后续所有章节编号（五~十六）
2. 资金服务平台 FundPlatform 功能清单.md
- 标记「人员分配（部门人员配置）」为已完成 ✅
- 添加实现状态说明：
* 后端：UserAssignmentVO + UserAssignmentService + UserAssignmentController
* 前端：userAssignment.js + userAssignment.vue
* 功能清单：8大功能点
* 批量分配、未分配筛选、职位管理
文档与代码同步完成！
This commit is contained in:
zhangjf
parent
8ac97bb313
commit
c184e649ee
182
doc/API接口文档.md
182
doc/API接口文档.md
@ -624,9 +624,165 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 四、认证接口
|
||||
## 四、人员分配管理接口
|
||||
|
||||
### 4.1 用户登录
|
||||
### 4.1 分页查询用户分配列表
|
||||
|
||||
**接口地址：** `GET /api/v1/user-assignment/list`
|
||||
|
||||
**接口说明：** 分页查询用户分配列表，支持多条件过滤
|
||||
|
||||
**请求参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| current | Long | 否 | 当前页码，默认1 |
|
||||
| size | Long | 否 | 每页条数，默认10 |
|
||||
| username | String | 否 | 用户名（模糊查询） |
|
||||
| realName | String | 否 | 真实姓名（模糊查询） |
|
||||
| deptId | Long | 否 | 部门ID |
|
||||
| postId | Long | 否 | 岗位ID |
|
||||
| status | Integer | 否 | 状态（0-禁用，1-启用） |
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "操作成功",
|
||||
"data": {
|
||||
"records": [
|
||||
{
|
||||
"userId": 1,
|
||||
"username": "admin",
|
||||
"realName": "管理员",
|
||||
"gender": 1,
|
||||
"phone": "13800138000",
|
||||
"email": "admin@example.com",
|
||||
"deptId": 1,
|
||||
"deptName": "技术部",
|
||||
"postId": 1,
|
||||
"postName": "开发工程师",
|
||||
"position": "高级开发",
|
||||
"status": 1,
|
||||
"createdTime": "2026-01-01 10:00:00"
|
||||
}
|
||||
],
|
||||
"total": 50,
|
||||
"size": 10,
|
||||
"current": 1
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4.2 根据部门ID查询用户列表
|
||||
|
||||
**接口地址：** `GET /api/v1/user-assignment/list/dept/{deptId}`
|
||||
|
||||
**接口说明：** 查询指定部门下的所有启用用户
|
||||
|
||||
**路径参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| deptId | Long | 是 | 部门ID |
|
||||
|
||||
**响应示例：** 同4.1
|
||||
|
||||
---
|
||||
|
||||
### 4.3 分配用户到部门和岗位
|
||||
|
||||
**接口地址：** `PUT /api/v1/user-assignment/{userId}`
|
||||
|
||||
**接口说明：** 将用户分配到指定部门和岗位
|
||||
|
||||
**路径参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| userId | Long | 是 | 用户ID |
|
||||
|
||||
**请求参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| deptId | Long | 否 | 部门ID |
|
||||
| postId | Long | 否 | 岗位ID |
|
||||
| position | String | 否 | 职位 |
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "分配成功",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4.4 批量分配用户
|
||||
|
||||
**接口地址：** `PUT /api/v1/user-assignment/batch`
|
||||
|
||||
**接口说明：** 批量将用户分配到指定部门和岗位
|
||||
|
||||
**请求参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| deptId | Long | 是 | 部门ID |
|
||||
| postId | Long | 是 | 岗位ID |
|
||||
|
||||
**请求体：**
|
||||
|
||||
```json
|
||||
[1, 2, 3, 4, 5]
|
||||
```
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "批量分配成功",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4.5 移除用户分配
|
||||
|
||||
**接口地址：** `DELETE /api/v1/user-assignment/{userId}`
|
||||
|
||||
**接口说明：** 移除用户的部门和岗位分配
|
||||
|
||||
**路径参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| userId | Long | 是 | 用户ID |
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "移除分配成功",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、认证接口
|
||||
|
||||
### 5.1 用户登录
|
||||
|
||||
**接口地址：** `POST /api/v1/auth/login`
|
||||
|
||||
@ -784,7 +940,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 五、用户管理接口
|
||||
## 六、用户管理接口
|
||||
|
||||
### 3.1 获取用户列表
|
||||
|
||||
@ -982,7 +1138,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 六、租户管理接口
|
||||
## 七、租户管理接口
|
||||
|
||||
### 4.1 获取租户列表
|
||||
|
||||
@ -1046,7 +1202,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 七、客户管理接口
|
||||
## 八、客户管理接口
|
||||
|
||||
### 5.1 获取客户列表
|
||||
|
||||
@ -1145,7 +1301,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 八、项目管理接口
|
||||
## 九、项目管理接口
|
||||
|
||||
### 6.1 获取项目列表
|
||||
|
||||
@ -1450,7 +1606,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 九、需求工单接口
|
||||
## 十、需求工单接口
|
||||
|
||||
### 7.1 获取需求列表
|
||||
|
||||
@ -1519,7 +1675,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 十、支出管理接口
|
||||
## 十一、支出管理接口
|
||||
|
||||
### 8.1 获取支出类型列表
|
||||
|
||||
@ -1585,7 +1741,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 十一、应收款管理接口
|
||||
## 十二、应收款管理接口
|
||||
|
||||
### 9.1 获取应收款列表
|
||||
|
||||
@ -1659,7 +1815,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 十二、收款记录管理接口
|
||||
## 十三、收款记录管理接口
|
||||
|
||||
### 10.1 获取收款记录列表
|
||||
|
||||
@ -1847,7 +2003,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 十三、操作日志管理接口
|
||||
## 十四、操作日志管理接口
|
||||
|
||||
### 11.1 获取操作日志列表
|
||||
|
||||
@ -2009,7 +2165,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 十四、数据统计分析接口
|
||||
## 十五、数据统计分析接口
|
||||
|
||||
### 13.1 获取仪表盘统计数据
|
||||
|
||||
@ -2135,7 +2291,7 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
## 十五、附录
|
||||
## 十六、附录
|
||||
|
||||
### 14.1 枚举值定义
|
||||
|
||||
|
||||
@ -47,7 +47,19 @@
|
||||
* 状态管理（启用/禁用）
|
||||
* 岗位职责、岗位要求管理
|
||||
* 部门树选择器
|
||||
- 人员分配（部门人员配置）
|
||||
- 人员分配（部门人员配置） ✅
|
||||
- **实现状态**：✅ 已完成
|
||||
- 后端：UserAssignmentVO + UserAssignmentService + UserAssignmentController
|
||||
- 前端：userAssignment.js + userAssignment.vue
|
||||
- 功能：
|
||||
* 分页查询用户分配列表（支持用户名、姓名、部门、岗位、状态过滤）
|
||||
* 按部门查询用户列表
|
||||
* 分配用户到部门和岗位（支持单独分配）
|
||||
* 批量分配用户
|
||||
* 移除用户分配
|
||||
* 仅显示未分配用户筛选
|
||||
* 部门树选择器、岗位下拉选择
|
||||
* 职位管理
|
||||
|
||||
#### 4.1.3 系统配置
|
||||
- 基础参数设置（公司信息、币种、日期格式等）
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user