主题
短信渠道
SYS-SMS-01 | 模块
system| 接入阿里云、腾讯云、华为云等短信服务商,并按渠道管理密钥与签名。
1. 使用角色与场景
角色:管理员
- 新增一个短信渠道并设为默认
- 短信发送失败时切换备用渠道
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/sms-channel/create | system:sms-channel:create | 创建短信渠道 | SmsChannelController#L33 |
| PUT | /system/sms-channel/update | system:sms-channel:update | 更新短信渠道 | SmsChannelController#L40 |
| DELETE | /system/sms-channel/delete | system:sms-channel:delete | 删除短信渠道 | SmsChannelController#L48 |
| DELETE | /system/sms-channel/delete-list | system:sms-channel:delete | 批量删除短信渠道 | SmsChannelController#L57 |
| GET | /system/sms-channel/get | system:sms-channel:query | 获得短信渠道 | SmsChannelController#L66 |
| GET | /system/sms-channel/page | system:sms-channel:query | 获得短信渠道分页 | SmsChannelController#L75 |
| GET | /system/sms-channel/list-all-simple | — | 获得短信渠道精简列表 | SmsChannelController#L83 |
| GET | /system/sms-channel/simple-list | — | 获得短信渠道精简列表 | SmsChannelController#L83 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/sms/SmsChannelController.java#L33 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/sms/SmsChannelDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_sms_channel | SmsChannelDO |
5. 机制与配置
- SmsClient 抽象 + 各厂商实现 + 工厂按渠道编码取客户端
- 渠道可配置签名与模版映射
6. 常见问题与排查
- 密钥权限不足时返回码容易被误判为业务失败
7. 关联
- 需求原件:01-07-消息通知
- 相关卡片:SYS-SMS-02