lislgosms/docs/phase-4-channel-reporting-plan.md

阶段 4 通道与报备实施计划

目标

让运营端能配置短信通道、通道组、路由规则和签名报备流程；让系统能记录签名在各通道的报备资料、报备任务、导出文件、回执导入和状态同步。

阶段 4 不实现真实发送链路，真实 CMPP 提交在阶段 7 发送链路接入；本阶段只建立通道和报备配置闭环。

实施步骤

1. Prisma 模型

   • SmsChannel
   • SmsChannelGroup
   • SmsChannelGroupItem
   • ChannelRouteRule
   • ChannelHealthMetric
   • ChannelReportField
   • SignatureReportMaterial
   • ChannelSignatureReportTask
   • ChannelSignatureReportRecord
   • ReportExportFile
   • ReportReceiptImport

2. NestJS 模块

   • ChannelsModule
   • 通道 CRUD、测试短信占位、通道健康指标查询。
   • 通道组 CRUD、通道组成员配置。
   • 路由规则 CRUD。
   • 报备字段配置 CRUD。
   • 签名报备资料登记。
   • 报备任务生成、导出记录、回执导入记录、报备记录查询。

3. 状态同步

   • 生成报备任务时记录 pending。
   • 导出报备资料时记录导出文件和报备记录。
   • 导入回执时记录导入批次、回执结果，并更新任务状态。

4. 验证

   • cd api && npm run prisma:generate
   • cd api && npm run build
   • API health 冒烟
   • npm run verify:phase3

验收标准

• Prisma Client 生成成功。
• API 构建成功。
• ChannelsModule 被 AppModule 引入。
• 通道、通道组、路由规则、报备字段、报备任务基础接口存在。
• 报备导出/导入记录和报备状态同步接口存在。
• 阶段 4 进度文档记录验证结果。