test: record step8 final regression

docs/testing-execution-step-8.md

@@ -0,0 +1,97 @@
+# 测试实施第八步执行记录
+
+## 执行时间
+
+- 日期：2026-07-01
+- 总步骤数：8
+- 当前步骤：第 8 步，最终回归、完整验证和报告归档
+
+## 第八步目标
+
+完成第一版系统化测试的最终回归和归档，重新执行完整验证命令、API 测试命令、Go Gateway 测试命令，并汇总第 1 步到第 7 步的执行结果、通过范围和已知缺口。
+
+## 已执行命令
+
+```bash
+npm run verify:phase8
+npm run test:api
+npm run test:gateway
+```
+
+## 最终命令结果
+
+| 命令 | 结果 | 关键输出 |
+| --- | --- | --- |
+| `npm run verify:phase8` | 通过 | Gateway 契约通过，Go Gateway 测试通过，BullMQ 15000 条端到端 TPS 668.71，Prisma generate 通过，API build 通过，前端 build 通过。 |
+| `npm run test:api` | 通过 | Jest：5 个 test suite 通过，22 个测试通过。 |
+| `npm run test:gateway` | 通过 | `go test ./...`：cmpp、connection、health、spike、tracker 均通过。 |
+
+## 本步执行过的测试用例
+
+| 用例编号 | 用例名称 | 执行范围 | 结果 |
+| --- | --- | --- | --- |
+| TC-REGRESSION-001 | 阶段 8 完整验证 | 执行 `npm run verify:phase8`，覆盖契约、Gateway、BullMQ、Prisma、API build、前端 build。 | 通过 |
+| TC-REGRESSION-002 | API 单元/轻集成测试 | 执行 `npm run test:api`，覆盖风控、计费、发送链路、通道报备、运营统计。 | 通过 |
+| TC-REGRESSION-003 | Go Gateway 测试 | 执行 `npm run test:gateway`，覆盖 Gateway health、tracker、reconnector、gocmpp、本地 spike。 | 通过 |
+| TC-PERF-001 | BullMQ 500 TPS Smoke | `verify:phase8` 内执行 15000 条消息、并发 500 的 BullMQ spike。 | 通过 |
+| TC-FRONTEND-SMOKE-001 | 前端构建 smoke | `verify:phase8` 内执行 `npm run build`。 | 通过，存在既有 chunk size warning |
+
+## 1-8 步执行汇总
+
+| 步骤 | 主题 | 已执行范围 | 结果 |
+| --- | --- | --- | --- |
+| 第 1 步 | 环境与基线数据 | PostgreSQL、Redis、MinIO 连通性；Prisma migrate；基础数据 seed；MinIO bucket/object；契约和 Gateway 基线。 | 通过 |
+| 第 2 步 | 静态配置与权限基础 | 客户、应用、通道、路由、日志、连接状态基础 smoke。 | 通过，部分接口为 subset |
+| 第 3 步 | 认证、审核、报备 | 签名审核、模板审核、报备任务、报备导出、回执导入、审核/报备日志。 | 通过，企业认证模型/API 缺失 |
+| 第 4 步 | 发送前校验 | 多变量模板、变量异常、最大号码数、重复率、非法号码率、黑名单率、计费预估、余额检查。 | 通过，导入发送和非法字符/敏感词前置校验缺失 |
+| 第 5 步 | 发送链路 | 任务创建、号码拆分、真实 BullMQ 入队、Worker 消费、submit result、receipt、uplink、72 小时 unknown 转 timeout、任务查看。 | 通过，定时发送缺失 |
+| 第 6 步 | 计费与对账 | 费用预估、人工充值、余额检查、冻结、扣费、释放、退款、短信计费记录、dashboard/statistics、trace、reconciliation。 | 通过，发送链路未自动计费 |
+| 第 7 步 | CMPP 连接状态与 Gateway | Gateway 契约、Go Gateway 测试、通道创建、路由、metrics、submit session、通道监控、Gateway event trace。 | 通过，客户/通道连接状态一等 API 缺失 |
+| 第 8 步 | 最终回归归档 | `verify:phase8`、`test:api`、`test:gateway`。 | 通过 |
+
+## 当前测试覆盖范围
+
+- 后端单元/轻集成：
+  - 风控规则评估。
+  - 计费服务。
+  - 发送链路服务。
+  - 通道与报备服务。
+  - 运营统计服务。
+- Go Gateway：
+  - health。
+  - reconnect。
+  - SEQID/MSGID/GatewayMessageID tracker。
+  - gocmpp connect/submit/submit resp/active test。
+  - deliver receipt pack/unpack。
+  - 本地 spike simulator。
+- 真实环境 smoke：
+  - PostgreSQL、Redis、MinIO。
+  - API 启动和健康检查。
+  - 客户/应用/签名/模板/通道/路由。
+  - 发送前校验。
+  - BullMQ 发送链路。
+  - Gateway 事件回写。
+  - 计费和对账聚合。
+  - 通道 metrics 和 submit session。
+- 前端：
+  - 当前以 `npm run build` 作为 smoke。
+
+## 已知缺口
+
+| 缺口 | 影响 | 后续建议 |
+| --- | --- | --- |
+| 企业认证模型/API 缺失 | 企业认证提交、审核、驳回重提、认证状态阻断发送无法形成闭环。 | 增加 enterprise certification 模型、接口和发送前状态校验。 |
+| 客户侧导入发送缺失 | 文件导入、号码预览、导入批次确认发送无法执行。 | 增加导入批次、文件解析、预览确认、错误行下载。 |
+| 非法字符/敏感词未接入发送前风控 | 内容非法字符展示、敏感词拦截、修正后重新计费无法闭环。 | 将 sensitive words、非法字符检测接入 risk/precheck。 |
+| 定时短信未实现 | `scheduledAt/sendMode=scheduled` 被忽略，任务直接 queued。 | 增加计划发送时间字段、scheduled 状态、延迟队列、取消接口和到点重校验。 |
+| 发送链路未自动计费 | 发送任务不会自动冻结、扣费、释放、退款或生成短信计费记录。 | 将 BillingService 接入 send-chain 的创建、submit 成功/失败、receipt 阶段。 |
+| 签名/模板/报备状态未在发送链路强制阻断 | 删除、失效或报备失败对发送的影响尚不能完整闭环。 | 在 send-chain/risk precheck 中强制校验签名、模板、报备和应用状态。 |
+| 客户/通道 CMPP 连接状态一等 API 缺失 | 客户端/运营端无法直接查看客户连接状态、通道连接列表和连接数量。 | 增加 connection state 模型、Gateway 心跳回写、运营 dashboard 聚合。 |
+| Gateway 未接真实运营商 SMSC | 真实 CMPP 互通仍需联调环境验证。 | 在运营商测试环境补充联调测试报告。 |
+| 前端自动化测试缺失 | 当前只有 build smoke，缺少页面级断言。 | 后续补充 Playwright/Vitest smoke 覆盖 dashboard、发送、配置核心页面。 |
+
+## 最终结论
+
+第一版系统化测试第 1 步到第 8 步已全部执行并归档。当前版本在 mock 单元/轻集成、真实环境 smoke、Go Gateway 测试、BullMQ 性能 smoke、API build 和前端 build 层面均通过。
+
+第一版核心短信业务主链路已经具备可验证基础：配置、审核报备、风控、计费服务、发送链路、Gateway 事件、运营查询和对账聚合均有测试覆盖。剩余缺口主要集中在产品闭环尚未实现的业务能力，需要进入后续开发迭代补齐。