From 3dd1b88749314be38aa2c3a30b28294a0e7a90a8 Mon Sep 17 00:00:00 2001 From: zhangjf Date: Mon, 16 Feb 2026 09:04:06 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E6=88=90=E5=91=98=E7=AE=A1=E7=90=86=E6=A8=A1=E5=9D=97=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 更新内容： 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大功能点 文档与代码同步完成！ --- doc/API接口文档.md | 212 ++++++++++++++++++++++ doc/资金服务平台 FundPlatform 功能清单.md | 12 +- 2 files changed, 223 insertions(+), 1 deletion(-) diff --git a/doc/API接口文档.md b/doc/API接口文档.md index c2dd0d5..cadb7d7 100644 --- a/doc/API接口文档.md +++ b/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 获取需求列表 diff --git a/doc/资金服务平台 FundPlatform 功能清单.md b/doc/资金服务平台 FundPlatform 功能清单.md index 395f137..87697f3 100644 --- a/doc/资金服务平台 FundPlatform 功能清单.md +++ b/doc/资金服务平台 FundPlatform 功能清单.md @@ -35,9 +35,19 @@ - 项目基本信息维护（项目名称、编号、负责人、开始/结束日期） - 项目状态管理（筹备中、进行中、已完成、已归档） -#### 4.3.2 项目关联管理 +#### 4.3.2 项目关联管理 ✅ - 客户关联（项目所属客户） - 团队成员分配（项目经理、开发人员、财务等） +- **实现状态**：✅ 已完成 + - 后端：ProjectMemberMapper + ProjectMemberService + ProjectMemberController + - 前端：projectMember.js + projectMember.vue + - 功能： + * 按项目查询成员列表 + * 按用户查询项目列表 + * 添加/编辑/移除成员 + * 角色管理（项目经理/开发/测试/财务/普通成员） + * 状态管理（在职/已离开） + * 工作量占比管理 ---