第1章 B2B权限验收全景图：用户反馈驱动迭代的价值、验收生命周期、课程案例背景

1.1 适用场景

本章全景图适用于以下三类典型场景，也是本课程后续 29 章所覆盖的核心上下文：

1.2 前置条件

在启动验收生命周期之前，必须完成以下 5 项准备工作（缺一不可）：

1. 权限基线文档已评审： 包含 RBAC 矩阵、数据范围策略、权限与角色映射表，经产品、安全、开发三方签字确认。
2. 验收环境已隔离： 使用与生产环境 1:1 的权限配置副本，避免交叉污染。
3. 用户反馈通道已建立： 企服通在此环节部署了内嵌“权限异常反馈”浮标 + 企业微信群机器人，确保反馈可实时采集。
4. 验收团队角色已分配： 至少包括验收负责人、业务代表、安全审计员、技术支持 4 个角色（详见 1.5 责任矩阵）。
5. 验收工具链就绪： 权限比对工具、配置自动化脚本、问题追踪系统（如 Jira）均已联调通过。

# 企服通验收环境准备检查脚本（示例片段）
验收环境检查项：
  - 权限基线版本: v3.0.2-rc1
  - RBAC 策略文件: /etc/permission/policy.json
  - 测试租户数: 12（覆盖全部行业模板）
  - 测试账号池: 48 个（含超管、租户管理员、普通用户、只读用户）
  - 反馈采集端点: https://feedback-internal.qft.com/permission/v1

1.3 验收生命周期操作步骤

B2B 权限验收遵循 “采集—构建—验证—整合—优化—监控” 六步闭环，每一步都包含明确的输入、动作与产出。下表列出全生命周期步骤及企服通案例中的对应实践：

1.4 输入输出物

每个生命周期阶段都有明确的输入与输出物，确保验收过程可追溯、可审计。下表列出核心交付物及其格式要求：

// 企服通 RBAC 矩阵 JSON 示例（基线 v3.1 片段）
{
  "tenant": "企服通",
  "version": "3.1.0",
  "roles": [
    {
      "role": "org_admin",
      "description": "租户管理员",
      "data_scope": "TENANT",
      "permissions": [
        {"resource": "customer", "actions": ["create","read","update","delete","export"]},
        {"resource": "order",    "actions": ["create","read","update","delete","approve"]}
      ]
    },
    {
      "role": "sales_rep",
      "description": "销售代表",
      "data_scope": "SELF_AND_TEAM",
      "permissions": [
        {"resource": "customer", "actions": ["create","read","update"]},
        {"resource": "order",    "actions": ["create","read"]}
      ]
    }
  ]
}

1.5 责任边界

权限验收涉及 4 个核心角色与 2 个协作角色，采用 RACI 矩阵 明确职责边界（R=执行者，A=批准者，C=咨询者，I=知情者）：

1.6 记录材料

验收过程中需归档以下 7 类材料，作为审计追溯与知识沉淀的依据：

• 验收计划书： 包含范围、时间表、资源分配、风险预案。
• 用户反馈原始记录： 企服通使用飞书表格实时采集，每一条反馈保留用户身份、时间、截图、期望行为。
• 权限基线文档： 包含 RBAC 矩阵、数据范围策略、权限与角色映射表，每轮迭代后更新版本。
• UAT 测试用例 & 结果： 按“正向/负向/边界/冲突”分类，标记通过/失败/阻塞状态。
• 缺陷清单 & 修复记录： 每个缺陷关联 Jira Issue，包含复现步骤、影响范围、修复版本、回归结论。
• 验收签字单： 业务代表与安全审计员双方签字，确认验收通过。
• 持续监控报告： 上线后首月周报，包含权限异常趋势、反馈量、平均修复时长。

# 企服通验收归档目录结构
/验收文档/v3.0/
├── 01_验收计划书_v1.0.pdf
├── 02_用户反馈原始记录/
│   ├── 反馈采集_2025-01.xlsx
│   └── 反馈热力图_2025-01.png
├── 03_权限基线/
│   ├── RBAC矩阵_v3.0.md
│   ├── RBAC矩阵_v3.1.md
│   └── policy_schema.json
├── 04_UAT测试/
│   ├── 测试用例_216条.xlsx
│   └── UAT报告_v3.0.pdf
├── 05_缺陷与修复/
│   ├── 缺陷清单_28项.csv
│   └── 修复记录_3轮.md
├── 06_验收签字单/
│   └── 签字单_v3.1_已签.pdf
└── 07_持续监控/
    └── 监控周报_上线后4周.pdf

1.7 异常处理

验收过程中可能遇到 5 类典型异常，处理流程遵循 “识别—定级—决策—修复—验证—归档” 六步决策树。下表列出异常类型及对应处理方案：

异常处理决策树（文字描述）：

1. 识别异常 → 2. 判断是否为“高”影响等级 → 是：立即冻结验收环境，通知安全审计员与验收负责人；否：记录至问题队列，按优先级排序。
2. 高影响异常：技术支持 2h 内定位根因，输出修复方案 → 安全审计员 1h 内审核方案 → 开发实施修复。
3. 修复后执行回归验证（至少覆盖该异常关联的全部用例） → 回归通过则解除冻结，继续验收；未通过则返回步骤 2。
4. 所有异常处理结果需归档至《异常处理记录表》，包含：异常编号、等级、根因、修复方案、回归结论、关闭时间。

1.8 验收标准

本章全景图对应的验收标准采用 “4 类指标 + 1 个否决项” 的量化体系，适用于所有生命周期阶段：