首页 / Java 平台(cloud-java) / notify 通知
notify 通知
站内信、消息任务、移动推送 Token 与发送状态跟踪。
职责概览
通知模块 独立端口 48100,管理站内信、移动推送与发送任务:消息创建、消息任务状态跟踪、推送 Token 管理与 App 推送接口。
与 system 模块的通知模板/站内信接口互补:notify 侧重发送任务与移动推送,system 侧重模板配置。
接口清单
| 分组 | Controller | 说明 |
|---|---|---|
| 消息 | NotifyMessageController | 通知消息管理 |
| 消息任务 | NotifyMessageTaskController | 发送任务状态跟踪 |
| 推送 Token | NotifyTokensController | 移动推送 Token 注册与失效管理 |
| App 推送 | AppMobilePushController | App 端推送注册/触发 |
关键实现
- 发送任务:消息创建后生成消息任务,异步发送并跟踪状态(待发送/成功/失败/重试)。
- RocketMQ 事件:站内信创建、移动推送发送通过 RocketMQ 事件驱动,失败进重试。
- 推送 Token:按用户维护 APNs/FCM Token,失效 Token 标记并清理。
告警触达依赖 notify 消息任务状态,而不是仅依赖告警记录;排查"告警未送达"时先看消息任务状态与 Token 有效性。
数据与维护注意
核心表:notify_*(3 张):消息、消息任务、推送 Token。
- 推送 Token 属敏感数据,日志脱敏。
- 发送任务必须幂等:同一消息不得重复发送(任务状态 + 唯一约束)。