消息与 IM 模块

适用对象

维护站内消息、消息模板/通道，以及即时通讯的开发人员。

能力边界

产品说明见 消息中心、即时通讯。设计细节见 monorepo oars-java/MESSAGE-MODULE-DESIGN.md。本页保留入口与锚点。

入口路径

前端：

• /message — 个人消息
• /messageTemplate、/messageChannel — 管理端
• /im — 即时通讯

后端：

• /app/message — 个人消息收发与已读
• /app/message/template、/app/message/channel — 模板与通道
• IM 相关接口见 ImController（路径以代码为准）

核心数据和接口

常见表：

• sys_message（及已读等扩展表，以迁移为准）
• sys_message_template、sys_message_channel
• im_conversation、im_chat_message

个人消息主要接口（前缀 /app/message）：

• POST /send/inner、/send/inner/batch
• POST /send/template、/send/template/batch
• GET /page、GET /unread/count
• PUT /{messageId}/read、PUT /batch/read、PUT /read/all
• DELETE /{messageId}

实现位置

• MessageController、MessageTemplateController、MessageChannelController
• ImController、ImService、ImWebSocketHandler
• 前端：views/sys/message/、views/sys/im/、api/app/message.ts、api/app/im.ts

权限与注意

• 个人查看/已读/删除属基础账号能力；模板与通道需管理权限
• 当前版本外部邮件/短信通道可能为预留，以产品文档「当前可用通道」为准
• IM 依赖 WebSocket；网关需支持升级与长连接