6.2 KiB
6.2 KiB
RailwaySystem 端到端浏览器自动化验收报告
文档定位：记录基于 Playwright 的真实前端界面全流程交互、端到端用户路径及跨模块联动验收结果。 基线版本：Final Candidate
5a49b2e2988bf23ca2a70568264c05b24dfda1b6(origin/feat/cicd-pipeline) 执行状态：✅ FINAL_BROWSER_ACCEPTANCE = PASS Swagger 接口平台状态：✅ PASS (系统工具 → 系统接口，v3/api-docs=200，swagger-resources=200) HTTP 500 异常：0 | Console 阻断错误：0
1. 验收测试目标与用例矩阵实测结果
本验收套件模拟真实教务员、任课教师及学员在现代浏览器中的实际交互操作，覆盖以下核心验收阶段，全部通过验证：
flowchart TD
subgraph Phase1["阶段一：系统鉴权与档案"]
TC1["TC-E2E-01: 管理员登录与鉴权 (PASS)"]
TC2["TC-E2E-02: 基础教务档案录入 (PASS)"]
TC1 --> TC2
end
subgraph Phase2["阶段二：教务编排与名单"]
TC3["TC-E2E-03: 计划拟定与课程绑定 (PASS)"]
TC4["TC-E2E-04: 名单导入与报到动作 (PASS)"]
TC5["TC-E2E-05: 排课与四维冲突拦截 (PASS)"]
TC2 --> TC3
TC3 --> TC4
TC3 --> TC5
end
subgraph Phase3["阶段三：现场物联与审计"]
TC6["TC-E2E-06: 考勤花名册与班牌交互 (PASS)"]
TC7["TC-E2E-07: 统计分析与画像只读 (PASS)"]
TC8["TC-E2E-08: 系统工具与操作日志审计 (PASS)"]
TC4 --> TC6
TC5 --> TC6
TC6 --> TC7
TC7 --> TC8
end
| 验收阶段编号 | 验收场景与核心交互路径 | 实测结果 | 关键检查点 |
|---|---|---|---|
| TC-E2E-01 | 系统管理与管理员登录流程 (含验证码与菜单权限加载) | ✅ PASS | 验证码刷新、Token 存储、sys_menu 路由动态加载 |
| TC-E2E-02 | 基础教务档案录入 (教师/学员/教室/场地表单与列表渲染) | ✅ PASS | 教师手机号唯一、学员身份证掩码脱敏（后4位） |
| TC-E2E-03 | 开班计划拟定与课程师资绑定 (计划生命周期流转) | ✅ PASS | 32位UUID主键、初始状态 0:草稿、学时自动联动 |
| TC-E2E-04 | 参训名单批量导入与报到动作 (Enrollment 面板交互) | ✅ PASS | 实际调用 /report 接口 200 OK，待报到 → 已报到 |
| TC-E2E-05 | 可视化课表排课与四维冲突弹窗拦截 (Timetable 交互) | ✅ PASS | Warning Cancel/Confirm 均正常，无 force 违规旁路 |
| TC-E2E-06 | 课次考勤花名册与电子班牌呈现 (Board 交互) | ✅ PASS | 前端路由 /equip/board 正常渲染，代签 manual_flag |
| TC-E2E-07 | 统计分析与画像只读报表 (Analytics Read Only 交互) | ✅ PASS | 报到、考勤、学时、画像报表只读查询与导出 |
| TC-E2E-08 | 系统工具与操作日志审计留痕 (OperLog 校验) | ✅ PASS | 表单构建、代码生成、系统接口正常可见，日志落库 |
2. 核心模块真实验收客观记录
2.1 Swagger 接口平台在线验收
- 验收结论：
PASS - 真实系统入口：
系统工具 → 系统接口 - 接口服务探测：Swagger UI 正常渲染，
v3/api-docs返回 200，swagger-resources返回 200，无 502 坏网关，无死链。
2.2 基础主数据模块 (Master Data)
- Teacher：
PASS（教师档案增删改查、手机号唯一性校验） - Student：
PASS（学员建档、脱敏掩码显示、状态正常） - Classroom：
PASS（理论教室容量、门牌与状态管理） - Site：
PASS（实训场地类型、容量与占用管理）
2.3 教务核心业务 (Business)
- Plan：
PASS（32位UUID计划拟定、生命周期状态初始为 0:草稿） - PlanCourse：
PASS（课程绑定、教师关联、学时自动联动计算） - Enrollment：
PASS（参训入班、容量校验、初始 0:待报到）
2.4 开班报到核验 (Report Confirm)
- 验收结论：
PASS - 实际调用验证：
POST /train/enrollments/{enrollmentId}/report返回 200 OK，学员状态由待报到 (0)成功流转为已报到 (1)。 - 术语与界面说明：前端菜单显示为
UI_MENU_LABEL = 开班签到，业务模型与契约术语为BUSINESS_TERM = 开班报到。
2.5 排课与四维冲突处理 (Scheduling)
- Warning 取消交互：
Warning Cancel = PASS（取消后保持原排课状态不变） - Warning 确认保存交互：
Warning Confirm/Save = PASS（用户确认后成功入库，未破坏时间唯一性不变量） - 合规要求：排课业务逻辑中严格禁止且未出现
force、ignoreConflict、overrideConflict旁路违规参数。 - 课次详情查询：
Lesson detail GET: NOT CALLED（遵循契约规范，不发起多余查询）。
2.6 电子班牌 (Board)
- 验收结论：
PASS - 正式前端路由：
BOARD_FRONTEND_ROUTE = /equip/board（菜单路径：教学设施 → 电子班牌；后端对应 API 路由为/train/board）。
2.7 统计分析与学员画像 (Analytics)
- 报到统计 (Report Analytics)：
PASS / Read Only - 考勤统计 (Checkin Analytics)：
PASS / Read Only - 学时完成度 (Duration)：
PASS / Read Only - 学员多维画像 (Portrait)：
PASS / Read Only
2.8 运维与系统工具 (OperLog & System Tools)
- 操作日志 (OperLog)：
PASS（所有写操作审计日志落库完整） - 系统工具可见项：实际可见「表单构建」、「代码生成」、「系统接口」
- 角色分配管理：
RBAC_ROLE_ASSIGNMENT: ENVIRONMENT_CONFIGURATION - 数据保留策略：
Browser acceptance created/changed data: KEEP_FOR_AUDIT（浏览器验收过程中产生及流转的数据全量保留用于审计追溯，文档阶段不执行清理）。
4. 技术参考链接 (Technical References)
- 综合测试报告：final-test-report.md
- 核心业务测试矩阵：docs/_meta/core-business-test-matrix.md
- 业务主链规范：docs/handbook/02-business-process.md