Flare IM

服务端架构总览

设计目标

  • 百万级连接水平扩展接入层
  • 消息顺序：会话维度 seq 由编排/存储权威分配
  • 事件驱动：JetStream 解耦编排与写库
  • 读写分离：writer 消费 MQ，reader 提供查询

逻辑分层

客户端 ──► signaling-gateway (WS/QUIC)
              │
              ▼
         signaling/route ──► orchestrator / conversation / capability
              │                    │
              │                    ▼
              │               JetStream
              │                    │
              ▼                    ▼
         signaling/online    storage/writer ──► PostgreSQL
              │                    │
              ▼                    ▼
           Redis              storage/reader

暂未开放（官网）：离线推送链路（flare-push/server → worker → APNs/FCM 等）文档已暂时下线。

flare-api-gateway 提供统一 HTTP/gRPC 业务入口（管理面、部分 REST）。

核心链路（发消息）

  1. 客户端经接入层提交 Send
  2. flare-orchestrator 校验、分配 seq、发布领域事件
  3. JetStream 消费者 storage/writer 持久化
  4. 其他端经长连接实时下发或 sync_messages 增量拉取

<!-- 暂未开放：4. 推送链路生成离线下发任务 -->

一致性说明

场景策略
消息顺序单会话 seq 单调递增
多端已读读回执 + conversation 服务
离线客户端 last_seq 增量同步
扩展业务Hook 同步拦截 / Extension 异步

下一步