Split game module documentation

game/docs/modules/ui_overlay.md

@@ -0,0 +1,38 @@
+# UI Overlay
+
+## 职责
+
+UI 模块负责局内 HUD、状态显示和调试面板。当前只有最小 overlay。
+
+主要源码：
+
+- `game/src/ui/game_ui_overlay.*`
+
+## 当前能力
+
+`GameUiOverlay` 继承引擎 `UIScene`，通过 `SceneManager` 进入 UI scene stack。
+
+有字体时：
+
+- 使用 `TextSprite` 显示游戏状态。
+- 显示 debug 状态、battle zone、音频、存档、PVF、NPK、AudioDB 状态。
+
+缺字体时：
+
+- 使用 `Renderer::drawQuad` 画 fallback 色条。
+- 不因字体缺失阻断 PC/Switch 启动。
+
+## 资源
+
+字体候选：
+
+```text
+assets/fonts/debug.ttf
+assets/fonts/ui.ttf
+```
+
+## 下一步
+
+- 增加血量、连击、联机状态等 gameplay HUD。
+- 增加 debug 面板，替代部分 F 键调试。
+- 确认 Switch 字体资源进入 RomFS 后再启用正式文字 UI。