猫度技术知识库

外观

maodo-sms ​

定位与判断 ​

短信发送域：配置解析、通道路由、厂商适配和发送明细。验证码校验属于认证业务。

当前实现 ​

  • 创蓝/阿里云发送适配、平台 activeProvider、平台与 OEM 自配通道路由。
  • 验证码、运维告警、资源池告警；Mock 行为与发送明细。
  • 平台配置和测试发送 API，发送明细查询。
  • 配置分布在 AppSetting、第三方台账及 OEM 配置。

问题与差距 ​

  • @Global 隐藏调用方的显式依赖；模块用 forwardRef 引入系统管理和第三方供应商模块。
  • SMS 引用 auth/sms-mock.util，基础发送域反向依赖调用方。
  • 网关直接读取 OEM 策略与配置表；这里只记录接缝，不规划 OEM 重构。
  • 四个服务均被导出，业务可绕过路由及明细；配置测发目前自行记录明细。
  • SmsSendLog 写入失败只告警，不阻断发送；因此它是尽力记录，不能当作可靠计费凭据。

目标能力（建议） ​

保留短信适配器。业务侧收敛为明确的发送门面；测试发送保留独立受控接口。把 Mock 行为移至 SMS 自身或中立测试配置；通过配置读取接口隔离凭证和租户策略。验证码生成、哈希、冷却和锁定不迁入发送域。

迁移与验收 ​

先整理公开入口和 Mock 依赖，再逐步显式导入、缩小 exports；不能直接删除 Global。OEM 配置迁移暂不实施。验收覆盖两厂商、平台/自配路由、缺配置、Mock/真发、异常与明细；日志落库失败如何监控需补充。

源码依据 ​

  • backend/src/maodo-sms/sms.module.ts
  • backend/src/maodo-sms/service/sms-gateway.service.ts
  • backend/src/maodo-sms/service/sms-send-log.service.ts
  • backend/src/maodo-sms/service/system-sms-config.service.ts
  • backend/src/maodo-sms/README.md