# 业务功能 → StrayFog 框架能力映射

> 本文档是 PlayBalloons 业务参考的“接口文档”。>
> 它不描述业务实现细节，而是说明每个业务功能用到了 StrayFog 框架的哪些能力，以及应该参考哪些框架文档。

---

## 来源说明

以下业务功能来自 PlayBalloons 实际项目，仅作参考，不是 StrayFog 框架本身。

原始业务文档位于 [features/](features/) 目录。

---

## 业务功能映射表

| 业务功能 | 涉及 StrayFog 框架能力 | 参考文档 | 状态 |
|---|---|---|---|
| 登录 | 单例管理器、网络协议、UI 窗口、事件链 | 网络框架、UI 框架、Hotfix 启动 | 可提炼示例 |
| 背包 | 单例、RB_Tree 存储、事件驱动、增量同步 | 事件框架、网络框架、数据/配置框架 | 可提炼示例 |
| 商店 | 网络协议、Map 数据结构、UI 窗口 | 网络框架、UI 框架、数据/配置框架 | 部分接入 |
| PVE 战斗 | 场景、实体、波次管理、伤害管理器 | 实体框架、场景框架、网络框架 | 半接入 |
| 塔养成 | 单例、编队数据、实体属性联动 | 实体框架、数据/配置框架 | 未完整实装 |
| GM 调试 | GM 协议包装、参数配置、模块化窗口生命周期 | 网络框架、UI 框架 | 可提炼示例 |
| 奖励展示 | 通用 Tips、事件监听、资源组件 | UI 框架、事件框架、资源框架 | 可提炼示例 |
| 地图进度 | 地图加载、波次配置、进度奖励 | 场景框架、数据/配置框架 | 半接入 |
| PVP | — | — | 未发现实现 |

---

## 可复用模式索引

从业务文档中提炼出的通用模式，可作为使用 StrayFog 框架实现类似系统的参考：

### 1. 单例管理器 + 初始化模式

```text
HFGameStart.InitManager()
  -> 各业务 Manager.Instance 初始化
  -> Manager 监听 STC 事件
```

对应框架能力：
- [Hotfix 启动](../../modules/frameworks/Hotfix启动.md)
- [对象池](../../modules/frameworks/内存对象管理/README.md)

### 2. 事件驱动数据流

```text
服务器消息 S2C
  -> 反射创建 STC 事件
  -> 业务 Manager 监听并更新数据
  -> 派发 CTC 事件通知 UI
```

对应框架能力：
- [事件系统](../../modules/frameworks/事件系统/README.md)
- [网络系统](../../modules/frameworks/网络系统.md)

### 3. GM 命令统一包装

```text
GM 窗口
  -> 选择 msgId 和参数
  -> 包装成 GMC2S
  -> 发送真实业务 Network_MsgId
```

对应框架能力：
- [网络系统](../../modules/frameworks/网络系统.md)
- [UI 窗口系统](../../modules/frameworks/UI窗口系统/README.md)

### 4. 通用弹窗 / Tips 展示

```text
业务逻辑调用 HFFunCatalogue.Tips.ShowCommonRewardTips(rewardItems)
  -> 打开通用奖励窗口
  -> 窗口内资源组件监听背包事件刷新
```

对应框架能力：
- [UI 窗口系统](../../modules/frameworks/UI窗口系统/README.md)
- [事件系统](../../modules/frameworks/事件系统/README.md)
- [资源管理](../../modules/frameworks/资源管理/README.md)

---

## 使用说明

1. AI 阅读时应先读框架文档，再读业务参考。
2. 业务参考中的具体类名、协议号不可直接套用到其他项目。
3. 如需新增业务参考，放入 `business-reference/<project>/features/`，并在本文件补充映射。

---

## 文档关联

> 当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。

| 文档 | 关联原因 |
|---|---|
| [业务参考总入口.md](业务参考总入口.md) | 业务参考总入口指向本映射文档 |
| [features/*.md](features/) | 每个业务功能文档都应在映射表中有对应行 |
| [modules/模块索引.md](../../modules/模块索引.md) | 模块索引可链接到业务参考区 |