# 教学实施模块测试报告

## 1. 本轮结论与边界

本轮对教学实施模块执行了浏览器级状态化 UI 契约回归，覆盖指导书、训练记录、教员预览、对抗监控、三通道运行工作台、正式考核保护和沉浸本地配置。

> **重要：本报告中的 16 项通过均基于 Playwright 状态化 Mock，不等于真实 API、KingBase、Redis、Nginx 或测试服务器联调通过。** Mock 会按照最终公开 API 校验方法、DTO、版本、角色和状态变化，但不会访问或修改真实 UAT 数据。本轮没有启停服务，也没有清理真实测试数据。

| 验证层级 | 本轮状态 | 说明 |
| --- | --- | --- |
| Playwright 状态化 UI 契约 | 通过 | 16 / 16，Chromium 单 worker |
| E2E TypeScript | 通过 | `tsc --noEmit` |
| 真实 API 只读联调 | 未执行 | `teaching-live.spec.ts` 独立执行，不能由 Mock 结果替代 |
| Java 策略与数据库测试 | 不在本报告范围 | 由 API 工程测试负责 |
| 部署环境烟测 | 不在本报告范围 | 由发布后的 IP + 端口环境验证 |

## 2. 本轮重点回归

### 2.1 指导书与训练记录

- 从虚拟仿真任务模块进入“作业指导书”。
- 打开 2 章 3 步的正式发布指导书，依次阅读“断电隔离”“压力释放”“复装与复测”。
- 验证章节目录、正文、安全要求、验收标准、技术参数和阅读进度。
- 从全文阅读返回指导书列表，再返回训练任务页。
- 从任务页进入训练记录，验证搜索区与单一表格结构。
- 打开训练记录详情，验证成绩、评定结果和 `2 / 2` 步骤快照。
- 从详情返回记录列表，再进入“完整过程”。
- 完整过程展示真实运行工作台和服务端公开事件；教员身份为只读观察，不出现学员写操作。
- 从完整过程返回后仍保持 `?view=records`，再可回到训练任务页。

### 2.2 教员预览

- 教员预览为完整工作台：步骤树、真实 Three.js 场景、教学指导、数字教员、规则检测点、操作坞和视角控制均存在。
- 不使用 iframe。
- 预览中的步骤试走和过程记录仅保存在浏览器内。
- 测试对比交互前后的请求，`POST / PUT / DELETE` 数量保持不变。
- 未接入的语音和规则执行明确标识，不伪造成功结果。

### 2.3 对抗任务监控

- 从任务卡进入独立监控路由 `/teaching/confrontation/tasks/{assignmentId}/monitor`。
- 验证 RED、BLUE 两条运行可切换，当前运行、成员、进度、事件和三维场景随选择更新。
- 验证监控页加载真实 Three.js 画布和已发布训练资产。
- 验证故障注入采用最终 API 公私载荷契约：公开载荷只有故障引用和公开说明；故障真值仅进入 `privatePayload`。
- 创建干预后继续调用激活接口，并在监控页显示活动干预。
- 从监控页进入三维观察，教员只能查看运行状态，不出现岗位推进和团队提交按钮。

### 2.4 三通道运行工作台与正式考核

- 虚拟仿真：步骤轨、三维场景、规则目标、数字教员、运行日志和操作坞。
- 实装实训：步骤轨、实装镜像工位、设备/视觉/人工事件通道、过程评定和事件时间线。
- 对抗训练：步骤与岗位、三维协同态势、团队成员、公开故障、教学干预和负责人提交边界。
- 三个通道均不使用 iframe，均加载发布场景资产。
- 正式考核只消费服务端 execution 投影；页面只显示当前步骤，后续内容不从完整定义泄露。
- 正式考核不显示操作帮助、过程记录、回放、演示、提示和数字教员。

### 2.5 沉浸交互本地配置

- 修改“扳机键”映射并保存到 `unreal-tran:teaching-xr-preferences:v1`。
- 刷新页面后从 `localStorage` 恢复映射。
- 点击“恢复默认”后还原默认映射并删除本地配置键。
- 本地配置只保存呈现模式和按键映射，不保存训练进度、校准结果或设备位姿。

## 3. 自动化执行结果

| 检查 | 命令 | 结果 |
| --- | --- | --- |
| TypeScript | `npm run typecheck` | 通过 |
| 新增聚焦回归 | `npx playwright test tests/teaching-module.spec.ts --project=chromium --reporter=list -g "指导书和训练记录\|对抗任务监控\|三通道运行工作台\|本地按键配置"` | 4 / 4 通过，57.1 秒 |
| 教学模块全量 + 教员预览 | `npx playwright test tests/teaching-module.spec.ts tests/teaching-preview-workbench.spec.ts --project=chromium --reporter=list` | 16 / 16 通过，2.7 分钟 |

全量 16 项包括：

1. 六入口、指导书全文阅读、记录详情与完整过程往返。
2. 对抗独立监控、运行切换、三维观察和故障注入。
3. 虚拟/实装/对抗三通道工作台及正式考核锁定。
4. 沉浸本地配置保存、刷新恢复和恢复默认。
5. 纯行政任务与数据中心只读边界。
6. UNION 行政 + 学员 COMMON 领取、开始、推进、提交和评定闭环。
7. 超时结算和权限边界。
8. 教员人工结束运行并继续评定。
9. 对抗开训前结束与开训后超时边界。
10. 实装两步 `physical-events` 权威推进。
11. ASSIGNED 预建运行接收。
12. 对抗多岗位推进、负责人提交与公开干预。
13. 正式考核 Unix 秒和辅助能力锁定。
14. 发布资产加载与 WebXR 桌面会话起止。
15. 数据中心安全明细和 Unix 秒筛选。
16. 教员预览完整工作台与零写请求。

## 4. 状态化 Mock 与最终 API 的一致性

- 学员进度只提交 `completedStepCode` 和动作证据；百分比及下一步骤由服务端响应派生。
- 实装步骤只通过 `/runs/{id}/physical-events` 推进，不绕行通用 progress。
- 对抗岗位校验 actionCode、岗位和负责人提交资格。
- 正式考核使用 `/runs/{id}/execution` 安全投影，不向学员下发完整定义。
- 教学干预允许管理身份提交服务端私密载荷；公开载荷若包含 `privateTruth`、`triggerConfig`、`solution`、`answer` 或 `truth` 会被 Mock 拒绝。
- 激活干预使用版本号，返回服务端权威 `ACTIVE` 状态。
- 预览不调用写接口；本地沉浸偏好不调用教学 API。
- Mock 返回的时间字段遵循 Unix 秒口径。

## 5. 视觉证据

成功截图位于 `ute2e/artifacts/screenshots`，本轮新增的关键标签如下：

- `teaching-guide-full-reader`
- `teaching-training-record-detail`
- `teaching-training-record-full-process`
- `teaching-module-guide-record-roundtrip`
- `teaching-confrontation-monitor-switch`
- `teaching-confrontation-observer-runtime`
- `teaching-runtime-virtual-workbench`
- `teaching-runtime-physical-workbench`
- `teaching-runtime-confrontation-workbench`
- `teaching-runtime-formal-exam-lock`
- `teaching-immersive-local-config-saved`
- `teaching-immersive-local-config-restored`
- `teaching-teacher-preview-initial`
- `teaching-teacher-preview-workbench`

抽检结果：指导书正文、记录详情、对抗监控、三通道工作台、正式考核保护、沉浸配置和教员预览均能形成可判读的中文视觉证据；模型画布可见，页面未出现 iframe 或空白工作区。

## 6. 制品位置

- HTML 报告：`ute2e/artifacts/html-report/index.html`
- JSON 结果：`ute2e/artifacts/results.json`
- 成功截图：`ute2e/artifacts/screenshots`
- 失败诊断：`ute2e/artifacts/test-results`
- 状态化 Mock：`ute2e/tests/teaching-contract-mock.ts`
- 教学模块用例：`ute2e/tests/teaching-module.spec.ts`
- 教员预览用例：`ute2e/tests/teaching-preview-workbench.spec.ts`

真实环境联调必须单独执行并单独报告；不得把本报告的 Mock 通过结论写成“真实后端已联调通过”。