docs: update testing execution notes

This commit is contained in:
hectorzhao
2026-07-02 16:31:41 +08:00
parent e26d8324c3
commit 06562e42dd
4 changed files with 19 additions and 18 deletions
+7 -6
View File
@@ -2,7 +2,7 @@
## 1. 测试目标
第一版测试优先保证短信业务主链路可回归:风控、计费、发送编排、通道路由与报备、查询统计、Gateway 追踪和模拟链路。不依赖真实运营商 CMPP 网关;本地没有 PostgreSQL、Redis、MinIO 时,优先使用 mock、测试替身或 spike 模拟器
第一版测试优先保证短信业务主链路可回归:风控、计费、发送编排、通道路由与报备、查询统计、Gateway 追踪和模拟链路。系统功能验收必须使用真实 NestJS API、Prisma/PostgreSQL、Redis/BullMQ、MinIO 或对应的本地服务;不依赖真实运营商 CMPP 网关,但 Gateway 场景必须通过 Go Gateway、本地 SMSC 模拟器或连接状态回写 API 完成闭环。本地没有 PostgreSQL、Redis、MinIO 时,对应系统功能用例标记为阻塞或未执行,不能用 mock 作为通过依据
系统功能测试用例详见 `docs/system-functional-test-cases.md`。该文档面向第一版验收、人工测试和后续 E2E 自动化改造,覆盖客户端、运营端、API、Gateway 和性能 smoke 场景。
@@ -23,11 +23,12 @@
### 2.2 集成测试
- 第一版本轮采用“Service + mock Prisma/BullMQ/Redis”的轻集成方式,验证 NestJS service 编排和数据访问参数
- 后续如本地或 CI 具备 PostgreSQL/Redis/MinIO,可增加
- Prisma test database 集成测试。
- 单元/轻集成测试可以使用 mock Prisma/BullMQ/Redis 验证 Service 编排和异常分支,但这只代表代码级测试通过
- 系统功能集成测试必须补充真实服务闭环
- Prisma/PostgreSQL test database 集成测试。
- BullMQ + Redis 队列消费集成测试。
- MinIO 预签名上传集成测试。
- 前端页面调用真实 API 的浏览器 smoke。
### 2.3 契约测试
@@ -45,7 +46,7 @@
- API build。
- 前端 build。
- 不接真实运营商网关。
- 后续可在 PostgreSQL/Redis 可用时 API HTTP smoke:创建任务 -> 入队 -> 模拟 submit result -> 回执 -> trace 查询。
- PostgreSQL/Redis 可用时必须执行 API HTTP smoke:创建任务 -> 入队 -> 模拟 submit result -> 回执 -> trace 查询;不可用时标记阻塞,不记为通过
### 2.5 性能 Smoke
@@ -82,5 +83,5 @@ Windows 本项目推荐使用根脚本 `npm run test:gateway`,脚本会临时
- 单元测试和轻集成测试可以使用 mock Prisma/BullMQ/Redis 作为测试替身,但这只适用于测试隔离,不代表业务功能可以停留在 mock。
- 真实开发完成标准必须包含:Prisma/PostgreSQL 模型或查询、NestJS Service/Controller、必要的操作日志、前端调用真实 API,以及在真实 PostgreSQL/Redis/MinIO 可用时完成 smoke。
- 发送 Worker 的 Redis 限速和 BullMQ 投递可在 unit/light integration 中使用 mock;真实 Redis 链路仍需由 `spike:bullmq`、API smoke 或端到端验证覆盖。
- 前端暂未新增测试框架;当前保留 `npm run build` 作为 smoke。新增页面能力不能只依赖前端本地状态localStorage,除非需求明确声明为临时演示
- 前端暂未新增测试框架;`npm run build` 作为构建 smoke,不代表页面业务通过。新增页面能力必须调用真实 API;前端本地状态localStorage、静态数组、兜底数据不能作为系统功能验收通过依据
- Gateway 不连接真实运营商 SMSC;使用 gocmpp 适配测试和内部模拟器测试。