# WP14 用户验收与移交实施计划

> 日期：2026-07-30
> 工作包：WP-14
> 分支：`codex/dataops-phase1-equipment-governance`

## 1. 目标与完成边界

WP14 将 WP02～WP13 已形成的设备数据运营与治理能力组织成一套可复核、可移交的第一阶段交付包，完成本地工程预验收、缺陷登记、操作培训材料、运维交接材料和第二阶段待办。

本工作包不把本地示范数据、自动化测试、页面截图或开发人员自测等同于企业正式验收。以下外部条件未满足前，WP14 只能标记为“工程完成，待企业 UAT 与正式移交”：

1. 企业验收负责人、业务用户和运维负责人到位；
2. 企业真实设备、故障、维修、告警等数据完成脱敏接入；
3. 企业角色、业务域、质量规则、指标阈值和恢复策略完成确认；
4. 真实场景 UAT 通过，P0 缺陷全部关闭；
5. 企业验收负责人完成签字，发布和运维责任完成交接。

## 2. 交付物

| 交付物 | 路径 | 用途 |
|---|---|---|
| UAT 用例集 | `docs/acceptance/WP14_UAT_CASES.json` | 机器可读的角色、场景、预期和证据契约 |
| UAT 计划与报告 | `docs/acceptance/WP14_UAT_PLAN_AND_REPORT.md` | 记录范围、环境、结果、外部门禁和签字状态 |
| 缺陷台账 | `docs/acceptance/WP14_DEFECT_REGISTER.md` | 记录严重度、状态、证据、处置和遗留风险 |
| 用户操作手册 | `docs/guides/DATAOPS_PHASE1_USER_OPERATION_GUIDE.md` | 面向管理员、编辑者、查看者的业务操作说明 |
| 运维与培训移交 | `docs/runbooks/DATAOPS_PHASE1_OPERATIONS_HANDOVER.md` | 安装恢复入口、巡检、告警、培训和责任交接 |
| 第二阶段待办 | `docs/roadmap/DATAOPS_PHASE2_BACKLOG.md` | 将首期边界转为可排序、可验收的后续工作 |
| WP14 证据 | `docs/validation/WP14_UAT_HANDOVER_EVIDENCE.md` | 汇总测试、页面、接口和文档复核证据 |
| 交付契约测试 | `tests/test_wp14_delivery_contract.py` | 防止交付物缺失、占位符和成熟度越界 |

## 3. 实施步骤

### 3.1 交付契约先行

先编写 `tests/test_wp14_delivery_contract.py`，要求：

- 用例覆盖 WP02～WP13，至少包含管理员、编辑者和查看者三类角色；
- 每条用例具有前置条件、步骤、预期、证据、结果和验收层级；
- 工程预验收与企业正式验收使用不同结果状态；
- 报告明确示范数据不能代替企业真实 UAT；
- 缺陷台账包含严重度、状态、证据和处置决定；
- 第二阶段待办可追溯到现有模块，并保留 SSO 的第三阶段触发条件；
- 正式交付文档不存在 `TBD`、`TODO` 或模板占位符。

先运行测试并确认因交付物尚未创建而失败，再补齐交付物使测试通过。

### 3.2 本地关键场景预验收

使用当前本地 Compose 环境进行受影响范围内的验收，不执行全量回归。验收覆盖：

1. 管理员：用户与权限、责任矩阵、安全审计和审计封存；
2. 编辑者：设备数据受控接入、实体候选处理、质量问题整改；
3. 查看者：资产目录、搜索、质量、关系根因、治理指标只读查看；
4. 通用场景：授权边界、来源引用、证据不足拒答、指标明细追溯；
5. 交付场景：离线安装、备份、恢复和回滚入口能够被运维人员找到并复核。

浏览器验证使用页面文本、可见操作和必要截图作为证据，接口验证补充精确状态码。临时验收账号在验证完成后停用，避免保留无必要的活动凭据。

### 3.3 缺陷收口

- P0：阻断核心业务闭环、安全隔离、数据不可恢复或无法部署，必须关闭；
- P1：核心功能错误但存在受控替代路径，原则上在 WP14 关闭；
- P2/P3：非阻断优化可经产品和验收负责人确认后转入第二阶段；
- 每个缺陷记录复现步骤、影响、修复提交、验证证据和最终决定；
- 若发现代码缺陷，先补失败测试，再做最小修复和定向验证。

### 3.4 培训与移交

用户手册按照角色和业务任务组织，不按代码模块组织。运维手册链接 WP13 已验证的安装、升级、备份和恢复流程，补充每日/每周巡检、异常升级、密钥和备份责任、发布审批以及回退条件。

培训材料至少覆盖：

- 平台边界与三类角色；
- 设备资产、语义、匹配、质量、整改、关系、问答和指标闭环；
- 证据与审计的使用方法；
- 安装恢复和故障升级演练；
- 企业正式 UAT 的数据、人员和签字准备。

### 3.5 第二阶段待办

第二阶段聚焦设备示范域向可复用数据运营平台演进，包括主动元数据、通用术语标准、通用质量运营、平台可观测、统一责任与待办、数据产品治理、Agent 治理、安全底座和产品工程。

单点登录保持第三阶段能力；仅当明确试点客户把统一认证列为上线前置、提供 IdP 与 Claims 规范、完成故障降级和安全责任确认后，才允许通过范围变更提前。

## 4. 验证与提交

只执行以下定向验证：

1. `tests/test_wp14_delivery_contract.py`；
2. 与验收过程中实际修复代码直接相关的测试；
3. 管理员、编辑者、查看者的关键页面与权限场景；
4. 文档链接、占位符、用例结果和证据路径复核；
5. `git diff --check` 和最终工作区检查。

验证完成后更新第一阶段工作计划的 WP14 状态，形成 WP14 证据文档并提交到当前本地分支；不推送、不部署生产。