TBC/specs/TEST-CASES-SPEC.md
d-robotics 633a797226 AutoFlow v2.0: 合并 Test (Robogo) + data-loop-automation (D-Cloud) 为统一平台
- 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 模块
2026-06-23 11:48:29 +08:00

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 | 覆盖完整创建和清理流程 |