服务矩阵
| 模块 | 角色 | 要点 |
|---|---|---|
| flare-api-gateway | 统一业务网关 | HTTP 鉴权、路由后端 gRPC |
| flare-signaling/gateway | 信令接入 | WebSocket / QUIC 长连接 |
| flare-signaling/route | 路由中枢 | 设备路由、下行选路 |
| flare-signaling/online | 在线状态 | 登录、心跳、在线查询 |
| flare-orchestrator | 消息编排 | 入队、seq、与存储协作 |
| flare-sync-orchestrator | 同步编排 | 多端会话/消息同步编排 |
| flare-conversation | 会话服务 | 元数据、光标、未读 |
| flare-storage/writer | 写路径 | JetStream 消费写 PostgreSQL |
| flare-storage/reader | 读路径 | 历史、搜索查询 |
| flare-media | 媒资 | 上传、对象存储 |
| flare-capability | Hook + 能力 | PreSend 等 Hook |
<!-- 暂未开放（官网文档）： | flare-push/server | 推送调度 | 任务生成 | | flare-push/worker | 推送执行 | 实际下发与重试 | | flare-push/proxy | 推送代理 | 第三方通道代理 | –>
与 SDK 的对应关系
| SDK 能力 | 服务端 |
|---|---|
| 长连接收发 | signaling/gateway + route |
sync_messages | conversation + sync-orchestrator + reader |
MediaApi | flare-media + 对象存储 |
CapabilityApi | flare-capability |
| 在线/输入态 | signaling/online |
gRPC 定义
服务名与 .proto 以 flare-proto / flare-grpc-proto 及各 crate build.rs 为准，勿硬编码过时服务名。
PushService等推送相关 proto 仍存在于仓库，官网暂不展开。