消息中心

消息中心由两部分组成：

• 管理端：运营或管理员创建消息、选择接收范围与发送方式，发布后异步投递；
• 用户端：每个登录用户在「我的消息」中查看、标记已读、删除，并维护自己的消息偏好。

站内通知通过 SSE 实时推送，未读数独立计数；邮件已接入平台 SMTP 配置，短信与微信通道目前是占位实现。

菜单与权限复制标题链接

/system/messageCenter/** 下的接口全部基于当前登录用户，不需要权限标识；服务端不会信任前端传入的 userId。

数据模型复制标题链接

sys_message（消息主体）复制标题链接

sys_message_log（每人一条投递记录）复制标题链接

「全部用户」消息会为每个用户生成日志，数据量随用户数线性增长，发布前请确认范围。

发布流程复制标题链接

管理端 publish
  → send_status = sending，投递到 RabbitMQ
  → MessageSendConsumer 展开接收范围
      all：分页查询全部用户，每 1000 人一批
      specified：按 message_user_ids 拆分
  → MessageLogCreateConsumer 为每个用户建日志并逐通道发送
  → 全部完成后回写 send_status = success / failed

几个关键行为：

• 只有 sending 不能重复发布，success / failed / pending 都可以重新发布；重发会重新生成投递日志。
• 发布不是同步发送。接口返回成功只代表已进入队列，最终结果看消息状态与发送日志。
• 消费失败会 nack 重投，最多 3 次；超过后把消息标记为 failed 并记录原因。
• 正在发送中的消息不允许删除，删除消息会级联删除对应的全部发送日志。
• 草稿保存与编辑只允许 pending 状态，编辑时服务端会忽略前端传入的 send_status。

发送方式现状复制标题链接

未填写 send_method 时只落库、不推送。多选时任一通道成功，该用户日志即记为 success，失败通道的原因会写入 error_msg。

邮件依赖邮件配置：mail.enabled 关闭或 SMTP 参数缺失时，邮件通道会失败，但不影响站内消息。

管理端接口复制标题链接

管理端列表首屏（第 1 页且每页不超过 20 条）有 2 分钟 Redis 缓存，新增、修改、发布、删除都会主动清理。

开放接口复制标题链接

公开公告不需要登录，供 C 端首页或门户读取：

/latest 是首页滚动通知的热路径，因此单独做了缓存；/open/** 在安全白名单内，租户由开放接口的租户过滤器设置。

插件内发消息不要直接操作数据表，使用 SDK 的 PlatformMessageApi#send：它把「落库 + 发布」合成一步，失败时返回 null 而不抛异常，避免通知失败回滚业务事务。详见能力开放。

前端接入复制标题链接

站内消息通过 SSE 推送，事件数据形如：

{
  "messageId": 1001,
  "messageType": "notice",
  "messageTitle": "系统维护通知",
  "messageContent": "今晚 23:00 起进行维护",
  "priority": "high",
  "sendTime": "2026-10-21 10:00:00",
  "unreadCount": 5
}

前端收到后可直接更新铃铛未读数并弹出提示；也可以只调用 GET /system/messageCenter/unreadCount 轮询兜底。用户收件箱的接口与偏好设置见我的消息。

界面截图复制标题链接

消息中心（截图占位）

/images/docs/message-center.png

建议 1920 × 1080，截消息列表与消息设置页签。