docs: 同步项目成员管理模块文档
更新内容：
1. API接口文档.md
- 在「六、项目管理接口」章节新增7个项目成员管理接口：
* 6.6 获取项目成员列表（按项目ID）
* 6.7 获取用户的项目列表（按用户ID）
* 6.8 获取项目成员详情
* 6.9 添加项目成员
* 6.10 更新项目成员
* 6.11 移除项目成员
* 6.12 更新成员状态
- 完整的请求参数、响应示例、字段说明
- 角色类型说明（pm/dev/test/finance/member）
2. 资金服务平台 FundPlatform 功能清单.md
- 标记「4.3.2 项目关联管理」为已完成 ✅
- 添加实现状态说明：
* 后端：ProjectMemberMapper + ProjectMemberService + ProjectMemberController
* 前端：projectMember.js + projectMember.vue
* 功能清单：7大功能点
文档与代码同步完成！
This commit is contained in:
zhangjf
parent
588ef25869
commit
3dd1b88749
212
doc/API接口文档.md
212
doc/API接口文档.md
@ -759,6 +759,218 @@ X-Tenant-Id: 1
|
||||
|
||||
---
|
||||
|
||||
### 6.6 获取项目成员列表（按项目ID）
|
||||
|
||||
**接口地址：** `GET /api/v1/project-member/list/project/{projectId}`
|
||||
|
||||
**接口说明：** 查询指定项目的所有成员
|
||||
|
||||
**路径参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| projectId | Long | 是 | 项目ID |
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "操作成功",
|
||||
"data": [
|
||||
{
|
||||
"memberId": 1,
|
||||
"tenantId": 1,
|
||||
"projectId": 1,
|
||||
"userId": 5,
|
||||
"role": "pm",
|
||||
"joinDate": "2026-01-01",
|
||||
"leaveDate": null,
|
||||
"workload": 80.00,
|
||||
"status": 1,
|
||||
"remark": "项目负责人",
|
||||
"createdTime": "2026-01-01 10:00:00"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6.7 获取用户的项目列表（按用户ID）
|
||||
|
||||
**接口地址：** `GET /api/v1/project-member/list/user/{userId}`
|
||||
|
||||
**接口说明：** 查询指定用户参与的所有项目
|
||||
|
||||
**路径参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| userId | Long | 是 | 用户ID |
|
||||
|
||||
**响应示例：** 同6.6
|
||||
|
||||
---
|
||||
|
||||
### 6.8 获取项目成员详情
|
||||
|
||||
**接口地址：** `GET /api/v1/project-member/{memberId}`
|
||||
|
||||
**接口说明：** 根据ID查询项目成员详情
|
||||
|
||||
**路径参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| memberId | Long | 是 | 成员关系ID |
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "操作成功",
|
||||
"data": {
|
||||
"memberId": 1,
|
||||
"tenantId": 1,
|
||||
"projectId": 1,
|
||||
"userId": 5,
|
||||
"role": "pm",
|
||||
"joinDate": "2026-01-01",
|
||||
"leaveDate": null,
|
||||
"workload": 80.00,
|
||||
"status": 1,
|
||||
"remark": "项目负责人",
|
||||
"createdTime": "2026-01-01 10:00:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6.9 添加项目成员
|
||||
|
||||
**接口地址：** `POST /api/v1/project-member`
|
||||
|
||||
**接口说明：** 添加新的项目成员
|
||||
|
||||
**请求参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| projectId | Long | 是 | 项目ID |
|
||||
| userId | Long | 是 | 用户ID |
|
||||
| role | String | 是 | 项目角色（pm/dev/test/finance/member） |
|
||||
| joinDate | Date | 否 | 加入日期 |
|
||||
| workload | Decimal | 否 | 工作量占比（0-100） |
|
||||
| remark | String | 否 | 备注说明 |
|
||||
|
||||
**请求示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"projectId": 1,
|
||||
"userId": 5,
|
||||
"role": "dev",
|
||||
"joinDate": "2026-02-16",
|
||||
"workload": 50.00,
|
||||
"remark": "后端开发"
|
||||
}
|
||||
```
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "添加成功",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6.10 更新项目成员
|
||||
|
||||
**接口地址：** `PUT /api/v1/project-member/{memberId}`
|
||||
|
||||
**接口说明：** 更新项目成员信息
|
||||
|
||||
**路径参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| memberId | Long | 是 | 成员关系ID |
|
||||
|
||||
**请求参数：** 同6.9
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "更新成功",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6.11 移除项目成员
|
||||
|
||||
**接口地址：** `DELETE /api/v1/project-member/{memberId}`
|
||||
|
||||
**接口说明：** 从项目中移除成员
|
||||
|
||||
**路径参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| memberId | Long | 是 | 成员关系ID |
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "移除成功",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6.12 更新成员状态
|
||||
|
||||
**接口地址：** `PUT /api/v1/project-member/{memberId}/status`
|
||||
|
||||
**接口说明：** 更新项目成员状态（在职/离开）
|
||||
|
||||
**路径参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| memberId | Long | 是 | 成员关系ID |
|
||||
|
||||
**请求参数：**
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| status | Integer | 是 | 状态（0-已离开，1-在职） |
|
||||
|
||||
**响应示例：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "状态更新成功",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、需求工单接口
|
||||
|
||||
### 7.1 获取需求列表
|
||||
|
||||
@ -35,9 +35,19 @@
|
||||
- 项目基本信息维护（项目名称、编号、负责人、开始/结束日期）
|
||||
- 项目状态管理（筹备中、进行中、已完成、已归档）
|
||||
|
||||
#### 4.3.2 项目关联管理
|
||||
#### 4.3.2 项目关联管理 ✅
|
||||
- 客户关联（项目所属客户）
|
||||
- 团队成员分配（项目经理、开发人员、财务等）
|
||||
- **实现状态**：✅ 已完成
|
||||
- 后端：ProjectMemberMapper + ProjectMemberService + ProjectMemberController
|
||||
- 前端：projectMember.js + projectMember.vue
|
||||
- 功能：
|
||||
* 按项目查询成员列表
|
||||
* 按用户查询项目列表
|
||||
* 添加/编辑/移除成员
|
||||
* 角色管理（项目经理/开发/测试/财务/普通成员）
|
||||
* 状态管理（在职/已离开）
|
||||
* 工作量占比管理
|
||||
|
||||
|
||||
---
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user