kitchen/CHANGELOG.md

# Changelog

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

## [0.8.0] - 2026-04-08

### Added
- 📱 **fluttertoast 本地化** - 下载 fluttertoast v9.0.0 到本地 packages 目录
  - 支持鸿蒙平台适配
  - 创建 `fluttertoast_ohos` 适配模块
  - 本地路径导入，支持自定义修改

- 🎨 **ToastService 消息服务** - 统一 Toast 消息样式
  - 支持 4 种消息类型（success、error、warning、info）
  - 自动适配 App 动态主题
  - 集成 PageStandards 页面规范
  - 提供简洁的 API 接口

### Changed
- 📦 更新 `pubspec.yaml` 使用本地 `fluttertoast`
- 🔧 更新 `fluttertoast` 支持鸿蒙平台

## [0.7.0] - 2026-04-08

### Added
- 🔄 **GetX 全局状态管理系统**
  - `BaseController` 基础控制器（加载状态、错误处理）
  - `PagedController` 分页控制器（列表分页、加载更多）
  - `HomeController` 首页控制器（产品列表、分类筛选、搜索）
  - `CartController` 购物车控制器（商品管理、数量调整、总价计算）
  - `ProfileController` 个人中心控制器（用户登录、登出、信息更新）

- 🧩 **标准组件库** - 所有组件集成 PageStandards
  - `StandardButton` 标准按钮（4 种样式：primary、secondary、outline、text）
  - `StandardTextField` 标准输入框（支持图标、错误提示）
  - `StandardCard` 标准卡片（支持阴影、边框）
  - `StandardListTile` 标准列表项（支持图标、副标题、箭头）

- 📊 **状态组件**
  - `EmptyState` 空状态组件（支持图标、emoji、按钮）
  - `ErrorState` 错误状态组件（支持重试按钮）

- 🎯 **交互组件**
  - `StandardDialog` 标准对话框（支持确认、取消、破坏性操作）
  - `StandardBottomSheet` 标准底部弹窗（支持自定义高度）
  - `StandardPicker` 标准选择器（支持泛型）

- 🛡️ **路由守卫系统** - `RouteGuard`
  - 支持 3 种认证级别（none、optional、required）
  - 自动重定向到登录页
  - 集成 ProfileController 用户状态

### Changed
- 🔄 重构 `HomePage` 使用 GetX 状态管理
- 🔄 重构 `ProductCard` 使用 PageStandards
- 🔄 重构 `LoadingIndicator` 使用 PageStandards

### Technical
- 统一状态管理为 GetX
- 所有组件集成 PageStandards
- 实现路由守卫认证机制
- 新建页面默认支持 GetX

## [0.6.0] - 2026-04-08

### Added
- 📝 **日志服务系统** - 新增 `LoggerService` 完整日志管理
  - 支持日志开关、级别、文件写入配置
  - 支持 5 种日志级别（Debug、Info、Warning、Error、Off）
  - 支持控制台输出和文件输出
  - 支持日志文件自动清理（按大小和数量）
  - 配置持久化存储

- 📱 **屏幕适配配置** - 新增 `ScreenUtilConfig` 全局配置
  - 设计稿尺寸配置（默认 375x812）
  - 最小字体适配开关
  - 分屏模式开关
  - 缩放开关控制
  - 配置持久化存储

- 🔧 **全局工具类**
  - `AppLogger` - 简化的全局日志工具类
  - `ScreenUtilExtension` - 扩展方法支持全局缩放控制

- 📐 **页面规范系统** - 新增 `PageStandards` 页面规范文件
  - 统一主题色、字体色、背景色配置
  - 统一字体大小、间距规范
  - 统一动画配置（开关、速度、预设、曲线）
  - 统一响应式布局配置
  - 支持多语言、屏幕方向、消息样式
  - 支持状态栏沉浸、深色模式、设备类型适配
  - 提供 `PageStandardsMixin` 混入和 `StandardPage` 基类
  - 提供 `PageStandardsExtension` 扩展方法

- 🔍 **页面验证系统** - 新增 `PageValidator` 页面检测文件
  - 注册所有页面条目信息（路由、名称、描述、规范要求）
  - 开发时实时检测页面是否遵循规范
  - 支持 12 种规范检查项
  - 控制台输出警告信息
  - 提供验证报告和调试面板

- 📦 **新增依赖库**
  - `path_provider` - 文件路径获取

### Changed
- 🔧 更新 `AppService` 集成 `LoggerService` 和 `ScreenUtilConfig`

## [0.5.0] - 2026-04-08

### Added
- 📱 **屏幕适配库** - 新增 `flutter_screenutil` 本地化支持
  - 下载 `flutter_screenutil v5.9.3` 源码到 `packages/flutter_screenutil`
  - 添加鸿蒙平台设备类型识别 `DeviceType.harmonyOS`
  - 使用条件导入处理 Web 平台兼容性
  - 本地路径导入，支持自定义修改

- 📊 **新增依赖库**
  - `pretty_dio_logger` - Dio 网络请求日志美化
  - `logger` - 统一日志管理
  - `device_info_plus` - 设备信息获取

### Changed
- 📦 更新 `pubspec.yaml` 使用本地 `flutter_screenutil`
- 📝 更新 `README.md` 添加新依赖库说明

## [0.4.0] - 2026-04-08

### Added
- ✨ **动画服务系统** - 新增 `AnimationService` 完整动画管理
  - 使用 `animations` 库实现专业动画效果
  - 支持动画开关、速度、强度、曲线四种参数调节
  - 提供 7 种预设模式（Standard、Fast、Slow、Smooth、Bouncy、Minimal、None）
  - 支持 9 种动画曲线类型（Linear、EaseIn、EaseOut、EaseInOut、Ease、Bounce、Elastic、FastOutSlowIn、SlowMiddle）
  - 配置持久化存储，应用重启后保持设置

- 🎬 **页面转场动画组件** - `PageTransitions`
  - `fadeThrough` 淡入淡出转场
  - `fadeScale` 缩放淡入转场
  - `sharedAxis` 共享轴转场（水平/垂直/缩放）
  - `getTransitionBuilder` 自适应页面转场构建器

- 📋 **列表项动画组件**
  - `AnimatedListItem` 单个列表项动画
  - `AnimatedListView` 列表视图动画
  - `AnimatedGridView` 网格视图动画
  - 支持交错动画效果

- 👆 **交互动画组件**
  - `AnimatedButton` 按钮点击缩放动画
  - `AnimatedCard` 卡片点击交互动画
  - `OpenContainerWrapper` 容器展开转场

- 🎯 **基础动画组件**
  - `FadeInWidget` 淡入动画
  - `SlideInWidget` 滑入动画
  - `ScaleInWidget` 缩放动画
  - `StaggeredAnimation` 交错动画

### Changed
- 📱 更新 `ThemeDemoPage` 添加完整动画设置 UI
  - 动画开关控制
  - 预设模式选择器
  - 速度和强度滑块
  - 曲线类型选择器
  - 实时预览区域

- 🔧 更新 `AppService` 集成 `AnimationService`

## [0.3.0] - 2026-04-07

### Added
- 🌐 **繁体中文支持** - 新增 `zh_Hant` 繁体中文本地化支持
  - 新增 `app_zh_Hant.arb` 繁体中文翻译文件
  - 新增 `app_localizations_zh_hant.dart` 繁体中文实现
  - 更新 `app_localizations.dart` 支持繁体中文区域设置

### Changed
- 📱 **自适应布局系统重构** - 使用 `flutter_adaptive_scaffold` 实现响应式布局
  - 新增 `AdaptivePageInterface` 抽象接口定义自适应页面规范
  - 新增 `AdaptivePageMixin` 提供单页面自适应布局实现
  - 新增 `AdaptiveTabPageInterface` 和 `AdaptiveTabPageMixin` 提供标签页自适应布局
  - 新增 `AdaptivePageController` 静态方法快速构建自适应页面
  - 新增 `AdaptiveLayoutBuilder` 响应式布局构建器
  - 新增 `ResponsiveGrid` 响应式网格组件
  - 新增 `ResponsivePadding` 响应式内边距组件
  - 新增 `AdaptiveDestination` 自适应导航目标配置

### Fixed
- 🔧 修复 `flutter_adaptive_scaffold` API 调用错误
  - 修复 `SlotLayoutConfig.from` 方法调用
  - 修复 `AdaptiveLayout` 的 `backgroundColor` 参数问题
  - 修复 `secondaryBody` 返回类型问题

## [0.2.0] - 2026-04-06

### Added
- 🔐 **权限管理服务** - 新增 `PermissionService` 跨平台权限管理
  - 支持 15 种常见权限类型（相机、麦克风、相册、位置等）
  - 跨平台权限适配（iOS、Android、HarmonyOS、Web、Windows、macOS、Linux）
  - 权限状态记录和查询功能
  - 批量权限检查和请求功能

### Changed
- 📦 更新 `pubspec.yaml` 依赖配置
  - 添加 `flutter_adaptive_scaffold` 响应式布局支持
  - 更新 `permission_handler` 鸿蒙适配版本

## [0.1.0] - 2026-04-05

### Added
- 🎨 **主题服务** - `ThemeService` 提供统一的主题管理
- 🍎 **iOS 风格组件** - 优先使用 Cupertino 组件
- 🌍 **国际化支持** - 支持英文和简体中文
- 📱 **基础页面结构** - HomePage、ThemeDemoPage 等

---

## 开发进度

### 已完成功能
- ✅ 主题服务（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 状态管理**