Skip to content

模板管理

基础信息

说明
菜单路径/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保)切换,每个渠道渲染一个 TableListtargetType=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/queryPagePOST模板分页列表
messageTemplate/getTemplatePOST同步公众号模板
messageTemplate/updatePUT启用/禁用、编辑保存
messageTemplate/addPOST新增模板
messageTemplate/idGET编辑回显(?id=
file/oss/policyPOST获取 OSS 上传凭证(语音文件)
ddic/getListPOST字典(目标类型 message_target_type、模板类型 message_template_type、用户群体 message_role_type、公众号渠道 message_channel_type

OSS 直传通过 @/api/ossApi 提交至阿里云(非 /api 业务接口)。

修改记录

修改人修改时间修改内容
zhouw2026-07-03初始化页面
zhouw2026-07-09编写页面内容