第4章：需求收集与输入物模板
需求收集是RBAC权限体系建设的起点。缺少统一模板会导致需求描述模糊、角色归属混乱、模块遗漏、优先级主观臆断。本章定义标准输入物模板 RBAC需求卡片，包含5个必备字段，作为后续RICE优先级打分的唯一数据入口。
4.1 适用场景
- 产品经理或业务方首次提出RBAC权限需求。
- 已有权限体系需要增、删、改角色或权限时。
- 跨部门协作，需要统一需求提交格式，避免信息丢失。
- 需求评审前，所有需求必须转为标准卡片格式。
4.2 前置条件
- 已定义RBAC系统角色体系（至少存在“角色清单”草稿）。
- 已划分业务模块边界（模块清单或微服务列表）。
- 需求提交方已知晓模板字段填写规范（本章提供）。
- 已文档化“期望优先级”含义（P0～P3四档）。
4.3 操作步骤
- 填写需求描述：用一句话说明“谁在什么场景下需要什么权限”，示例：“运营人员需要在订单列表页导出全部订单数据，需要新增‘订单导出’权限。”不能使用模糊词如“优化权限”“调整角色”。
- 指定关联角色：列出该需求涉及的系统角色名称（如“超级运营”“区域经理”）。若角色不存在，需在备注中写明角色定义草案。
- 列出影响模块：以模块代码或功能名称表示，如“order-service: export”“user-service: audit”。多个模块用逗号分隔。
- 标注期望优先级：从P0（阻塞/安全漏洞）到P3（低优/可延期）中选择。P0必须附带补充说明。
- 填写提交方信息：提交人姓名、所属部门、联系方式、提交日期。方便后续澄清。
- 自检完整性：所有字段均为必填，可额外附加链接（原型图、需求文档URL）。
- 提交至需求池：通过Jira/飞书/TAPD等工具创建卡片，或发送至权限管理员邮箱（按组织惯例）。
4.4 输入输出物
| 物类型 | 名称 | 内容说明 |
|---|---|---|
| 输入物 | 原始需求文档 / 口头需求 | 未经格式化的业务需求，来源可多种。 |
| 输出物 | RBAC需求卡片（结构化数据） | 包含5个必填字段 + 可选扩展字段的标准化记录。 |
| 中间物 | 需求审核备注 | 管理员确认完整性后添加的临时注释（非必填）。 |
4.5 责任边界
- 需求提交方：完整、准确填写模板，确保信息可追溯。
- 权限管理员：审核模板完整性，检查角色名、模块名是否已注册。若发现缺失，第一回合退回补充。
- 架构师/安全官：在需求评审阶段判断是否涉及敏感权限拆分或安全风险（此责任在后续章节展开）。
最佳实践：在模板中增加“关联需求ID”字段，可追溯到上级需求或bug号。建议模板工具自动校验必填项，提交时无法绕过。
4.6 记录材料
所有需求卡片统一存储在《RBAC需求池登记表》中，该表至少包含以下字段：
- 卡片ID、提交日期、需求描述（摘要）、关联角色、影响模块、期望优先级、提交方、状态（待审核/已通过/已关闭）、处理人。
- 记录材料编号格式：
RQ-RBAC-YYYYMMDD-序号。例如RQ-RBAC-20251104-001。
模板示例（CSV 格式）：
卡片ID,提交日期,需求描述,关联角色,影响模块,期望优先级,提交方,状态
RQ-RBAC-20251104-001,2025-11-04,订单导出权限,超级运营,order-service:export,P0,张三/运营部,待审核
RQ-RBAC-20251104-002,2025-11-04,查看用户手机号权限,客服专员,user-service:phone_view,P1,李四/客服部,待审核4.7 异常处理
| 异常场景 | 处理方式 |
|---|---|
| 需求描述过于模糊（如“优化权限”） | 管理员直接退回，要求提交方用“谁+场景+权限”重写。 |
| 关联角色名称在系统角色清单中不存在 | 提交方需附上角色定义草案（角色名、职责、上下级关系），管理员评估后决定是否新增角色。 |
| 影响模块列表包含未注册模块 | 暂缓需求，待模块负责人确认后再推进。 |
| 期望优先级为P0但缺少安全说明 | 强制要求提交方补充安全影响分析（至少三句话）。 |
| 提交方信息不全 | 无法追责，退回补齐。若部门名称不明确，组织级通讯录做映射。 |
注意：任何“跳过必填字段”的行为都算作无效提交。管理员应在SOP中声明：仅接受完全填写的模板，否则不予进入RICE打分环节。
4.8 验收标准
- 每条需求卡片包含全部5个必填字段，且内容非空。
- 关联角色名称在已有角色清单中可找到（或已挂载临时角色定义草案）。
- 影响模块字段中的每个模块名都能对应至已注册模块清单。
- 期望优先级取值仅限 P0 / P1 / P2 / P3，大小写规范。
- 提交方信息包含姓名、部门、联系方式，且联系方式有效。
- 需求卡片状态标识为“待审核”且已记录至需求池登记表。
模板扩展字段（可选）：需求URL、紧急联系人、关联工单号、预计影响用户数。这些字段可提高RICE打分的准确性，但不强制。可在后续迭代中启用。
4.9 本章要点速查
- 模板五字段：需求描述、关联角色、影响模块、期望优先级、提交方信息。
- 填写顺序：描述 → 角色 → 模块 → 优先级 → 提交人。
- 退回条件：任一字段为空、角色/模块未注册、P0无安全说明、提交人信息不全。
- 输出必须存入《RBAC需求池登记表》，卡片ID编码
RQ-RBAC-YYYYMMDD-序号。