FlowScope/docs/requirements/p1-production-hardening.md

FlowScope Game Core P1 生产化需求

目标

P1 在 P0 核心接口稳定后推进，目标是补齐第一批生产化扩展点，而不是扩张成完整框架生态。

本轮范围

• IResourceBackend 与 Addressables 独立适配。
• IConfigSource / IConfigParser 配置扩展点。
• ISaveMigration 存档迁移扩展点。
• IUIScreenNavigator 与 Panel 预加载。
• MainMenuP0 样例验收升级。
• 使用规范文档。

已完成

• Runtime 资源核心已拆为 ResourceService + IResourceBackend，Addressables 适配移动到 FlowScope.Addressables 独立 asmdef。
• 配置系统支持 source/parser 组合，旧 Mapping<T>(fileName, loadTextAsync) API 保持可用。
• 存档序列化支持版本 envelope 和连续 migration chain，旧 raw JSON 按版本 1 读取。
• UI 增加 UIPreloadService 与 UIScreenNavigator，并保持 UIManager 层内 LIFO 规则。
• MainMenuP0 样例升级为 P1 装配方式，覆盖启动、点击、保存恢复和资源释放测试。
• 新增运行时使用规范与样例验收指南。

未进入本轮

• Luban 完整接入。
• YooAsset / AssetBundle 后端实现。
• 云存档。
• AudioMixer / 3D 音频。
• Package 分发。
• URL 式 UI 路由、跨 Feature 页面恢复和完整页面栈框架。

当前验收状态

代码级编译验证中，FlowScope.Runtime 和 FlowScope.Tests.EditMode 可通过。FlowScope.Tests.PlayMode 在排除 Addressables 适配测试后可通过。

完整 PlayMode 与 Unity Test Runner 验收仍依赖 Unity 完成 com.unity.addressables 包解析；当前机器上主工程被其他 Unity 实例占用，且 Library/PackageCache 尚未出现 Addressables 包，因此本轮不能标记为完整人工验收通过。