第2章 用户角色定义错误排查

用户角色定义是B端PRD的骨架——角色一旦出错，后续的功能流程、权限矩阵、交互逻辑全部会偏移。本章聚焦角色遗漏、角色权限混淆、角色描述与场景脱节三类高频错误，按“现象识别 → 数据采集 → 原因定位 → 修复动作 → 复测 → 预防”六步闭环排查。

2.1 现象识别

角色定义错误往往不会直接报错，而是以“需求评审反复争论”“开发返工”“测试用例覆盖不全”等形式暴露。下表列出三类错误的典型“症状”。

2.2 数据采集

在动手排查之前，先收集以下四类数据，确保后续定位有据可依：

1. 角色清单 —— PRD中所有已定义的角色名称、描述、职责列表；
2. 权限矩阵表 —— 角色与功能/数据权限的对应关系（包含增/删/改/查/审核等操作）；
3. 业务流程图 —— 包含角色泳道的跨功能流程图，标注每个节点的执行角色；
4. 业务场景列表 —— PRD中涉及的核心业务流程和使用案例（Use Case）。

将上述数据汇总到一张角色-场景-权限对照表中，缺失项即为排查重点。

2.3 原因定位

采用故障树分析法，从顶层“角色定义异常”向下逐层追溯。下图为本章核心排查框架：

配合故障树，使用下表进行结构化排查：

2.4 修复动作

根据原因定位结果，执行对应的修复操作。每个修复动作必须附带角色定义配置示例，确保修复可落地。

▶ 修复角色遗漏

• 在PRD角色清单中补充缺失的角色，明确角色名称、所属部门、核心职责；
• 在流程图中为新增角色添加泳道，并标注其参与的业务节点。

▶ 修复权限混淆

• 重新梳理权限矩阵，确保每个角色拥有唯一且合理的权限集合；
• 对重叠权限进行合并或拆分，消除二义性。

▶ 修复描述脱节

• 以业务场景为基准，反向修正角色职责描述，使其与实际操作一致；
• 或调整场景用例中的角色分配，确保行为与职责对齐。

修复后的角色定义应遵循以下规范格式（JSON示例）：

{
  "roleName": "内容审核员",
  "department": "内容运营部",
  "coreResponsibilities": [
    "对用户提交的图文内容进行合规审核",
    "对审核不通过的内容发起驳回并填写理由",
    "查询审核日志"
  ],
  "permissions": [
    "content:read",
    "content:audit",
    "content:reject",
    "log:query"
  ],
  "relatedScenarios": [
    "图文审核流程",
    "审核日志查询"
  ]
}

2.5 复测

修复完成后，使用以下检查表进行全量复测：

2.6 预防

将以下预防机制纳入PRD编写规范和评审流程：

• 角色定义前置检查清单 —— 编写PRD前先完成“角色-权限-场景”三栏表，作为编写起点；
• 评审门禁：角色定义独立评审节点 —— 在功能评审之前，先单独过角色定义，避免混在一起导致遗漏；
• 版本变更影响分析 —— 当新增或修改角色时，同步更新权限矩阵和所有涉及其行为的场景用例；
• 角色定义模板标准化 —— 统一使用JSON/表格格式定义角色，消除自然语言描述的模糊地带。