# Changelog

All notable changes to this project will be documented in this file.

## [0.15.0] - 2026-04-08

### Added
- 🏗️ **全局 Binding 系统** - 解决 Controller 重复与生命周期问题
  - 新增 `AppBinding` 统一管理全局 Service 与 Controller 依赖
  - 使用 `Get.lazyPut` + `fenix: true` 确保单例与自动重建
  - 在 `main.dart` 中通过 `initialBinding` 接入

- 🚫 **强制页面规范校验中间件** - 不合规页面直接拦截
  - 新增 `PageStandardsMiddleware` 在路由进入前校验 `PageRegistry`
  - 未注册页面或校验失败自动跳转至违规页
  - 新增 `StandardsViolationPage` 展示拦截原因与失败项

- 📦 **统一异常模型** - 网络层结构化错误
  - 新增 `ApiException` 与 `ApiExceptionType` 枚举
  - `ApiService` 所有方法统一抛出 `ApiException`
  - 支持超时/无网络/错误响应/取消/未知等类型

- 📏 **ScreenUtilConfig 真正初始化** - 响应式适配生效
  - 实现 `ensureScreenSizeAndInit()` 根据屏幕尺寸动态调整设计稿
  - 自动分档：手机(375×812)/平板(768×1024)/桌面(1440×1024)
  - `PageStandards` 中 `scaled` 系列方法已生效

- 🧾 **修复定时通知** - scheduleNotification 真正延迟
  - 修改 `NotificationService.scheduleNotification()` 使用 `zonedSchedule`
  - 支持按 `delay` 参数延迟触发，不再立即显示

- 🧾 **规范 ProductModel** - 字段语义化
  - 增加 `id` 与 `emoji` 字段，`imageUrl` 改为可选
  - 提供工厂方法 `ProductModel.mock` 用于测试数据
  - 购物车改用 `product.id` 而非 `name` 去重

### Changed
- 🔧 统一页面注册权威来源
  - 移除 `AppPages` 重复定义，仅保留 `AppRoutes.registerAllPages()`
  - 所有页面注册与 `requiredStandards` 统一在 `AppRoutes` 管理
  - 路由中间件与页面注册表保持一致

- 🔧 页面改用 `Get.find()` 替代 `Get.put()`
  - `HomePage`、`CartPage`、`ProfilePage` 不再重复创建 Controller
  - 依赖由 `AppBinding` 统一注入，全局状态一致

- 🔧 路由校验体系正式接入
  - `main.dart` 中 `initialBinding` 与 `routingCallback` 已生效
  - Debug 模式下自动拦截不合规页面

## [0.14.0] - 2026-04-08

### Fixed
- 🔧 **fluttertoast 类型提升错误修复** - 修复编译错误
  - 修复 `packages/fluttertoast/lib/fluttertoast.dart:279` 中的类型提升错误
  - 将公共属性 `context` 赋值给局部变量 `ctx`，解决 Dart 3.2 以下版本的类型提升限制
  - 修复 `packages/fluttertoast/lib/fluttertoast.dart:182-195` 中相同的问题
  - 项目现在可以成功编译

### Technical
- 解决公共字段无法类型提升的问题，使用局部变量作为变通方案
- 构建成功，生成 app-debug.apk

## [0.13.0] - 2026-04-08

### Fixed
- 🔧 **核心错误修复** - 修复多个严重的代码错误
  - 修复 `page_standards.dart` 中 `DeviceType.desktop` 缺失问题，添加 `desktop` 到枚举
  - 修复 `SystemChrome.setSystemUiOverlayStyle` 方法名拼写错误
  - 移除未使用的 `toast_service.dart` 导入
  - 修复 `profile_controller.dart` 中使用 `await` 在非 Future 类型上的问题
  - 修复 `common_utils.dart` 中未使用的 `timer` 变量和 BuildContext 异步使用问题
  - 修复 `adaptive_page_interface.dart` 中未使用的 `primary` 变量
  - 修复 `standard_dialog.dart` 中死代码问题（多余的 ?? 操作符）
  - 移除不必要的 `!` 强制解包操作符

### Technical
- 代码质量提升，所有严重错误已修复，项目可正常编译运行
- 保持 CHANGELOG.md 只保留最近 5 个版本号的规范

## [0.12.0] - 2026-04-08

### Fixed
- 🔧 **繁体中文语言切换修复** - 修复繁体中文选择无效问题
  - 更新 `l10n.yaml` 添加 `zh_Hant` 支持
  - 修复 `app_localizations.dart` 中 `_AppLocalizationsDelegate.isSupported()` 方法，支持 `zh_Hant` 脚本
  - 修复 `ThemeService.setLocale()` 方法，正确处理 `zh_Hant` locale
  - 验证繁体中文翻译文件 `app_zh_Hant.arb` 正确加载

- 🔧 **弹窗和 Toast 样式配置验证** - 确认样式配置正常工作
  - 验证 `DialogStyle` 和 `ToastStyleType` 枚举正确定义
  - 确认 `ThemeService` 中的样式配置持久化正常
  - 确认 `ToastService` 和 `StandardDialog` 正确响应样式变化

- 🔧 **fluttertoast 空值检查修复** - 修复 `fluttertoast.dart` 中的空值异常
  - 在 `packages/fluttertoast/lib/fluttertoast.dart:277-284` 添加 try-catch 保护
  - 添加 context 空值检查，避免 `Null check operator used on a null value` 异常

## [0.11.0] - 2026-04-08

### Added
- 📋 **页面注册系统集成** - 在 main.dart 中添加页面检测和验证
  - 在应用启动时自动注册所有页面到 PageRegistry
  - 调试模式下显示注册状态和配置信息
  - 使用 routingCallback 监听路由变化
  - 路由切换时自动触发页面规范验证

- 🎯 **AppRoutes 页面注册功能** - 在 app_routes.dart 中集成 PageRegistry
  - 添加 registerAllPages() 静态方法
  - 为每个页面定义 PageInfo 配置
  - 配置每个页面的 requiredStandards 检查项
  - 包含 Home、Theme、Example、Cart、Profile、Main 等页面

- 🎨 **PageStandards 增强** - 添加新增的弹窗和 Toast 样式访问
  - 添加 dialogStyle 访问弹窗样式
  - 添加 toastStyleType 访问 Toast 样式类型
  - 在 PageStandardsMixin 中也添加对应访问方法
  - 更新 PageStandards 导入 page_validator.dart

### Changed
- 🔧 修改 `main.dart` 集成页面注册和验证系统
  - 导入 PageRegistry 和 AppLogger
  - 在 debug 模式下注册所有页面
  - 在 GetCupertinoApp 中添加 routingCallback
  - 路由变化时自动调用 PageValidator.validate()

- 🔧 修改 `app_routes.dart` 集成 PageRegistry
  - 导入 page_validator.dart
  - 添加 registerAllPages() 方法
  - 为所有现有页面注册 PageInfo
  - 配置每个页面的标准检查项

- 🔧 修改 `page_standards.dart` 新增样式访问
  - 导入 page_validator.dart
  - 添加 dialogStyle 和 toastStyleType 属性
  - 在 PageStandardsMixin 中同步添加

## [0.10.0] - 2026-04-08

### Added
- 💬 **弹窗样式选择功能** - 支持 4 种弹窗样式
  - GetX Style：使用 Get.dialog 的自定义弹窗样式
  - Native Style：原生 CupertinoAlertDialog 样式
  - Toast Style：类似 Toast 的彩色背景弹窗样式
  - Hybrid Style：混合样式，原生弹窗 + 动态主题色
  - 所有样式都支持动态主题色和字体大小

- 🚀 **Toast 样式选择功能** - 支持 3 种 Toast 样式
  - GetX Snackbar：使用 Get.snackbar 的样式
  - Native Toast：使用 Fluttertoast 的原生样式
  - Custom Style：自定义 FToast 样式
  - 所有样式都支持动态主题色和字体大小

- 🎨 **主题设置页面增强** - 在 `theme_demo_page.dart` 新增样式选择 UI
  - Dialog Style 选择器
  - Toast Style 选择器
  - 实时显示当前选中的样式名称

### Changed
- 🔧 修改 `ThemeService` 添加弹窗和 Toast 样式配置
  - `DialogStyle` 枚举定义弹窗样式
  - `ToastStyleType` 枚举定义 Toast 样式
  - 支持持久化存储用户选择
  - 添加 `setDialogStyle` 和 `setToastStyle` 方法

- 🔧 修改 `ToastService` 支持多种样式
  - 根据 ThemeService 配置自动选择样式
  - `_showGetxToast` 实现 GetX Snackbar 样式
  - 所有样式都使用动态主题色和字体大小

- 🔧 修改 `StandardDialog` 支持多种样式
  - 根据 ThemeService 配置自动选择样式
  - `_showGetxDialog` 实现 GetX 自定义弹窗
  - `_showToastStyleDialog` 实现 Toast 风格弹窗
  - `_showHybridDialog` 实现混合样式弹窗
  - 弹窗背景使用 GetX 默认，字体色使用动态主题色

## [0.9.0] - 2026-04-08

### Added
- 🧪 **主题设置页面测试按钮** - 在 `theme_demo_page.dart` 添加测试组件
  - 4 种 Toast 测试按钮（Info、Success、Warning、Error）
  - Standard Dialog 测试按钮
  - 所有测试组件响应动态主题变化
  - 初始化 ToastService

### Fixed
- 🔧 修复深色模式切换时字体色和背景色未自动更新问题
- 🔧 修复 `theme_service.dart` 中 `Color` 与 `MaterialColor` 类型不匹配问题
- 🔧 修复 `adaptive_scaffold.dart` 和 `adaptive_page_interface.dart` 响应式变量访问错误

---

## 开发进度

### 已完成功能
- ✅ 主题服务（ThemeService）
- ✅ 动画服务（AnimationService）
- ✅ 国际化支持（en, zh, zh_Hant）
- ✅ 权限管理服务
- ✅ 自适应布局系统
- ✅ GetX 全局状态管理
- ✅ 标准组件库
- ✅ 路由守卫系统

### 开发中功能
- 🔄 产品列表页面
- 🔄 购物车功能
- 🔄 用户个人中心

### 待开发功能
- 📋 订单管理
- 📋 支付集成
- 📋 消息通知

---

## 技术栈

- **框架**: Flutter
- **状态管理**: GetX
- **响应式布局**: flutter_adaptive_scaffold
- **动画系统**: animations
- **国际化**: flutter_localizations + intl
- **权限管理**: permission_handler

---

## 贡献指南

1. 遵循 iOS 风格设计规范
2. 使用主题服务统一管理颜色和字体
3. 使用动画服务统一管理动画效果
4. 新增功能需更新 CHANGELOG.md
5. 代码提交前运行 `flutter analyze` 确保无错误
6. **新建页面必须支持 GetX 状态管理**