1. 交付目标 交付一个工程质量极高、逻辑分层清晰、易于扩展的 Flutter App 骨架。不追求视觉细节，重点在于数据稳定与架构合理。
2. 技术硬指标
- 框架： Flutter (Stable) + Riverpod + GoRouter。
- 架构： Clean Architecture / Repository Pattern (逻辑与UI分离)。
- 数据： Hive/Isar (本地持久化，杀进程不丢数据)。
- 内购： 集成 RevenueCat (支持消耗型与订阅型)。
3. 核心功能范围
- 首页： 布局框架，图片使用
AppAssets集中管理。 - 五行页： 需剥离出
EnergyService类，目前返回 Mock 数据，预留算法接口。 - 养成页： 点击互动逻辑，经验值升级逻辑 (Controller 层)。
- 支付页： 跑通购买流程，UI 需即时反馈 VIP 状态。
4. 关键防御条款 (防坑)
- 配置集中化： 所有图片路径、颜色值、文案必须提取到独立文件 (
assets.dart,theme.dart)，严禁硬编码。 - Debug 后门： 提供一个隐藏页面，可一键重置数据、一键加金币、一键满级。
- 代码规范： 核心逻辑必须有注释。
5. 验收标准 (Acceptance Criteria)
-
❌ 不包含： 正式上架 App Store/Google Play。
-
✅ 必须包含：
- iOS: 上传至 TestFlight 并可安装运行。
- Android: 提供 Release 签名包 (APK/AAB) 及签名文件。
- 内购在沙盒环境测试通过。
