短信管理后台页面设计文档
| 文档版本 | V1.0 |
|---|
| 适用系统 | 企业后台管理系统（RBAC + 多租户） |
| 设计依据 | sys_sms_channel, sys_sms_template, sys_sms_scene, sys_sms_log |
| 字典规范 | 统一采用系统字典表驱动 |
1. 总体设计
1.1 菜单结构
系统管理
└─ 短信中心
├─ 短信渠道管理
├─ 短信模板管理
├─ 短信业务场景
└─ 短信发送记录
1.2 状态字典映射总览
| 功能模块 | 字段 | 字典类型 | 说明 |
|---|
| 通用 | status | sys_normal_disable | 1=正常, 0=停用 |
| 渠道管理 | provider_code | sys_sms_provider_code | 厂商编码 |
| 模板管理 | type | sys_sms_template_type | 模板类型 |
| 发送记录 | status | sys_sms_log_status | 发送状态 |
2. 短信渠道管理 (sys_sms_channel)
2.1 页面功能
- 分页查询渠道列表
- 新增 / 编辑 / 删除渠道
- 启用 / 禁用渠道
2.2 查询区域
| 组件 | 字段 | 字典 |
|---|
| 输入框 | 渠道名称 | - |
| 下拉框 | 厂商编码 | sys_sms_provider_code |
| 下拉框 | 状态 | sys_normal_disable |
2.3 列表字段
| 字段名 | 数据来源 | 展示方式 |
|---|
| 渠道名称 | channel_name | 文本 |
| 厂商编码 | provider_code | 字典标签 (sys_sms_provider_code) |
| 状态 | status | 字典标签 (sys_normal_disable) |
| 租户编号 | tenant_id | 文本 |
| 创建时间 | create_time | 日期 |
| 操作 | - | 编辑 / 删除 |
2.4 表单设计（新增/编辑）
| 控件 | 字段 | 必填 | 说明 |
|---|
| 输入框 | channel_name | 是 | 渠道名称 |
| 下拉框 | provider_code | 是 | 字典 sys_sms_provider_code |
| JSON编辑器 | sms_config | 是 | 账号/密钥等配置 |
| 单选框 | status | 是 | 字典 sys_normal_disable |
| 输入框 | remark | 否 | 备注 |
3. 短信模板管理 (sys_sms_template)
3.1 页面功能
- 模板分页列表
- 关联渠道
- 模板内容预览
- 启用 / 禁用
3.2 查询区域
| 组件 | 字段 | 字典 |
|---|
| 输入框 | 模板名称 | - |
| 输入框 | 模板编码 | - |
| 下拉框 | 模板类型 | sys_sms_template_type |
| 下拉框 | 所属渠道 | sys_sms_channel |
| 下拉框 | 状态 | sys_normal_disable |
3.3 列表字段
| 字段名 | 展示方式 |
|---|
| 模板名称 | 文本 |
| 模板编码 | 文本 |
| 模板类型 | 字典标签 (sys_sms_template_type) |
| 短信签名 | sign_name |
| 所属渠道 | channel_id (join name) |
| 状态 | 字典标签 (sys_normal_disable) |
| 操作 | 编辑/禁用 |
3.4 表单设计（新增/编辑）
| 控件 | 字段 | 说明 |
|---|
| 输入框 | template_name | - |
| 输入框 | template_code | 唯一 |
| 下拉框 | type | 字典 sys_sms_template_type |
| 下拉框 | channel_id | 选择短信渠道 |
| 输入框 | sign_name | 短信签名 |
| 文本域 | content | 支持 #{code} 变量 |
| 输入框 | vendor_template_code | 服务商模板ID |
| 单选框 | status | 字典 sys_normal_disable |
| 输入框 | remark | 否 | 备注 |
4. 短信业务场景 (sys_sms_scene)
核心说明：业务系统只调用 Scene Code，不直接操作模板。
4.1 页面功能
4.2 查询区域
| 组件 | 字段 |
|---|
| 输入框 | 场景编码 |
| 输入框 | 场景名称 |
| 下拉框 | 状态 | sys_normal_disable |
4.3 列表字段
| 字段 | 展示 |
|---|
| 场景编码 | scene_code |
| 场景名称 | scene_name |
| 关联模板 | template_id (join name) |
| 状态 | 字典标签 (sys_normal_disable) |
| 操作 | 编辑 / 禁用 |
4.4 表单设计
| 控件 | 字段 | 说明 |
|---|
| 输入框 | scene_code | 业务方调用的唯一标识 |
| 输入框 | scene_name | 中文描述 |
| 下拉框 | template_id | 选择 sys_sms_template |
| 单选框 | status | 字典 sys_normal_disable |
| 输入框 | remark | 否 | 备注 |
5. 短信发送记录 (sys_sms_log)
5.1 页面功能
- 发送日志查询
- 查看发送详情
- 失败原因分析
- 导出（可选）
5.2 查询条件（高级搜索）
| 组件 | 字段 | 字典 |
|---|
| 输入框 | 手机号 | - |
| 下拉框 | 发送状态 | sys_sms_log_status |
| 下拉框 | 厂商 | sys_sms_provider_code |
| 下拉框 | 模板 | sys_sms_template |
| 日期范围 | 发送时间 | - |
5.3 列表字段
| 字段 | 展示方式 |
|---|
| 手机号 | phone_number |
| 业务场景 | scene_id (join name) |
| 模板 | template_id (join code) |
| 厂商 | provider_code (dict label) |
| 发送状态 | DictTag (sys_sms_log_status) |
| 发送时间 | send_time |
| 操作 | 查看详情 |
5.4 详情弹窗
{
"实际发送内容": "您的验证码是1234",
"服务商业务ID": "vendor_biz_id",
"失败原因": "error_msg",
"请求IP": "ip_address"
}
6. 页面交互流程
graph TD
A[短信渠道] -->|配置| B[短信模板]
B -->|绑定| C[业务场景]
C -->|业务调用| D[发送短信]
D -->|记录| E[发送日志]
