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,81 @@
+# 阶段 3 短信配置进度记录
+
+## 2026-07-01
+
+### 阶段计划
+
+- 已创建 `docs/phase-3-sms-configuration-plan.md`。
+- 阶段 3 聚焦短信配置域，不开发彩信功能。
+
+### 验证记录
+
+- 创建阶段 3 计划文档、扩展 Prisma 短信配置模型后执行：
+  - `cd api && npm run prisma:generate`：通过。
+  - `cd api && npm run build`：通过。
+- 实现 `SmsConfigModule`、客户端/运营端最小接口后执行：
+  - `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",...}`。
+- 阶段 3 完整验证：
+  - `npm run verify:phase3`：通过。
+  - BullMQ 本轮端到端 TPS：548.52，满足 500 条/秒验证线。
+  - Prisma Client 生成成功。
+  - API 构建成功。
+  - 前端构建成功，仍有 Vite chunk 大小告警，不阻塞。
+
+### 已完成
+
+- Prisma 短信配置模型：
+  - `SmsApplication`
+  - `SmsApplicationIpAllowlist`
+  - `SmsSignature`
+  - `SignatureMaterial`
+  - `SmsTemplate`
+  - `TemplateVariable`
+  - `AuditRecord`
+- NestJS 模块：
+  - `SmsConfigModule`
+  - `SmsConfigService`
+  - `ClientSmsConfigController`
+  - `AdminSmsConfigController`
+- 客户端接口：
+  - `GET/POST /api/client/applications`
+  - `GET/POST /api/client/signatures`
+  - `POST /api/client/signatures/:id/materials`
+  - `POST /api/client/signatures/:id/submit`
+  - `GET/POST /api/client/templates`
+  - `POST /api/client/templates/:id/submit`
+- 运营端接口：
+  - `GET /api/admin/enterprise-applications`
+  - `GET /api/admin/enterprise-signatures`
+  - `GET /api/admin/enterprise-templates`
+  - `GET /api/admin/audit-records`
+  - `POST /api/admin/signatures/:id/approve`
+  - `POST /api/admin/signatures/:id/reject`
+  - `POST /api/admin/templates/:id/approve`
+  - `POST /api/admin/templates/:id/reject`
+- 规则：
+  - 签名/模板提交审核会写入 `AuditRecord`。
+  - 审核通过/驳回会更新审核状态并写入 `AuditRecord`。
+  - 模板变量支持显式传入，也支持从 `${变量名}` 自动识别。
+  - 短信计费条数按 70/67 字规则预估。
+
+### 下一步
+
+1. 输出阶段 4 实施计划和验收标准。
+2. 实现短信通道、通道组、路由规则、报备字段、签名报备资料、报备任务、导出/导入记录和报备状态同步。
+
+### 阶段 3 验收状态
+
+| 验收项 | 状态 | 说明 |
+| --- | --- | --- |
+| Prisma Client 生成成功 | 已完成 | `npm run prisma:generate` 通过。 |
+| API 构建成功 | 已完成 | `npm run build` 在 `api` 下通过。 |
+| `SmsConfigModule` 被 AppModule 引入 | 已完成 | 已引入根模块。 |
+| 客户端短信应用、签名、模板基础接口存在 | 已完成 | 应用/签名/模板查询、创建、提交审核接口已实现。 |
+| 运营端短信应用、签名、模板查询和审核接口存在 | 已完成 | 企业应用/签名/模板查询，签名/模板通过/驳回接口已实现。 |
+| 阶段完整验证 | 已完成 | `npm run verify:phase3` 通过。 |
+
+### 阶段 3 结论
+
+阶段 3 已完成。第一版可以进入阶段 4 通道与报备。