- 16 个业务模块,856 个测试用例,40 个 E2E 测试 - 单一 React 19 前端 + PlatformSwitcher 二合一切换 - Flask 后端支持 scenario/dcloud_module/dcloud_e2e/dcloud_all 四种任务类型 - E2E 测试面板:API 全链路(8条) + UI 点击(3条) + 分步测试(3个) - SSE 实时日志流 + 飞书告警 + 定时调度 - 完整还原原 ToB 平台 TestPanel E2E 模块
3.0 KiB
3.0 KiB
测试用例文档规范
文档联动关系
本文档规定 data-loop-automation 测试用例文档怎么写。测试用例应从业务需求、接口资料、页面流程、历史缺陷和现有自动化覆盖中推导,不能只根据实现代码倒推。
| 文档或目录 | 关系 | 使用场景 |
|---|---|---|
../README.md |
主索引 | 判断是否需要读取本文档 |
AUTOMATION-SPEC.md |
工程总规范 | 理解测试类型和运行方式 |
TEST-WRITING-SPEC.md |
测试代码规范 | 将用例落为自动化代码 |
API-TEST-SPEC.md |
API 测试规范 | 编写接口测试用例 |
../test_cases/ |
测试用例目录 | 存放用例清单和模板 |
../docs/coverage/ |
覆盖率报告 | 记录已覆盖、部分覆盖和未覆盖 |
联动规则:
- 新增或修改测试后,应同步检查是否更新
../test_cases/。 - 新增或修改模块用例后,应同步检查是否更新
../docs/coverage/。 - 测试用例不得只覆盖成功路径,必须覆盖权限、异常、边界和回归场景。
1. 存放目录
测试用例统一放入:
test_cases/
通用模板固定为:
test_cases/TEMPLATE.md
完整用例清单当前为:
test_cases/自动化测试用例.md
2. 推荐文档结构
# <模块名> 测试用例
## 1. 文档信息
## 2. 测试范围
## 3. 测试数据与前置条件
## 4. 功能测试用例
## 5. API 测试用例
## 6. 流程与 E2E 测试用例
## 7. 异常与边界测试用例
## 8. 回归测试用例
## 9. 自动化建议
## 10. 覆盖率与未覆盖清单
## 11. 变更记录
3. 用例编号规则
用例 ID 推荐格式:
TC-<模块缩写>-<类型>-<三位序号>
| 类型 | 含义 |
|---|---|
UI |
UI 测试 |
API |
API 测试 |
FLOW |
流程测试 |
E2E |
端到端测试 |
ERR |
异常和边界测试 |
REG |
回归测试 |
示例:
TC-DS-UI-001
TC-DS-API-001
TC-DG-FLOW-001
4. 用例表字段
| 用例 ID | 场景 | 前置条件 | 操作步骤 | 预期结果 | 自动化状态 | 优先级 |
| --- | --- | --- | --- | --- | --- | --- |
自动化状态建议:
| 状态 | 含义 |
|---|---|
| 已覆盖 | 已有稳定自动化测试 |
| 部分覆盖 | 只覆盖 UI、接口或部分步骤 |
| 未覆盖 | 尚未自动化 |
| 待确认 | 功能或验收规则未确认 |
5. 必测场景
每个核心模块至少检查:
- 页面加载和关键元素。
- 创建、查询、更新、删除或模块核心动作。
- 分页、筛选、搜索、排序。
- 认证、权限和数据作用域。
- 参数缺失、参数非法、资源不存在、状态冲突。
- 下游失败、网络超时、重复提交、并发操作。
- 历史缺陷回归。
6. 自动化建议
用例文档应说明哪些用例适合自动化,以及推荐层级:
| 用例 ID | 建议自动化层级 | 原因 |
| --- | --- | --- |
| TC-DS-API-001 | API | 响应稳定,适合快速回归 |
| TC-DS-E2E-001 | E2E | 覆盖完整创建和清理流程 |