Z-MSG API 层: 纯 SPI 接口定义（MessageGateway / MessageBus / EmailSender / SmsSender / MessageEvent / Channels / MessageException），零实现，无 Spring 框架依赖。 任何业务模块 / 第三方框架都可引用本模块扩展自己的 Provider。

Z-MSG Core 层: 默认 Provider 实现（Mock/Smtp Email + Mock Sms）+ ChannelRouter + RateLimiter + MessageTemplateEngine + 7 DO 实体（MsgTemplate / MsgTemplateVersion / MsgTemplateI18n / MsgBatchTask / MsgDeliveryLog / MsgUserPreference / ...

Z-MSG 外部渠道 Provider: 钉钉机器人/企业微信应用与群机器人/飞书/Slack/微信公众号与小程序订阅消息/ 阿里云短信/腾讯云短信/SendGrid/极光推送。全部基于 JDK HTTP，不引厂商 SDK， 签名与请求体都有针对本地 stub server 的可复现测试。

Z-MSG IM 层: 会话（单聊/群聊/聊天室）、成员、按会话单调递增的 seq、离线增量同步、 已读回执、typing/presence、以及"三行代码开一个聊天室"的门面 API。 实时下发只依赖 z-msg-api 的 RealtimePublisher 接缝（宿主带不带 z-msg-ws 都能编译）， 落库复用 z-msg-core 的数据源与 MyBatis-Plus 约定。

Z-MSG 实时接入层: 一条 WebSocket 端点 + 一次性 ticket 握手鉴权 + topic 订阅模型。 实现 z-msg-api 的 RealtimeTransport，被 z-msg-core 的 RealtimePublisher 自动收集， 业务侧除配置 ticket 密钥外零改动；站内信/IM/业务事件共用一条连接。 跨节点广播或 SSE 兜底请另写一个 RealtimeTransport 实现，本模块不冒充这些能力。