主题
模板管理
基础信息
| 项 | 说明 |
|---|---|
| 菜单路径 | /operationsManagement/msgNoticeManagement/templateManager |
| 路由名称 | templateManager |
| 页面组件 | src/views/operationsManagement/msgNoticeManagement/templateManager/index.vue |
| 接口模块 | 组件内 this.$api.post/put/get(...) 直接调用 |
| Store | 无 |
| 页面定位 | 维护各类消息渠道(公众号、短信、邮件、语音)下的消息模板,支持新增、编辑、启停与公众号模板同步 |
页面功能
页面为「模板管理」,由顶部筛选区 + 按「目标类型」切换的 Tab(el-tabs)组成。Tab 项由字典 message_target_type(1-公众号、2-短信、3-邮件、4-语音)动态生成。
1. 筛选区
- 模板类型:下拉(字典
message_template_type),查询时通过templateType透传给各 Tab 内的列表组件。
2. Tab 结构
| targetType | 内容 | 说明 |
|---|---|---|
1 公众号 | OfficialAccounts | 内部再用左侧 Tab 按 message_channel_type(渠道:宠保圈/宠宝圈/家e保)切换,每个渠道渲染一个 TableList(targetType=1) |
2 短信 / 3 邮件 / 4 语音 | TableList | 直接渲染对应 targetType 的模板列表 |
3. 列表(TableList)
- 顶部:模板标题/ID 搜索框(回车查询);右上角按钮:公众号(
targetType=1)显示「同步公众号模板」,其余显示「新建」。 - 列:更新日期、模板类型、模板标题、模板ID、通用模板标题(仅公众号)、模板内容、字符/拆分条数(仅短信)、是否有效。
- 行操作:
- 启用/禁用(按
status切换)。 - 修改(打开新增/编辑弹窗)。
- 启用/禁用(按
4. 新增/编辑弹窗(add)
弹窗包含两块卡片:
- 基本配置(BasicConfig):模板标题、模板类型、用户群体(多选
message_role_type)、模板ID(短信/语音可编辑,其余自动)、放音类型(仅语音:1-文本转语音TTL / 2-语音文件)、通用模板标题(公众号,只读回显)、备注说明、推送平台(仅短信:联麓/阿里云)、是否启用。 - 模板配置(TemplateConfig):按 targetType 区分:
- 公众号:字段列表(fieldName/fieldValue/exampleValue,只读)。
- 邮件:主题 + 富文本(tinymce)。
- 短信:文本域(300字)。
- 语音:TTL 文本(含
${变量}自动解析参数默认值,校验变量不可重复)或语音文件上传(MP3/MAV,≤2M,走 OSS)。
提交逻辑:roleTypes 以逗号拼接;语音参数 voiceParameterJson 序列化为 JSON;模板ID已存在时后端返回 false 并提示。
使用组件
| 组件 | 路径 | 用途 |
|---|---|---|
Container | @/components/container | 页面容器 |
SearchContainer | @/components/SearchTableContainer | 筛选区容器 |
TableContainer | @/components/SearchTableContainer | 表格区容器 |
OfficialAccounts | ./components/OfficialAccounts | 公众号渠道子 Tab |
TableList | ./components/TableList | 模板列表(含搜索、分页、行操作) |
add(AddOrUpdate) | ./add | 新增/编辑弹窗 |
BasicConfig | ./add/BasicConfig | 弹窗基本配置卡片 |
TemplateConfig | ./add/TemplateConfig | 弹窗模板配置卡片 |
tinymce-editor | @/components/tinymceEditor/tinymceEditor | 邮件富文本编辑 |
使用 Store
无。
调用接口
所有接口实际请求统一带
/api前缀(下表为业务路径简写)。
| 接口 URL | 方法 | 用途 |
|---|---|---|
messageTemplate/queryPage | POST | 模板分页列表 |
messageTemplate/getTemplate | POST | 同步公众号模板 |
messageTemplate/update | PUT | 启用/禁用、编辑保存 |
messageTemplate/add | POST | 新增模板 |
messageTemplate/id | GET | 编辑回显(?id=) |
file/oss/policy | POST | 获取 OSS 上传凭证(语音文件) |
ddic/getList | POST | 字典(目标类型 message_target_type、模板类型 message_template_type、用户群体 message_role_type、公众号渠道 message_channel_type) |
OSS 直传通过
@/api/ossApi提交至阿里云(非/api业务接口)。
修改记录
| 修改人 | 修改时间 | 修改内容 |
|---|---|---|
| zhouw | 2026-07-03 | 初始化页面 |
| zhouw | 2026-07-09 | 编写页面内容 |