# WP14 用户验收计划与执行报告

## 1. 文档信息

- 工作包：WP14 用户验收与移交
- 执行日期：2026-07-30
- 验收分支：`codex/dataops-phase1-equipment-governance`
- 验收层级：本地工程预验收
- 用例清单：`docs/acceptance/WP14_UAT_CASES.json`

## 2. 验收结论

WP14 已完成本地工程预验收。共编制 21 条验收用例，其中 16 条为
`PASS_LOCAL`，5 条为 `BLOCKED_EXTERNAL`，没有本地失败用例。验收期间发现
2 个 P1 缺陷，均已修复并完成变更面回归；未发现 P0 缺陷。

本结论证明第一阶段功能在当前演示数据、当前分支和本地运行环境中具备移交给
企业用户开展正式验收的条件，但不能替代企业真实数据 UAT。企业真实用户、
真实数据、正式网络与安全策略、培训确认和验收签字仍属于正式验收门禁。

## 3. 验收范围与方式

本次覆盖 WP02 至 WP13 已交付能力，按管理员、编辑者、查看者三类角色验证：

- 设备台账、来源追溯和责任覆盖。
- 设备语义、本体发布、实体匹配及合并回滚。
- 质量规则、质量检查、问题整改闭环。
- 设备运行维护事件、根因分析证据边界。
- 治理知识检索、问答拒答和证据展示。
- 治理指标、审计、部署、备份与恢复材料。
- 用户、角色、治理责任和只读边界。

浏览器场景、角色 API 矩阵、数据检查和文档契约共同作为验收证据。破坏性写入
只使用临时账号和无效导入请求；临时账号已停用，无效请求未产生业务数据。

## 4. 用例执行汇总

| 验收层级 | 状态 | 数量 | 说明 |
|---|---:|---:|---|
| 本地工程预验收 | PASS_LOCAL | 16 | 当前分支、演示数据和本地环境验证通过 |
| 企业正式验收 | BLOCKED_EXTERNAL | 5 | 需要企业人员、真实数据、正式环境或签字 |
| 本地工程预验收 | FAIL | 0 | 无遗留失败用例 |

详细步骤、预期结果、实际结果和证据定位见
`docs/acceptance/WP14_UAT_CASES.json`。

## 5. 第一阶段指标核对

| 指标 | 本地结果 | 企业正式验收要求 | 结论 |
|---|---|---|---|
| 核心设备台账录入率 | 4/4，100% | 企业样本不低于 95% | PASS_LOCAL |
| 设备责任覆盖率 | 4/4，100% | 企业样本不低于 95% | PASS_LOCAL |
| 来源标识覆盖率 | 4/4，100% | 企业样本 100% | PASS_LOCAL |
| 已确认合并回滚成功率 | 1/1，100% | 企业确认样本 100% | PASS_LOCAL |
| 质量问题来源定位 | 可定位规则、对象和整改记录 | 企业问题样本 100% 可定位 | PASS_LOCAL |
| 首批质量问题闭环率 | 1/1，100% | 企业首批问题不低于 80% | PASS_LOCAL |
| 知识问答证据边界 | 模型不可用时拒绝推测，并展示检索证据 | 企业知识样本引用率 100% | BLOCKED_EXTERNAL |
| 关键操作审计覆盖 | 登录、摄取、实体、语义、质量、整改、知识查询均可审计 | 企业关键操作 100% | PASS_LOCAL |
| 全新环境安装 | 已有本地离线包和安装证据 | 企业目标环境完成 1 次 | BLOCKED_EXTERNAL |
| 备份恢复 | 本地恢复核对通过 | 企业目标环境完成 1 次 | BLOCKED_EXTERNAL |

本地指标用于证明能力和流程可执行，不作为企业生产数据指标的替代。

## 6. 角色验收结果

| 角色 | 可用能力 | 权限边界 | 结果 |
|---|---|---|---|
| 管理员 | 全部业务能力、用户与审计管理 | 可执行管理写操作 | PASS_LOCAL |
| 编辑者 | 设备治理、质量、运行维护等业务操作 | 用户管理和审计接口返回 403 | PASS_LOCAL |
| 查看者 | 已授权业务数据只读查询 | 管理页面不可达，写接口返回 403 | PASS_LOCAL |

查看者进入数据研究中心时会看到只读提示，新增摄取和治理评审入口不展示。
查看者直接访问用户管理页面会跳转到 404，服务端同时保持 403 权限校验。

## 7. 关键业务场景结果

- 设备台账展示 4 条演示资产，并可查看来源标识、版本和追溯入口。
- 设备语义本体为已发布版本，包含 11 个类别、10 个关系和 6 个映射。
- 实体匹配候选可展示确定性信号、合并证据和已回滚状态。
- 质量中心展示 7 条规则、2 次运行和 1 条已关闭整改问题。
- 运行维护中心可查看 4 条事件；对证据不足的停机事件不会生成确定性根因。
- 管理员知识问答在模型不可用时明确拒绝推测，并展示 1 条来源证据。
- 治理指标展示台账完整率、责任覆盖率、实体映射率和问题闭环率。
- 审计中心的 6 项安全检查通过，关键类别与审计封印可查询。

## 8. 缺陷结论

验收发现并关闭 2 个 P1 缺陷：

1. 用户创建接口返回业务码 201 时，前端将成功响应误判为失败。
2. 查看者可见新增摄取和治理评审入口，缺少明确的只读提示。

缺陷详情、根因、修复和回归证据见
`docs/acceptance/WP14_DEFECT_REGISTER.md`。当前未发现 P0，未遗留阻断本地工程
预验收的缺陷。

## 9. 环境与发布边界

前端源代码构建成功，浏览器场景使用本次构建产物在本地容器中验证。由于外部
镜像仓库获取 Node 和 Nginx 基础镜像元数据超时，本次没有生成新的最终前端
镜像；这不影响源代码构建和本地功能验证，但正式发布前仍需在可访问镜像仓库
的构建环境中重新构建、签名并保存制品证据。

WP13 已完成本地离线包、备份与恢复证据。企业干净主机安装、正式 RPO/RTO
演练和灾备签字仍需企业环境完成。

## 10. 企业正式 UAT 计划

1. 企业确定验收负责人、业务代表、安全代表和运维代表。
2. 准备脱敏后的真实设备、质量问题和运行维护样本。
3. 按 `WP14_UAT_CASES.json` 中 `BLOCKED_EXTERNAL` 用例补录实际结果。
4. 完成角色映射、安全策略、目标环境安装和备份恢复演练。
5. 记录 P0/P1 缺陷并按严重等级完成关闭或形成书面豁免。
6. 完成用户培训、运维培训、移交清单核对和验收签字。

## 11. 正式验收门禁

- P0 缺陷为 0，未关闭 P1 已获得业务与技术负责人书面处置决定。
- 企业样本指标达到第一阶段验收标准。
- 正式账号和权限矩阵经企业安全负责人确认。
- 目标环境安装、备份和恢复演练完成。
- 用户手册、运维手册和培训记录完成移交。
- 产品负责人、业务负责人、技术负责人和运维负责人完成签字。

## 12. 签署状态

| 签署角色 | 当前状态 |
|---|---|
| 产品负责人 | 待企业正式 UAT 完成后签署 |
| 业务负责人 | 待企业指定并签署 |
| 技术负责人 | 待企业指定并签署 |
| 运维负责人 | 待企业指定并签署 |