主题
站内信
SYS-NOTIFY-01 | 模块
system| 把业务事件推给具体用户,形成可回看的消息中心。
1. 使用角色与场景
角色:终端用户、开发者
- 任务被指派后给执行人发站内信
- 消息中心按已读/未读筛选
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| GET | /system/notify-message/get | system:notify-message:query | 获得站内信 | NotifyMessageController#L38 |
| GET | /system/notify-message/page | system:notify-message:query | 获得站内信分页 | NotifyMessageController#L47 |
| GET | /system/notify-message/my-page | — | 获得我的站内信分页 | NotifyMessageController#L57 |
| PUT | /system/notify-message/update-read | — | 标记站内信为已读 | NotifyMessageController#L65 |
| PUT | /system/notify-message/update-all-read | — | 标记所有站内信为已读 | NotifyMessageController#L73 |
| GET | /system/notify-message/get-unread-list | — | 获取当前用户的最新站内信列表,默认 10 条 | NotifyMessageController#L80 |
| GET | /system/notify-message/get-unread-count | — | 获得当前用户的未读站内信数量 | NotifyMessageController#L90 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/notify/NotifyMessageController.java#L38 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/notify/NotifyMessageDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_notify_message | NotifyMessageDO |
5. 机制与配置
- NotifySendService 按模版渲染内容并落库
- 未读数在缓存中维护,读后清零
6. 常见问题与排查
- 模版变量缺失会渲染成空串,需在发送前校验
7. 关联
- 需求原件:01-07-消息通知
- 相关卡片:SYS-NOTIFY-02
- 相关卡片:SYS-NOTICE-01