架构统一红点聚合服务

统一红点聚合服务

面向 App 多业务红点的聚合服务:把签到、通知、动态、校车等业务线的未读事件统一接入,按用户、业务与消息维度聚合,支撑多级菜单角标、多端已读回传与丢失兜底。

产品功能架构图Capability Map

六大能力域:业务接入、红点模型、聚合计算、已读与清理、展示与查询、运营与监控。

业务接入多业务线统一接入红点模型用户 · 业务 · 消息聚合计算增量聚合与多级汇总已读与清理回传、过期与兜底展示与查询多级菜单与角标运营与监控配置、灰度与对账接入注册业务线登记与开通应用 · 业务线事件订阅按类型订阅红点事件订阅关系类型配置红点类型与展示层级类型字典客户端 SDK拉取与已读回传封装SDK 接入接入鉴权应用与用户身份校验签名 · 白名单接入监控事件量与失败率接入看板用户维度按用户隔离红点用户 ID业务维度业务线与业务键业务类型消息维度消息与所属节点消息键多级层级菜单父子层级结构层级树状态模型未读、已读与清除状态位模型变更类型新增与下线版本管理事件聚合同一红点事件合并聚合键计数累加未读数量增减原子计数去重合并重复事件不重复计幂等键多级汇总子节点向父级汇总层级累加规则引擎展示与上限规则规则配置实时计算秒级更新红点流式计算已读回传单条与全部已读版本号幂等校验重复回传不重复扣减幂等记录多端同步多设备状态一致设备维度过期清理超期红点自动清理TTL冷数据归档历史红点转低频归档存储重建兜底丢失后按事件重建事件回放批量查询一次拉取多级红点批量接口首屏聚合首屏一次返回聚合视图多级菜单一级到多级角标菜单树角标渲染数字、圆点与上限展示样式权限过滤按角色隐藏入口数据权限查询降级异常时读快照降级兜底灰度开关按业务线放量灰度策略配额限流接入与查询限流配额策略聚合对账计数与事件对账定时核对丢失告警红点丢失即时提示阈值规则数据大盘未读分布与趋势指标看板接入报表各业务线接入情况接入报表Product: 统一红点聚合服务

核心业务流程图Business Flow

一条红点事件从业务上报到用户已读:事件入总线、校验与聚合、写入缓存、客户端拉取、已读回传与幂等更新,最后按 TTL 过期清理。

发布事件消费校验校验通过写入缓存返回角标回传已读幂等校验过期清理重复回执直接返回业务事件签到 · 通知 · 动态 · 校车业务侧上报事件总线削峰与按用户有序消息队列接入校验鉴权与类型校验规则校验聚合计算去重、累加与多级汇总流式计算写入缓存更新计数与状态位Redis 写入客户端拉取多级菜单红点批量接口已读回传逐级或全部已读版本号幂等更新重复回执不重复扣减幂等键清理归档过期清理与归档TTL · 归档Flow: 一条红点的生命周期

系统总体架构图System Overview

分层视角下的系统组成:终端与渠道、接入与通信、红点应用、平台服务、数据与存储、基础设施六层,以及贯穿各层的安全合规、可观测性与研发交付能力。

终端与渠道层App · 后台 · 业务方接入与通信层网关 · 长连接 · 事件红点应用层模型、聚合与查询平台服务层可复用的领域服务数据与存储层计数 · 位图 · 事件基础设施层计算 · 网络 · 存储横向支撑能力贯穿全部六层iOS App红点展示与已读App: iOSAndroid App红点展示与已读App: Android运营后台类型与灰度配置App: Web业务系统红点事件上报签到 · 通知 · 动态 · 校车API 网关鉴权 · 限流 · 路由Spring Cloud Gateway身份认证用户与应用身份JWT · 签名长连接网关变更实时下发WebSocket推送网关离线消息触达厂商通道事件接收业务事件接入Kafka 订阅开放接口第三方查询与回传OpenAPI红点中心模型与聚合编排领域服务聚合引擎事件合并与累加流式消费已读服务回传与幂等处理版本号菜单视图多级角标拼装视图聚合清理任务过期与归档定时调度对账服务计数与事件核对离线比对模型服务类型与层级定义配置驱动幂等服务回传去重与版本幂等键消息服务事件发布与订阅消费幂等任务调度清理与对账编排分布式调度配置中心灰度与规则下发配置推送权限中心角色与可见范围RBACRedis Hash未读计数字段计数Redis Set未读消息集合去重集合Redis Bitmap层级已读位位偏移Kafka事件总线多分区MySQL类型与配置主从对象存储归档与快照低频访问负载均衡流量分发四层 / 七层容器集群弹性扩容K8s · HPA监控告警指标与告警Prometheus日志中心全链路检索ELK容灾备份跨区备份定期演练安全合规分级 · 脱敏 · 审计等保要求可观测性指标 · 日志 · 链路全链路追踪容量与压测基线压测与容量规划峰值模型研发交付持续集成 · 灰度CI/CD 流水线System: 统一红点聚合服务

核心技术架构图Technical Architecture

五个核心技术领域:事件接入与治理、分层存储与内存、聚合与一致性、多端同步、查询与展示。

事件接入与治理协议、分区与回压分层存储与内存计数、集合与位图聚合与一致性增量聚合与对账多端同步推送与已读回传查询与展示批量查询与多级菜单事件协议统一事件结构JSON · Schema分区与顺序同一用户有序用户 ID 分区消费分组并行消费与位点消费组失败重试退避与死信死信队列接入限流保护下游写入令牌桶键设计用户 · 业务 · 层级Key 规范Hash 计数未读数量按字段存字段计数Set 集合未读消息集合去重集合运算Bitmap 位图层级已读位标记位偏移内存与过期TTL 与碎片整理内存治理增量聚合事件增量更新原子操作多级汇总子级向父级累加层级累加幂等写入重复事件不重算幂等键版本控制已读版本比对版本号对账校验计数与事件比对定时对账长连接推送变更实时下发WebSocket设备维度每设备已读位设备键已读回传客户端主动上报版本回执断线补偿重连拉全量增量补偿客户端缓存本地首屏缓存本地存储批量查询多级一次取回批量接口首屏聚合主入口优先返回聚合视图菜单映射业务到菜单节点映射表缓存预热热点用户预加载预热任务降级快照异常时读快照快照兜底Tech: 五大技术领域

核心交互时序图Interaction Sequence

「App 拉取多级红点并回传已读」完整交互时序:鉴权、批量读取、聚合返回、已读幂等写入与事件同步。

客户端 AppActorAPI 网关鉴权 · 限流红点服务聚合 · 幂等Redis 集群计数与位图事件总线Kafka业务服务事件生产方拉取多级红点(用户 · 设备)鉴权通过,转发查询批量读取计数与状态位返回聚合结果返回多级菜单红点回传已读(业务 · 层级 · 版本)转发回执幂等写入已读位发布已读事件已读同步Sequence: 拉取红点并回传已读

系统部署架构图Deployment

分区分域部署:接入区承接 App 与业务方流量,应用区无状态扩容,数据区托管计数器、事件总线与配置数据。

接入区流量入口应用区K8s 无状态服务数据区存储与中间件HTTPS转发鉴权放行多端同步批量读写消费事件对账读取归档写入App 与业务方多端入口App · Web · OpenAPI负载均衡流量分发四层 / 七层接入网关 ×2鉴权 · 限流Deployment红点服务 ×N查询 · 已读 · 聚合HPA 弹性聚合消费者 ×N事件消费与累加消费者组长连接服务 ×N变更实时下发StatefulSet清理与对账 ×N定时任务CronJobRedis 集群计数 · 集合 · 位图分片 + 主从Kafka红点事件总线多分区MySQL类型与配置数据主从对象存储归档与快照低频存储Deploy: 接入 + 应用 + 数据

统一红点模型与多级聚合Red Dot Model

红点按用户、业务与消息三个维度建模:业务先注册类型,消息挂在菜单层级树上,子节点变化沿父级逐层汇总,展示规则统一在一个地方配置。

类型登记挂载层级层级汇总展示上限状态生成类型字典层级定义汇总结果上限规则业务注册业务线登记红点类型类型编码模型定义用户 · 业务 · 消息三段式主键层级树菜单父子节点层级编码聚合规则子节点向父级汇总层级累加计数上限超过上限只显示 99+阈值配置状态位未读、已读与清除状态机类型注册表业务与类型映射配置表层级配置菜单树与排序配置表聚合快照多级汇总结果快照存储规则配置上限与展示规则规则表Special: 统一红点模型与多级聚合

事件接入与聚合写入Event Ingest

红点事件统一走事件总线:按用户分区保证同一用户的顺序,消费端批量拉取后逐条聚合,写前做幂等校验,失败转死信并可回放补偿。

拉取事件校验通过按用户有序逐条聚合写前校验订阅消费失败重投积压与延迟回放补偿事件接入统一事件结构订阅消费事件校验类型与权限校验规则校验分区路由按用户落到同一分区分区键批量消费合并拉取降压力批量拉取增量聚合按聚合键合并累加原子操作幂等写入重复事件不重复计幂等键事件总线红点事件缓冲多分区死信队列多次失败留档隔离存储消费监控积压与消费延迟消费大盘补偿任务死信回放与补算定时任务Special: 事件接入与聚合写入

已读回传与多端幂等Read Receipt

已读回传以业务、层级和版本号描述:版本号比较决定是否生效,幂等记录挡住重复回传,位图只在有效时更新,多设备各自维护已读位并按最长进度对齐。

提交回执版本有效首次处理状态变更进度对齐回传去重冲突留痕写入位图设备会话已读回传单条、逐级与全部已读版本号版本校验旧版本直接丢弃单调版本幂等键同一回执只处理一次用户 · 业务 · 版本位图更新按层级写已读位位运算多端同步其他设备状态拉齐设备维度回执确认返回最新未读数回执报文幂等记录已处理回执留档短周期存储冲突记录乱序与越级回传差异日志位图存储层级已读位Bitmap设备会话在线设备与进度会话表Special: 已读回传与多端幂等

红点丢失兜底与对账Loss Fallback

以事件日志为事实来源:定时比对快照与计数,发现丢失先按用户回放事件,回放不足时全量重建,结果写入对账报告并告警。

触发核对存在差异回放不足重建结果超阈值告警快照取值按用户回放分批重建报告落盘丢失检测计数与事件差异阈值比对快照比对快照与在线计数核对定时任务事件回放按用户回放增量事件日志全量重建重建用户红点树离线计算对账报告差异与处理结果报告模板告警通知丢失与重建告警阈值规则快照存储用户红点快照对象存储事件日志事件长期留存日志存储重建任务分批重建与校验分布式任务对账看板差异趋势与明细指标看板Special: 红点丢失兜底与对账

分层存储与内存治理Storage Layers

红点按用途分三种结构:Hash 存未读计数,Set 存未读消息集合,Bitmap 存层级已读位;键带业务前缀与过期时间,热点用户预热,冷数据归档以控制内存。

计数键集合键位图键过期回收释放后预热命名规范兜底快照兜底快照清理水位键设计用户 · 业务 · 层级Key 规范Hash 计数未读数量按字段存字段计数Set 集合未读消息去重集合运算Bitmap 位图层级已读位标记位偏移过期清理按 TTL 回收惰性 + 定时缓存预热热点用户预加载预热任务键模板前缀与过期规范规范表计数器快照定时落盘兜底快照存储位图快照已读位周期备份快照存储容量看板内存水位与碎片指标看板Special: 分层存储与内存治理

批量查询与多级菜单展示Menu Query

客户端一次批量查询拿回整棵菜单的红点:服务端按首屏优先聚合,菜单映射把业务红点挂到层级节点,权限过滤后渲染角标,异常时读快照降级。

一次取回按层级拼装节点角标可见性过滤异常降级缓存命中菜单树本地缓存降级阈值批量查询一次取回多级红点批量接口首屏聚合主入口优先返回聚合视图菜单映射业务红点挂到节点映射表角标渲染数字、圆点与上限展示规则权限过滤按角色隐藏入口数据权限降级兜底异常时读快照快照兜底查询缓存首屏结果短缓存热点缓存菜单配置层级、排序与文案配置表客户端缓存本地角标缓存本地存储性能看板耗时与命中率指标看板Special: 批量查询与多级菜单展示