Split game module documentation

game/docs/modules/scene_camera.md

@@ -0,0 +1,51 @@
+# Scene and Camera
+
+## 职责
+
+场景模块负责局内生命周期、关卡装配、摄像机和 battle zone 流程。
+
+主要源码：
+
+- `game/src/scene/whitebox_scene.*`
+- `game/src/scene/camera_controller.*`
+
+## `WhiteboxScene`
+
+当前负责：
+
+- 加载 `LevelDefinition`。
+- 创建玩家。
+- 配置摄像机。
+- 驱动 battle zone 状态。
+- 调用 `StageRenderer`。
+- 调用 `DebugOverlay`。
+- 推入 `GameUiOverlay`。
+- 播放关卡 BGM 和 battle zone 进入音效。
+- 保存 debug 开关。
+
+## 摄像机
+
+`CameraController` 当前支持：
+
+- 玩家横向跟随。
+- dead zone。
+- 平滑移动。
+- 世界边界 clamp。
+- battle zone 临时 camera bounds。
+
+进入/离开 battle zone 时，camera bounds 通过短过渡平滑切换，避免硬切瞬移。
+
+## Battle Zone
+
+当前 battle zone 还是场景骨架阶段：
+
+- 玩家进入触发区后激活。
+- 摄像机锁定到 zone camera bounds。
+- `F2` debug 清场后解除锁定。
+- enemy spawn point 只做 debug 显示，暂不刷敌。
+
+## 下一步
+
+- 用敌人清空结果替代 `F2` debug 清场。
+- 给 battle zone 增加入口/出口锁定数据。
+- 把场景切换、重置、加载/卸载流程独立成 SceneFlow 模块。