关心人功能 — API 接口文档

1. 设计意图

1.1 关心人是什么

"关心人"（watcher）是 对产品 / 项目本身长期感兴趣，但不参与交付 的人。典型场景：

• 外部顾问需要长期看某产品的进度 / 需求
• 跨部门评审人（如营销、财务）需要看某项目的概览
• 领导层非直接负责，但要持续关注某产品

1.2 为什么不直接加成员？

1.3 关心人的数据权限路径

关心人记录最终落到 rdms_user_object_role 表（与 member 同表，只是 role_id 指向 watcher 角色）。系统按这个角色让用户进入"数据权限通道 1（自己参与）"，跟普通成员路径一致 —— 区别只在 菜单 / 按钮粒度 由 watcher 角色绑定的权限决定。

2. 用户旅程 / 前端交互

2.1 当前两步向导（产品 / 项目都一样）

1. 第 1 步 ：填基础资料 —— 名称 / 编码 / 方向 / 负责人等
2. 第 2 步 ：维护初始团队 —— 必须含负责人本人 + 其他成员（每人一个业务角色）

2.2 本次新增 — 第 2 步追加"关心人"区块

建议 UI：第 2 步页面里在"团队成员"列表下方加一个独立区块" 关心人（选填） "，含一个用户多选控件。

┌─────────────────────────────────────────────────────────┐
│  第 2 步：维护初始团队                                     │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  团队成员 *                                              │
│  ┌────────────────────────────────────────────────────┐ │
│  │ [+] 添加成员                                       │ │
│  │  · 张三   产品经理      操作 ▾                     │ │
│  │  · 李四   开发          操作 ▾                     │ │
│  └────────────────────────────────────────────────────┘ │
│                                                         │
│  关心人（选填）                                           │
│  ┌────────────────────────────────────────────────────┐ │
│  │ [多选用户] 王五 ╳  赵六 ╳                          │ │
│  └────────────────────────────────────────────────────┘ │
│  提示：关心人将获得"产品/项目关心人"角色，能在列表和概览看到此对象，  │
│       但不开放代码 / 任务 / 文档等执行细节。可与团队成员重叠。      │
│                                                         │
│  [取消]                                  [上一步] [完成] │
└─────────────────────────────────────────────────────────┘

2.3 提交时数据组装

点击"完成"时，按 §4 / §5 的 ReqVO 结构组装：

• product / project 块 = 第 1 步表单
• members 块 = 第 2 步团队成员列表
• watcherUserIds = 第 2 步关心人多选控件的 userId 数组 （可空 / 可省略字段）

3. 接口列表速览

4. 主接口 — 创建产品（含团队 + 关心人）

{
  "product": {
    "code": "CNPD2026001",
    "directionCode": "system",
    "name": "RDMS 产品平台",
    "managerUserId": 1024,
    "description": "面向研发管理的一体化产品"
  },
  "members": [
    { "userId": 1024, "roleId": 3100000002001, "remark": "产品经理本人" },
    { "userId": 1025, "roleId": 3100000002002, "remark": "开发" }
  ],
  "watcherUserIds": [2001, 2002]
}

{
  "code": 0,
  "data": 30001,   // 新创建的 productId
  "msg": ""
}

5. 主接口 — 创建项目（含团队 + 关心人）

{
  "project": {
    "projectCode": "CNPJ2026001",
    "projectName": "客户交付项目 A",
    "projectType": "delivery",
    "directionCode": "system",
    "productId": 30001,
    "managerUserId": 1024,
    "plannedStartDate": "2026-06-01",
    "plannedEndDate":   "2026-09-30",
    "projectDesc": "为客户 XX 定制交付"
  },
  "members": [
    { "userId": 1024, "roleId": 3100000003001, "remark": "项目负责人本人" },
    { "userId": 1030, "roleId": 3100000003002, "remark": "前端开发" }
  ],
  "watcherUserIds": [2001, 2002]
}

{
  "code": 0,
  "data": 40001,   // 新创建的 projectId
  "msg": ""
}

6. 辅助接口 — 用户精简列表

{
  "code": 0,
  "data": [
    { "id": 1024, "nickname": "张三" },
    { "id": 1025, "nickname": "李四" },
    { "id": 2001, "nickname": "王五" }
  ],
  "msg": ""
}

7. 业务规则 / 边界 / FAQ

7.1 watcher 与 member 可不可以是同一人？

可以。多角色合法，会落两条 rdms_user_object_role 记录（一条 member 角色 + 一条 watcher 角色），数据权限 取并集 。这种情况通常不会出现 —— 已经在团队里的人不需要再设为 watcher —— 但允许重叠不报错，前端不需要做"过滤已在 members 里的 user"的校验，让后端兜底。

7.2 创建之后能不能再加 / 删关心人？

当前 create-with-team 是唯一的批量入口 。创建后维护 watcher 的接口暂未单独提供 —— 如果业务后续需要"在产品 / 项目编辑页面再加关心人"，需要再拉一条接口（沿用现有的 add member / remove member 模式即可，roleId 传 watcher 角色 ID）。

7.3 watcher 进入对象后能看到什么、能做什么？

取决于业务侧给 product_watcher / project_watcher 角色在权限管理界面绑了哪些菜单（对象域菜单 system_menu.scope_type='object' ）。建议粒度：

• 能看 ：概览 / 进度 / 需求（即对象主线 tab）
• 不开放 ：代码 / 任务详情编辑 / 文档 / 工时 / 成员管理等执行细节
• 按钮粒度 ：后端不扩字段，按"对象域内按钮可见性由前端控制"原则，前端按当前用户在该对象内的 role code 自行判断。watcher 几乎所有写按钮都不显示。

7.4 watcher 字段不传会怎样？

完全等价于传空数组。 watcherUserIds 是可选字段 —— 不写 / 写 null / 写 [] 都不会落任何 watcher 记录，接口正常完成。

7.5 watcher 列表能放多少人？

当前没有上限校验。从产品语义看，关心人本来就是"少量长期看的人"，前端可以加个软性提示（如超过 20 人时提示考虑用方向级 visibility_config 配置），但不阻塞提交。

7.6 关心人能看到对象里的"工时"吗？

看不到。工时是敏感数据，按对象内身份控制：协办人只看自己填报的工时；任务/项目负责人可看团队成员工时。 watcher 既不是协办人也不是负责人，工时列表对其不可见 。

7.7 watcher 和"用户可见性配置（visibility_config）"什么区别？