红色研学预约通知中台开发实战:从预约提交、审核通知到研学履约提醒
红色研学预约业务中,预约提交、审核流转、进场提醒、履约回访等通知场景分散在业务代码内,很容易出现通知渠道混杂、消息重复发送、发送失败丢失、变更通知遗漏等问题。如果直接在预约、审批模块内嵌微信订阅消息、短信发送逻辑,后期新增通知渠道、调整模板、管控发送频次时改动成本很高。本文基于Spring Boot搭建独立通知中台,和研学预约主业务解耦,统一承接预约事件、审核事件、履约定时提醒,实现多渠道可靠触达。
系统采用事件驱动架构,通知中台独立部署,对外提供统一的事件推送接口;uni-app研学预约小程序、后台审批模块作为事件生产者,只负责推送业务事件,不关心通知下发细节。后端基于Spring Boot + RabbitMQ构建异步调度能力,MySQL存储消息模板、发送记录、用户接收配置;Redis用于消息幂等标记、限流控制、定时任务缓存;消息队列划分实时消息、定时提醒、死信重试队列。支持小程序订阅消息、公众号模板消息、短信多渠道下发,后台可配置消息模板、接收人、发送开关、频控策略。权限采用RBAC模型,消息内容自动脱敏,学员隐私信息不会在通知内容中透出。
完整业务链路分为业务事件上报、中台消息编排、渠道分发、重试管控、履约定时提醒、消息回执归档六个环节。研学经办人在小程序提交预约,预约主系统向中台推送【预约提交事件】;中台匹配对应模板,按照配置渠道下发通知给经办人,告知已受理等待审核。审批节点变更时,推送【审核通过/驳回事件】,中台自动组装审核意见、预约时段、核销凭证链接,通知经办人;驳回通知附带修改指引。中台内置定时任务,提前固定时长推送履约提醒,包含集合时间、地点、携带材料、安全注意事项;活动结束后推送归档提醒。所有通知下发后,同步记录发送状态、回执信息,失败消息进入重试队列,超过重试次数转入死信队列告警。
消息幂等与异步调度是中台核心,避免同一业务事件重复推送多条通知。业务侧传递唯一业务事件ID,中台用Redis做幂等校验,同时做渠道限流,防止高频调用触发微信、短信接口风控。核心代码片段如下:
public boolean sendNotify(String eventId, String templateCode, String receiver, Map<String, String> params) {
String idempotentKey = "notify:idempotent:" + eventId;
Boolean exist = redisTemplate.hasKey(idempotentKey);
if (Boolean.TRUE.equals(exist)) {
return false;
}
// 封装消息投递到消息队列
NotifyMessage message = new NotifyMessage(eventId, templateCode, receiver, params);
rabbitTemplate.convertAndSend("notify-exchange", "notify-routing", message);
redisTemplate.opsForValue().set(idempotentKey, "1", 24, TimeUnit.HOURS);
return true;
}
定时履约提醒依托延时队列实现,预约单创建时预约未来提醒时间,到期自动触发,支持动态取消:预约取消、审核驳回时,中台主动撤销待发送提醒。
中台支持消息模板可视化配置,后台可以维护预约受理、审核通过、审核驳回、履约提醒、活动归档等各类模板,修改模板内容不需要重新发布业务服务。同时提供消息日志查询面板,运维人员可以查看每条通知的发送渠道、发送时间、成功失败状态,失败消息可手动重发。通知内容做脱敏处理,学员身份证号、手机号等敏感信息不会填充到通知模板中,保障隐私安全。
开发落地阶段,需要重点处理几类问题。第一是消息可靠性,生产者确认、消费者手动ACK、死信重试机制,防止消息丢失。第二是渠道适配隔离,新增推送渠道只需要新增渠道适配器,不改动原有事件处理逻辑。第三是频次管控,支持按用户、按事件类型设置发送间隔,避免消息骚扰。第四是小程序订阅消息依赖用户授权,中台自动判断订阅状态,未订阅用户自动降级为短信或者公众号通知。
测试除常规接口功能测试,重点做多事件并发上报,验证幂等、限流、重试逻辑;测试渠道异常场景下的降级策略;越权测试,普通业务操作人员不能查看其他单位的通知接收记录。上线后增加监控,观测消息入队量、发送成功率、死信堆积数量、渠道接口报错,方便运维及时排查通道故障。
总结
这套红色研学预约通知中台,核心是把通知能力从研学预约业务中剥离,以事件驱动方式统一管理预约受理、审核流转、履约提醒全场景通知,解决通知逻辑耦合、渠道难以扩展、消息丢失重复、状态难以追溯的痛点。依托Spring Boot、消息队列、Redis幂等控制、多渠道适配器,兼顾通知下发可靠性、可扩展性,同时做好消息内容脱敏保护用户隐私。该方案可以复用到红色展馆、研学基地整套预约审批业务,后续还可以拓展消息标签、用户偏好订阅、通知数据看板等能力。