feat: complete cmpp platform phases 0-5

2026-07-01 13:22:04 +08:00
parent 824a8b334f
commit ee926fea04
86 changed files with 10490 additions and 14 deletions
@@ -0,0 +1,83 @@
+# 阶段 4 通道与报备进度记录
+
+## 2026-07-01
+
+### 阶段计划
+
+- 已创建 `docs/phase-4-channel-reporting-plan.md`。
+- 阶段 4 聚焦短信通道和签名报备，不开发彩信通道。
+
+### 验证记录
+
+- 创建阶段 4 计划文档、扩展 Prisma 通道与报备模型后执行：
+  - `cd api && npm run prisma:generate`：通过。
+  - `cd api && npm run build`：通过。
+- 实现 `ChannelsModule`、通道/通道组/路由/报备最小接口后执行：
+  - `cd api && npm run prisma:generate`：通过。
+  - `cd api && npm run build`：通过。
+  - API health 冒烟：`GET http://127.0.0.1:3101/api/health` 返回 `{"status":"ok","service":"cmpp-platform-api",...}`。
+- 阶段 4 完整验证：
+  - `npm run verify:phase4`：通过。
+  - BullMQ 本轮端到端 TPS：527.63，满足 500 条/秒验证线。
+  - Prisma Client 生成成功。
+  - API 构建成功。
+  - 前端构建成功，仍有 Vite chunk 大小告警，不阻塞。
+
+### 已完成
+
+- Prisma 通道与报备模型：
+  - `SmsChannel`
+  - `SmsChannelGroup`
+  - `SmsChannelGroupItem`
+  - `ChannelRouteRule`
+  - `ChannelHealthMetric`
+  - `ChannelReportField`
+  - `SignatureReportMaterial`
+  - `ChannelSignatureReportTask`
+  - `ChannelSignatureReportRecord`
+  - `ReportExportFile`
+  - `ReportReceiptImport`
+- NestJS 模块：
+  - `ChannelsModule`
+  - `ChannelsService`
+  - `ChannelsController`
+- 运营端接口：
+  - `GET/POST /api/admin/channels`
+  - `POST /api/admin/channels/:id/test`
+  - `GET /api/admin/channels/:id/metrics`
+  - `GET/POST /api/admin/channel-groups`
+  - `POST /api/admin/channel-groups/items`
+  - `GET/POST /api/admin/channel-route-rules`
+  - `GET/POST /api/admin/channel-report-fields`
+  - `GET/POST /api/admin/signature-report-materials`
+  - `GET /api/admin/report-tasks`
+  - `POST /api/admin/report-tasks/generate`
+  - `POST /api/admin/report-tasks/:id/export`
+  - `POST /api/admin/report-tasks/:id/receipt-import`
+  - `GET /api/admin/report-records`
+- 报备状态规则：
+  - 生成报备任务时创建 `pending` 任务和报备记录。
+  - 导出报备资料时创建导出文件记录，并将任务状态更新为 `exporting`。
+  - 导入回执时创建导入批次，按结果更新任务状态，并同步签名 `reportStatus`。
+
+### 下一步
+
+1. 输出阶段 5 实施计划和验收标准。
+2. 实现账户计费完整扣费/冻结/退费闭环、套餐购买/充值记录和发送前费用预估。
+
+### 阶段 4 验收状态
+
+| 验收项 | 状态 | 说明 |
+| --- | --- | --- |
+| Prisma Client 生成成功 | 已完成 | `npm run prisma:generate` 通过。 |
+| API 构建成功 | 已完成 | `npm run build` 在 `api` 下通过。 |
+| `ChannelsModule` 被 AppModule 引入 | 已完成 | 已引入根模块。 |
+| 通道、通道组、路由规则基础接口存在 | 已完成 | 通道 CRUD、测试占位、指标查询、通道组、成员和路由规则接口已实现。 |
+| 报备字段和签名报备资料接口存在 | 已完成 | 报备字段配置、签名通道报备资料登记接口已实现。 |
+| 报备任务、导出、导入和记录接口存在 | 已完成 | 任务生成、导出文件、回执导入、报备记录查询接口已实现。 |
+| 报备状态同步 | 已完成 | 回执导入后更新任务状态并同步签名 `reportStatus`。 |
+| 阶段完整验证 | 已完成 | `npm run verify:phase4` 通过。 |
+
+### 阶段 4 结论
+
+阶段 4 已完成。第一版可以进入阶段 5 账户计费。