diff --git a/doc/API接口文档.md b/doc/API接口文档.md index bffae8a..7374441 100644 --- a/doc/API接口文档.md +++ b/doc/API接口文档.md @@ -371,9 +371,262 @@ X-Tenant-Id: 1 --- -## 三、认证接口 +## 三、岗位管理接口 -### 3.1 用户登录 +### 3.1 分页查询岗位列表 + +**接口地址：** `GET /api/v1/post/list` + +**接口说明：** 分页查询岗位列表，支持多条件过滤 + +**请求参数：** + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| current | Long | 否 | 当前页码，默认1 | +| size | Long | 否 | 每页条数，默认10 | +| postCode | String | 否 | 岗位编码（模糊查询） | +| postName | String | 否 | 岗位名称（模糊查询） | +| deptId | Long | 否 | 所属部门ID | +| status | Integer | 否 | 状态（0-禁用，1-启用） | + +**响应示例：** + +```json +{ + "code": 200, + "message": "操作成功", + "data": { + "records": [ + { + "postId": 1, + "tenantId": 1, + "postCode": "PM", + "postName": "项目经理", + "postDuty": "负责项目整体规划和执行", + "postRequirement": "3年以上项目管理经验", + "deptId": 2, + "sortOrder": 1, + "status": 1, + "remark": "", + "createdTime": "2026-02-13 10:00:00" + } + ], + "total": 10, + "size": 10, + "current": 1 + } +} +``` + +--- + +### 3.2 按部门ID查询岗位列表 + +**接口地址：** `GET /api/v1/post/list/dept/{deptId}` + +**接口说明：** 查询指定部门下所有启用的岗位 + +**路径参数：** + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| deptId | Long | 是 | 部门ID | + +**响应示例：** + +```json +{ + "code": 200, + "message": "操作成功", + "data": [ + { + "postId": 1, + "postCode": "PM", + "postName": "项目经理", + "deptId": 2, + "status": 1 + } + ] +} +``` + +--- + +### 3.3 获取所有启用的岗位列表 + +**接口地址：** `GET /api/v1/post/list/enabled` + +**接口说明：** 获取所有状态为启用的岗位列表 + +**响应示例：** 同3.2 + +--- + +### 3.4 获取岗位详情 + +**接口地址：** `GET /api/v1/post/{postId}` + +**接口说明：** 根据ID查询岗位详情 + +**路径参数：** + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| postId | Long | 是 | 岗位ID | + +**响应示例：** + +```json +{ + "code": 200, + "message": "操作成功", + "data": { + "postId": 1, + "tenantId": 1, + "postCode": "PM", + "postName": "项目经理", + "postDuty": "负责项目整体规划和执行", + "postRequirement": "3年以上项目管理经验", + "deptId": 2, + "sortOrder": 1, + "status": 1, + "remark": "", + "createdTime": "2026-02-13 10:00:00" + } +} +``` + +--- + +### 3.5 创建岗位 + +**接口地址：** `POST /api/v1/post` + +**接口说明：** 创建新岗位 + +**请求参数：** + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| postCode | String | 是 | 岗位编码 | +| postName | String | 是 | 岗位名称 | +| postDuty | String | 否 | 岗位职责描述 | +| postRequirement | String | 否 | 岗位要求 | +| deptId | Long | 否 | 所属部门ID | +| sortOrder | Integer | 否 | 排序号 | +| status | Integer | 否 | 状态（0-禁用，1-启用，默认1） | +| remark | String | 否 | 备注 | + +**请求示例：** + +```json +{ + "postCode": "DEV", + "postName": "开发工程师", + "postDuty": "负责软件开发工作", + "postRequirement": "计算机相关专业，1年以上开发经验", + "deptId": 2, + "sortOrder": 2, + "status": 1 +} +``` + +**响应示例：** + +```json +{ + "code": 200, + "message": "创建成功", + "data": null +} +``` + +--- + +### 3.6 更新岗位 + +**接口地址：** `PUT /api/v1/post/{postId}` + +**接口说明：** 更新岗位信息 + +**路径参数：** + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| postId | Long | 是 | 岗位ID | + +**请求参数：** 同3.5 + +**响应示例：** + +```json +{ + "code": 200, + "message": "更新成功", + "data": null +} +``` + +--- + +### 3.7 删除岗位 + +**接口地址：** `DELETE /api/v1/post/{postId}` + +**接口说明：** 删除指定岗位 + +**路径参数：** + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| postId | Long | 是 | 岗位ID | + +**响应示例：** + +```json +{ + "code": 200, + "message": "删除成功", + "data": null +} +``` + +--- + +### 3.8 更新岗位状态 + +**接口地址：** `PUT /api/v1/post/{postId}/status` + +**接口说明：** 更新岗位状态（启用/禁用） + +**路径参数：** + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| postId | Long | 是 | 岗位ID | + +**请求参数：** + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| status | Integer | 是 | 状态（0-禁用，1-启用） | + +**响应示例：** + +```json +{ + "code": 200, + "message": "状态更新成功", + "data": null +} +``` + +--- + +## 四、认证接口 + +### 4.1 用户登录 **接口地址：** `POST /api/v1/auth/login` @@ -531,7 +784,7 @@ X-Tenant-Id: 1 --- -## 四、用户管理接口 +## 五、用户管理接口 ### 3.1 获取用户列表 @@ -729,7 +982,7 @@ X-Tenant-Id: 1 --- -## 五、租户管理接口 +## 六、租户管理接口 ### 4.1 获取租户列表 @@ -793,7 +1046,7 @@ X-Tenant-Id: 1 --- -## 六、客户管理接口 +## 七、客户管理接口 ### 5.1 获取客户列表 @@ -892,7 +1145,7 @@ X-Tenant-Id: 1 --- -## 七、项目管理接口 +## 八、项目管理接口 ### 6.1 获取项目列表 @@ -1197,7 +1450,7 @@ X-Tenant-Id: 1 --- -## 八、需求工单接口 +## 九、需求工单接口 ### 7.1 获取需求列表 @@ -1266,7 +1519,7 @@ X-Tenant-Id: 1 --- -## 九、支出管理接口 +## 十、支出管理接口 ### 8.1 获取支出类型列表 @@ -1332,7 +1585,7 @@ X-Tenant-Id: 1 --- -## 十、应收款管理接口 +## 十一、应收款管理接口 ### 9.1 获取应收款列表 @@ -1406,7 +1659,7 @@ X-Tenant-Id: 1 --- -## 十一、收款记录管理接口 +## 十二、收款记录管理接口 ### 10.1 获取收款记录列表 @@ -1594,7 +1847,7 @@ X-Tenant-Id: 1 --- -## 十二、操作日志管理接口 +## 十三、操作日志管理接口 ### 11.1 获取操作日志列表 @@ -1756,7 +2009,7 @@ X-Tenant-Id: 1 --- -## 十三、数据统计分析接口 +## 十四、数据统计分析接口 ### 13.1 获取仪表盘统计数据 @@ -1882,7 +2135,7 @@ X-Tenant-Id: 1 --- -## 十四、附录 +## 十五、附录 ### 14.1 枚举值定义 diff --git a/doc/资金服务平台 FundPlatform 功能清单.md b/doc/资金服务平台 FundPlatform 功能清单.md index 4239594..e508396 100644 --- a/doc/资金服务平台 FundPlatform 功能清单.md +++ b/doc/资金服务平台 FundPlatform 功能清单.md @@ -35,7 +35,18 @@ * 负责人管理（姓名+电话） * 状态管理（启用/禁用） * 排序功能 -- 岗位管理（岗位定义、职责描述） +- 岗位管理（岗位定义、职责描述） ✅ + - **实现状态**：✅ 已完成 + - 后端：PostMapper + PostService + PostController + - 前端：post.js + post.vue + - 功能： + * 分页查询（支持编码、名称、部门、状态过滤） + * 按部门查询岗位列表 + * 获取所有启用的岗位 + * 新增/编辑/删除岗位 + * 状态管理（启用/禁用） + * 岗位职责、岗位要求管理 + * 部门树选择器 - 人员分配（部门人员配置） #### 4.1.3 系统配置