成员列表接口变更 — 前端对接说明

1. 背景：为什么改

多角色改造后， 产品/项目的"创建者"角色会自动落一条 rdms_user_object_role 行 。当 创建者本人就是负责人 时，同一用户在同一对象内会出现两条 ACTIVE 记录：

• 一条 product_manager / project_manager
• 一条 product_creator / project_creator

如果后端原样返回，前端列表会出现"同一个人重复两行"。讨论后约定：后端在 列表接口 层做合并展示， 不影响 底层数据（每个角色行仍独立存在，便于后续可能的"按角色单独操作"）。

2. 受影响的接口（仅 2 个）

响应结构两个接口对称，本文档下文统一用 RespVO 表示，字段路径一致。

3. 改动前后对比

假设：产品 P 里 用户A 是产品经理（同时创建了该产品，所以也有 product_creator 角色）， 用户B 是产品专员， 用户C 是已退场的历史成员。

[
  { id: "100", userId: "A", roleCode: "product_manager",
    roleName: "产品经理", status: 0, ... },
  { id: "101", userId: "A", roleCode: "product_creator",
    roleName: "产品创建者", status: 0, ... },
  { id: "102", userId: "B", roleCode: "product_specialist",
    roleName: "产品专员", status: 0, ... },
  { id: "103", userId: "C", roleCode: "product_specialist",
    roleName: "产品专员", status: 1, leftTime: "..." }
]

[
  { id: "100", userId: "A", roleCode: "product_manager",
    roleName: "产品经理",
    additionalRoleNames: ["产品创建者"],  // ← 新增字段
    status: 0, ... },
  { id: "102", userId: "B", roleCode: "product_specialist",
    roleName: "产品专员",
    additionalRoleNames: [],
    status: 0, ... },
  { id: "103", userId: "C", roleCode: "product_specialist",
    roleName: "产品专员",
    additionalRoleNames: [],
    status: 1, leftTime: "..." }
]

合并规则

4. 新增字段 additionalRoleNames

所有 原有字段保持不变 （ id 、 userId 、 userNickname 、 roleId 、 roleName 、 roleCode 、 managerFlag 、 status 、 joinedTime 、 leftTime 、 remark ），前端原有代码不会因为字段消失而报错。

5. 前端渲染建议

5.1 最简单的展示方式 — 拼成一个字符串

const displayRoleName = additionalRoleNames?.length
  ? `${roleName} + ${additionalRoleNames.join(', ')}`
  : roleName;
//
// 例：roleName="产品经理", additionalRoleNames=["产品创建者"]
// → "产品经理 + 产品创建者"
//
// 例：roleName="产品专员", additionalRoleNames=[]
// → "产品专员"

5.2 更友好的展示 — 主角色 + 浅色 chip 标签

<span class="role-main">{{ roleName }}</span>
<span v-for="extra in additionalRoleNames" :key="extra" class="role-tag">
  {{ extra }}
</span>
//
// CSS：role-tag 设计成浅色 background + 小圆角，跟主角色拉开视觉层级

5.3 表格单元格示意

| 用户       | 角色                       | 状态  |
|-----------|---------------------------|------|
| 灿能管理   | 产品经理 [产品创建者]       | 有效 |
| 洪圣文     | 产品专员                   | 有效 |
| 李凡       | 游客                       | 历史 |

6. 边界场景

7. 不受影响的接口

以下接口 不变 ，前端原有调用方式保持：

8. 前端落地 checklist

变更影响最小范围说明

本次后端改动仅在 ProductMemberServiceImpl.getProductMemberList 和 ProjectMemberServiceImpl.getProjectMemberList 两个方法中实现， 不修改底层数据 （ rdms_user_object_role 仍按一行一角色存储）。即使前端暂时不读 additionalRoleNames 字段，也只是看不到"+ 产品创建者"字样，不会出现数据错误或重复行问题。