lislgosms/docs/phase-3-sms-configuration-plan.md

阶段 3 短信配置实施计划

目标

让客户和运营能配置发送短信所需资源：短信应用、应用密钥和 IP 白名单、应用发送限额、不符合模板短信处理策略、短信签名、签名资料、短信模板、模板变量、审核记录和审核工作台基础接口。

实施步骤

1. Prisma 模型

   • SmsApplication
   • SmsApplicationIpAllowlist
   • SmsSignature
   • SignatureMaterial
   • SmsTemplate
   • TemplateVariable
   • AuditRecord

2. NestJS 模块

   • SmsConfigModule
   • 客户端接口：应用、签名、模板创建/查询/提交审核。
   • 运营端接口：企业应用/签名/模板查询，签名/模板审核通过或驳回。

3. 规则约束

   • 应用、签名、模板均按 tenantId 隔离。
   • 新增和编辑签名必须填写完整中文黑括号名称 【签名】；前后端共同拒绝缺少括号、英文方括号、重复括号和空括号，数据库及所有业务展示统一保留恰好一层黑括号。
   • 已审核模板主体第一版不允许直接修改；阶段 3 先不实现编辑接口，后续如需要编辑只允许草稿/驳回状态。
   • 签名和模板提交审核时写入 AuditRecord。

4. 验证

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

验收标准

• Prisma Client 生成成功。
• API 构建成功。
• SmsConfigModule 被 AppModule 引入。
• 客户端短信应用、签名、模板基础接口存在。
• 运营端短信应用、签名、模板查询和审核接口存在。
• 阶段 3 进度文档记录验证结果。