From c184e649ee230fc14e8b36bfa75c404b632f2b77 Mon Sep 17 00:00:00 2001 From: zhangjf Date: Mon, 16 Feb 2026 09:51:56 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E4=BA=BA=E5=91=98?= =?UTF-8?q?=E5=88=86=E9=85=8D=E6=A8=A1=E5=9D=97=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 更新内容： 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大功能点 * 批量分配、未分配筛选、职位管理 文档与代码同步完成！ --- doc/API接口文档.md | 182 ++++++++++++++++++++-- doc/资金服务平台 FundPlatform 功能清单.md | 14 +- 2 files changed, 182 insertions(+), 14 deletions(-) diff --git a/doc/API接口文档.md b/doc/API接口文档.md index 7374441..9009da0 100644 --- a/doc/API接口文档.md +++ b/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 枚举值定义 diff --git a/doc/资金服务平台 FundPlatform 功能清单.md b/doc/资金服务平台 FundPlatform 功能清单.md index e508396..cc36b7d 100644 --- a/doc/资金服务平台 FundPlatform 功能清单.md +++ b/doc/资金服务平台 FundPlatform 功能清单.md @@ -47,7 +47,19 @@ * 状态管理（启用/禁用） * 岗位职责、岗位要求管理 * 部门树选择器 -- 人员分配（部门人员配置） +- 人员分配（部门人员配置） ✅ + - **实现状态**：✅ 已完成 + - 后端：UserAssignmentVO + UserAssignmentService + UserAssignmentController + - 前端：userAssignment.js + userAssignment.vue + - 功能： + * 分页查询用户分配列表（支持用户名、姓名、部门、岗位、状态过滤） + * 按部门查询用户列表 + * 分配用户到部门和岗位（支持单独分配） + * 批量分配用户 + * 移除用户分配 + * 仅显示未分配用户筛选 + * 部门树选择器、岗位下拉选择 + * 职位管理 #### 4.1.3 系统配置 - 基础参数设置（公司信息、币种、日期格式等）