82 lines
3.1 KiB
Markdown
82 lines
3.1 KiB
Markdown
# 阶段 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 通道与报备。
|