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 均可通过；仍存在 Unity 生成项目的引用版本冲突 warning。

packages-lock.json 已包含 Addressables 相关包，旧的 PlayMode 编译阻塞已解除。完整 Unity Test Runner 与 MainMenuP0 人工场景验收仍需要单独补跑，不能仅用 dotnet build 替代。