3.2 KiB
3.2 KiB
阶段 7:发送链路进度记录
当前状态
- 状态:进行中
- 开始时间:2026-07-01
计划步骤
- 创建阶段 7 计划和验收标准。已完成。
- 增加批量任务、手机号短信记录、API 批次、CMPP 提交会话、提交记录、回执记录、上行短信模型。已完成,
npm --prefix api run prisma:generate通过。 - 实现客户端批量任务创建、号码拆分和入队。已完成,
npm --prefix api run build通过。 - 实现 Send Worker、通道路由、Redis 限速和 Gateway SubmitCommand 投递。已完成,
npm --prefix api run build通过。 - 实现 submit resp、回执、上行短信和 72 小时超时补偿。已完成,
npm --prefix api run build通过。 - 实现任务进度统计查询。已完成,
npm --prefix api run build通过。 - 运行 Prisma generate、API build、阶段验证脚本和 API health smoke。已完成。
验收记录
- 数据模型:
SmsBatchTask:客户端批量任务,只记录客户端批次。SmsMessageRecord:手机号维度短信记录。SmsApiRequest:API 调用批次记录。CmppSubmitSession、SmsSubmitRecord:CMPP 会话和提交记录。SmsReceiptRecord:短信回执记录。SmsUplinkMessage:上行短信记录。
- 客户端接口:
POST /api/client/send/batch-tasksGET /api/client/send/batch-tasksGET /api/client/send/batch-tasks/:idGET /api/client/send/batch-tasks/:id/messages
- 管理端接口:
GET /api/admin/send/batch-tasksGET /api/admin/send/messagesGET /api/admin/send/submit-recordsGET /api/admin/send/receipt-recordsGET /api/admin/send/uplink-messagesPOST /api/admin/send/batch-tasks/:id/enqueuePOST /api/admin/send/timeouts/mark-unknown
- Gateway 事件接口:
POST /api/gateway/events/submit-resultPOST /api/gateway/events/receiptPOST /api/gateway/events/uplink
npm run verify:phase7通过。- 队列契约校验通过。
- Go Gateway
go test ./...通过。 - BullMQ Spike:15000 条消息、并发 500、端到端约 910.39 TPS,满足 500 条/秒指标。
- Prisma Client 生成通过。
- API build 通过。
- 前端 build 通过,仍存在 Vite chunk size warning。
- API health smoke 通过:
/api/health返回ok。
阶段 7 验收状态
- 平台创建的批量任务只记录客户端任务:已完成,
SmsBatchTask.sourceType默认为client,API 调用记录进入SmsApiRequest。 - 平台任务、API 调用、CMPP 对接发送全部按手机号维度进入短信记录:已完成,
SmsMessageRecord为每个手机号生成独立messageId。 - 支持 submit resp、deliver 回执、上行短信、超时补偿:已完成,Gateway 事件接口分别写入提交记录、回执记录、上行记录,并支持未知状态超时补偿。
结论
阶段 7 已完成。下一阶段可进入阶段 8:查询、统计、验收。
风险与说明
- 本地未启动 PostgreSQL 时,仅执行 Prisma Client 生成和 TypeScript 构建,不执行数据库迁移。
- Gateway 协议层继续复用阶段 0 的 gocmpp 评估结果和队列契约;阶段 7 在 NestJS 侧完成业务编排与队列投递。