7.6 KiB

Originale Blame Cronologia

教学实施模块测试报告

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 项包括：

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

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 通过结论写成“真实后端已联调通过”。

7.6 KiB Originale Blame Cronologia