站内信模板
一句话：站内信模板 = 带占位符的消息文案。业务代码按「模板编码 + 参数」发站内信，系统把 {参数} 替换成实际值后投递给用户。本页维护模板清单，并提供「测试发送」真发一条用于验证。
功能在哪
- 菜单路径：系统管理 → 消息中心 → 站内信管理 → 模板管理
- 地址栏路由：
/system/messages/notify/notify-template - 主要权限：
system:notify-template:query/create/update/delete/send-notify（测试发送）
界面认识
| 区域 | 作用 | 常用操作 |
|---|---|---|
| 查询区 | 模板名称 / 模板编号 / 开启状态 / 创建时间 | 「搜索」「重置」 |
| 工具条 | 整页级动作 | 「新增」；勾选后「批量删除」 |
| 列表 | 序号 / 模板编码 / 模板名称 / 类型 / 发送人名称 / 模板内容 / 开启状态 / 备注 / 创建时间 | 行内「修改」「测试」「删除」 |
| 开启状态列 | 开关即时启停模板 | 需要 system:notify-template:update |
模板内容里的 {xxx} 是占位符
如「您的 AI 助手用量已达到本{period}配额的 {ratio}%」。发送时传入同名参数，系统替换后才是用户看到的文案。占位符漏传会导致发送失败，这也是「测试发送」要逐个填参数的原因。
常用操作
新建模板
- 点「新增」；
- 填「模版编码」（唯一标识，业务代码按它发信，如
order_paid）与「模板名称」； - 填「发件人名称」（用户看到的发送者，如「AI 助手」）；
- 写「模板内容」，需要动态内容的地方写
{占位符}； - 选「类型」（通知公告 / 系统消息）与「开启状态」，点「确定」。
编码是契约
模板编码被业务代码引用后就不要改：改了等于新模板，旧代码按旧编码发信会报「模板不存在」。改文案可以，改编码请连同代码一起改。
测试发送（验证占位符的唯一正路）
- 行内点「测试」（需要
system:notify-template:send-notify）； - 「模板内容」只读展示，下面按占位符自动生成参数输入框（「参数 {period}」等，全部必填，漏填报「参数 x 不能为空」）；
- 选「用户类型」：会员时手填「接收人ID」；管理员时从「接收人」下拉选本租户用户；
- 填好参数点「确定」，提示「提交发送成功！发送结果，见发送日志编号：N」。
结果：在消息记录里立刻能查到这一条（含替换前的模版内容与参数 JSON），用户下次进系统也会在站内信入口看到它。
测试发送是真发
它会写一条真实的消息记录并计入发送日志，不是「预览」。演示环境请发给自己或测试账号。
修改 / 删除 / 启停
- 行内「修改」打开同一张表单；
- 「开启状态」开关关闭后，业务代码按该编码发信会失败——用于临时停发某类通知；
- 行内「删除」或勾选后「批量删除」。被业务代码引用的模板删除后发信报错，演示环境请只删自己建的。
字段说明
| 字段 | 必填 | 取值 / 校验 | 说明 |
|---|---|---|---|
| 模版编码 | 是 | 「模板编码不能为空」；唯一 | 业务发信的契约 |
| 模板名称 | 是 | 「模板名称不能为空」 | 管理界面显示名 |
| 发件人名称 | 是 | 「发件人姓名不能为空」 | 用户看到的发送者 |
| 模板内容 | 是 | 「模板内容不能为空」；{占位符} 自动解析 | 替换后为用户所见文案 |
| 类型 | 是 | 「消息类型不能为空」；通知公告 / 系统消息 | 归类用 |
| 开启状态 | 是 | 「开启状态不能为空」 | 关闭 = 停发 |
| 备注 | 否 | 文本 | 记触发时机，如「工作流失败时自动发送」 |
视角对照
| 视角 | 看到什么 |
|---|---|
超管 admin / 租户管理员 docadmin | 本租户全部模板（演示环境为 AI 助手相关的两条系统模板） |
无 send-notify 权限的角色 | 列表可见，行内「测试」按钮不出现 |
进阶
- 消息记录：所有已发送站内信的台账，测试发送的结果在这里查；
- 开发侧：发信走站内信发送接口（模板编码 + 参数 + 接收人），详见开发手册消息模块章节。
常见问题
Q：测试发送报「参数 period 不能为空」？ A：模板内容里有 {period} 占位符，对应输入框没填。占位符参数全部必填——这正是它在帮你提前发现漏传。
Q：发送成功但用户说没收到？ A：三步排查——① 到消息记录按用户编号查这条是否真的生成；② 模板「开启状态」是否开启；③ 用户类型选错（发给「会员」却填了管理员 ID，或反之）。
Q：「接收人」下拉是空的？ A：用户类型选了「管理员」但本租户没有可选用户，或当前账号无用户列表查询权限。改用「会员」类型手填 ID 可绕过下拉。
Q：改了模板内容，历史消息会变吗？ A：不会。消息记录里存的是发送当时的内容与参数快照，改模板只影响之后的发送。