# PlayBalloons 业务参考

> 本目录存放来自 **PlayBalloons / CrystalBattle** 实际项目的业务功能文档。
>
> 这些内容**不是 StrayFog 框架的一部分**，仅作为“使用 StrayFog 框架如何实现具体业务”的参考示例。
>
> AI 和人工开发者应先学习 StrayFog 框架核心文档，再按需查阅本目录。

---

## 入口文档

- [业务功能 → StrayFog 框架能力映射](业务框架映射接口.md)
- [features/](features/)：原始业务功能文档

---

## 来源说明

这些文档原本位于 `modules/features/`（旧结构），是从 PlayBalloons 项目迁移而来。迁移时已移除与 StrayFog 框架核心无关的占位和未实现模块（如 PVP）。

---

## 使用建议

1. **不要直接套用**其中的具体类名、协议号、配置表字段到其他项目。
2. **重点关注通用模式**：单例管理器、事件驱动数据流、GM 协议包装、通用弹窗接口等。
3. **对照框架文档阅读**：看到业务实现时，回溯到 `modules/frameworks/` 下对应框架模块文档，理解底层机制。

---

## 文档关联

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

| 文档 | 关联原因 |
|---|---|
| [业务框架映射接口.md](业务框架映射接口.md) | 业务参考总入口指向框架能力映射 |
| [modules/模块索引.md](../../modules/模块索引.md) | 模块索引可链接业务参考区 |
| [rules/10-架构说明.md](../../rules/10-架构说明.md) | 架构说明定义业务功能与框架层的依赖方向 |