# Unreal Tran 内容制作模块测试报告

- 执行时间：2026-08-09 10:46（Asia/Shanghai）
- 测试地址：`http://127.0.0.1:6180`
- 浏览器：Playwright Chromium
- 用例文件：`tests/content-authoring.spec.ts`
- 测试数据前缀：`UTE2E-CONTENT-<唯一值>` / `E2E_MODEL_<唯一值>`

## 1. 结果摘要

| 指标 | 结果 |
|---|---:|
| 用例总数 | 1 |
| 通过 | 1 |
| 失败 | 0 |
| Playwright 用时 | 35.26 秒 |
| 业务测试数据清理 | 成功 |
| 临时认证夹具清理 | 成功 |
| 活动残留数据 | 0 |

## 2. 覆盖范围

| 测试阶段 | 验证点 | 结果 |
|---|---|---|
| 真实登录 | 选择管理员角色，通过网关调用认证服务进入平台 | 通过 |
| 四类内容列表 | 模型、场景、训练项目、作业指导书从真实 API 加载 | 通过 |
| 搜索与重置 | 四类列表按关键字搜索无结果并恢复完整列表 | 通过 |
| 明暗主题 | 四类明亮列表、作业指导书暗黑列表可读 | 通过 |
| 模型新建 | 唯一编码、名称、分类、说明创建成功 | 通过 |
| 动态路由导航 | 编辑路由下内容制作一级菜单、模型管理二级菜单和面包屑保持正确 | 通过 |
| 结构化编辑 | 模型资源 URI、节点数、材质数、动画数保存 | 通过 |
| 资产元数据 | 资产编码、名称、URI、MIME、大小、SHA-256 和 JSON 元数据保存 | 通过 |
| 版本查看 | 版本列表可见，版本详情包含结构化内容和资产 | 通过 |
| 返回与检索 | 返回列表后按唯一编码检索到测试模型 | 通过 |
| 数据清理 | `finally` 删除测试模型，数据库复核无活动项目残留 | 通过 |

## 3. 构建与自动化校验

- 后端：`mvn -q -pl ut_tran -am package`，Java 17，19 个测试全部通过。
- 前端：`pnpm run build`，`vue-tsc --noEmit` 与 Vite 生产构建通过。
- E2E 类型检查：`pnpm run typecheck` 通过。
- E2E：`pnpm exec playwright test tests/content-authoring.spec.ts`，1 通过、0 失败。
- 数据库残留复核：临时用户、会话、凭证、角色关系和 `E2E_MODEL_%` 活动项目均为 0。

## 4. 截图与报告制品

以下 9 张成功截图已保存到 `artifacts/screenshots/`，并附加在 HTML/JSON 报告中：

- `content-models-light`
- `content-scenes-light`
- `content-training-light`
- `content-guides-light`
- `content-guides-dark`
- `content-model-editor-route-active`
- `content-model-version-previewed`
- `content-model-searched`
- `content-model-cleaned`

其他制品：

- HTML 报告：`artifacts/html-report/index.html`
- JSON 结果：`artifacts/results.json`
- Playwright 附件：`artifacts/test-results/`

## 5. 非阻断提示

- Vite 主包仍有大于 500 kB 的构建告警，不影响本轮功能；后续可按页面继续拆包。
- 当前列表响应已只返回轻量 `contentSummary`，但服务端仍需从当前版本工程 JSON 生成摘要。正式导入超大 Three.js 工程前，建议增加独立摘要字段或摘要表，降低列表查询的数据库 I/O。