# Flare IM Core — 服务端文档总览

**flare-im-core** 是 IM 服务端 Rust 工作区：接入、编排、存储、会话、媒资与能力扩展。

> **暂未开放（官网）**：离线推送（`flare-push`）相关文档已暂时下线。

## 文档索引

| 文档 | 内容 |
|------|------|
| [01-architecture.md](./01-architecture.md) | 逻辑架构与数据流 |
| [02-services.md](./02-services.md) | 微服务矩阵 |
| [03-deploy.md](./03-deploy.md) | 本地 Compose 与脚本 |
| [04-grpc-api.md](./04-grpc-api.md) | 协议与 gRPC 边界 |
| [05-client-connection.md](./05-client-connection.md) | 客户端如何连上网关 |
| [06-custom-business-integration.md](./06-custom-business-integration.md) | 自建好友/群业务如何接入 Server Core |
| `flare-im-core/flare-api-gateway/GATEWAY_SPEC.md` | HTTP 网关能力、安全、错误和统一响应规范 |

## 单仓相关项目

| 路径 | 说明 |
|------|------|
| `flare-proto` / `flare-grpc-proto` | 消息契约与 gRPC 生成 |
| `flare-server-core` | 发现、MQ、运行时公共库 |
| `flare-im-core-sdk` | 客户端 SDK |
| `flare-core` | 长连接传输（Apache-2.0） |

## 客户端默认端点（开发）

| 用途 | 默认 |
|------|------|
| WebSocket 接入 | `ws://localhost:60051` |
| HTTP / 部分 REST | `http://localhost:50050` |
| Capability HTTP | `http://localhost:50110` |
| Online gRPC HTTP | `http://localhost:50061` |

可通过环境变量 `FLARE_IM_SERVER_URL` 或 SDK `SdkConfig` 覆盖。

## 业务扩展

如果你要自建好友、群、组织关系等业务系统，先看 [自建好友 / 群业务接入 Server Core](./06-custom-business-integration.md)。

Hook / Extension 通用接入见 [业务接入文档](../integration/README.md)。