# Flare Social — 业务域文档

**Social** 是独立于 **开源 IM Core** 的业务工作区：好友、黑名单、通讯录、群组、PreSend 门禁与 IM 投影。

## 与 Core 的关系

```text
flare-im-core（开源通信核心）
        ↑ gRPC Hook / 投影 / REST Gateway
flare-social（好友 · 群 · 资料 · social-hook）
```

- **无编译依赖**：`flare-social` 不依赖 `flare-im-core` crate。
- **集成面**：HookPlugin（`pre_send`）、ExtensionPlugin、IM bridge 投影。

## 文档索引

| 文档 | 内容 |
|------|------|
| [01-boundaries](./01-boundaries.md) | Social 与 Core 边界、服务清单 |
| [04-social-integration](./04-social-integration.md) | 服务、bridge、好友校验 |
| [05-deployment-modes](./05-deployment-modes.md) | 微服务 / 一体化 / 仅 Core |
| [06-quickstart](./06-quickstart.md) | 15 分钟 Social + IM 联调 |
| [08-grpc-social-business-flow](./08-grpc-social-business-flow.md) | gRPC 发信与 Hook 链路 |
| [09-social-access-points](./09-social-access-points.md) | 消息/会话接入点与参与者同步 |

## 配置样例

- [`hooks.social.example.toml`](./hooks.social.example.toml) — PreSend 编排器配置
- 仓库内 `flare-social/config/social.example.toml`

## 开源 Core 文档

若你只需集成通讯能力（不含 Social），请从 [**开源通信核心**](/docs/core/readme) 开始。

Hook / Extension 通用契约见 [**业务扩展**](/docs/integration/readme)。