docs: 同步岗位管理模块文档

更新内容:

1. API接口文档.md
   - 新增「三、岗位管理接口」章节(256行)
   - 8个核心接口文档:
     * 3.1 分页查询岗位列表(支持多条件过滤)
     * 3.2 按部门ID查询岗位列表
     * 3.3 获取所有启用的岗位列表
     * 3.4 获取岗位详情
     * 3.5 创建岗位
     * 3.6 更新岗位
     * 3.7 删除岗位
     * 3.8 更新岗位状态
   - 完整的请求参数、响应示例、字段说明
   - 调整后续所有章节编号(四~十五)

2. 资金服务平台 FundPlatform 功能清单.md
   - 标记「岗位管理(岗位定义、职责描述)」为已完成 
   - 添加实现状态说明:
     * 后端:PostMapper + PostService + PostController
     * 前端:post.js + post.vue
     * 功能清单:8大功能点
     * 部门树选择器、状态管理、职责描述

文档与代码同步完成!
This commit is contained in:
zhangjf 2026-02-16 09:43:22 +08:00
parent 84adda022e
commit 25776cc9a4
2 changed files with 278 additions and 14 deletions

View File

@ -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` **接口地址:** `POST /api/v1/auth/login`
@ -531,7 +784,7 @@ X-Tenant-Id: 1
--- ---
## 、用户管理接口 ## 、用户管理接口
### 3.1 获取用户列表 ### 3.1 获取用户列表
@ -729,7 +982,7 @@ X-Tenant-Id: 1
--- ---
## 、租户管理接口 ## 、租户管理接口
### 4.1 获取租户列表 ### 4.1 获取租户列表
@ -793,7 +1046,7 @@ X-Tenant-Id: 1
--- ---
## 、客户管理接口 ## 、客户管理接口
### 5.1 获取客户列表 ### 5.1 获取客户列表
@ -892,7 +1145,7 @@ X-Tenant-Id: 1
--- ---
## 、项目管理接口 ## 、项目管理接口
### 6.1 获取项目列表 ### 6.1 获取项目列表
@ -1197,7 +1450,7 @@ X-Tenant-Id: 1
--- ---
## 、需求工单接口 ## 、需求工单接口
### 7.1 获取需求列表 ### 7.1 获取需求列表
@ -1266,7 +1519,7 @@ X-Tenant-Id: 1
--- ---
## 、支出管理接口 ## 、支出管理接口
### 8.1 获取支出类型列表 ### 8.1 获取支出类型列表
@ -1332,7 +1585,7 @@ X-Tenant-Id: 1
--- ---
## 十、应收款管理接口 ## 十、应收款管理接口
### 9.1 获取应收款列表 ### 9.1 获取应收款列表
@ -1406,7 +1659,7 @@ X-Tenant-Id: 1
--- ---
## 十、收款记录管理接口 ## 十、收款记录管理接口
### 10.1 获取收款记录列表 ### 10.1 获取收款记录列表
@ -1594,7 +1847,7 @@ X-Tenant-Id: 1
--- ---
## 十、操作日志管理接口 ## 十、操作日志管理接口
### 11.1 获取操作日志列表 ### 11.1 获取操作日志列表
@ -1756,7 +2009,7 @@ X-Tenant-Id: 1
--- ---
## 十、数据统计分析接口 ## 十、数据统计分析接口
### 13.1 获取仪表盘统计数据 ### 13.1 获取仪表盘统计数据
@ -1882,7 +2135,7 @@ X-Tenant-Id: 1
--- ---
## 十、附录 ## 十、附录
### 14.1 枚举值定义 ### 14.1 枚举值定义

View File

@ -35,7 +35,18 @@
* 负责人管理(姓名+电话) * 负责人管理(姓名+电话)
* 状态管理(启用/禁用) * 状态管理(启用/禁用)
* 排序功能 * 排序功能
- 岗位管理(岗位定义、职责描述) - 岗位管理(岗位定义、职责描述) ✅
- **实现状态**:✅ 已完成
- 后端PostMapper + PostService + PostController
- 前端post.js + post.vue
- 功能:
* 分页查询(支持编码、名称、部门、状态过滤)
* 按部门查询岗位列表
* 获取所有启用的岗位
* 新增/编辑/删除岗位
* 状态管理(启用/禁用)
* 岗位职责、岗位要求管理
* 部门树选择器
- 人员分配(部门人员配置) - 人员分配(部门人员配置)
#### 4.1.3 系统配置 #### 4.1.3 系统配置