# mom_kitchen - 小妈厨房

一款基于 Flutter 的 iOS26 风格美食应用，支持多平台（Android/iOS/HarmonyOS/Web）

---

## 🎨 个性化设置

### 访问路径
```
个人中心 → 设置 → 个性化设置
```

### 功能列表
| 功能 | 说明 | 范围 |
|------|------|------|
| 🎨 主题颜色 | 5 种预设颜色（蓝/橙/蓝紫/草绿/深红） | 全局 |
| 📝 字体大小 | 12pt - 24pt 可调 | 全局 |
| 🌙 深色模式 | 一键切换 | 全局 |
| ✨ 动画强度 | 0-2 倍速 | 全局 |
| 🌐 语言 | 简体中文/繁体中文/English | 全局 |
| 🔄 恢复默认 | 一键重置所有设置 | - |

### 开发者 API
```dart
// 获取控制器
final controller = Get.find<PersonalizationController>();

// 设置主题颜色
controller.setThemeColor(Color(0xFF2196F3));

// 调整字体大小
controller.setFontSize(18.0);

// 切换深色模式
controller.toggleDarkMode();

// 设置动画强度
controller.setAnimationIntensity(1.5);

// 切换语言
controller.setLanguage('en');

// 恢复默认
controller.resetToDefaults();
```

### 文件结构
```
lib/src/
├── controllers/
│   └── personalization_controller.dart  # 控制器
├── pages/
│   └── personalization_page.dart        # 页面 UI
└── routes/
    └── app_routes.dart                  # 路由注册
```

---

## 🚀 已完成功能

### 阶段三：热量追踪 + 营养分析 ✅
- 膳食记录控制器（周/月聚合）
- 营养可视化图表（fl_chart）
- 目标设置页面

### 阶段四：购物清单 ✅
- 购物清单 CRUD 操作
- 分类筛选（8 种食材分类）
- 进度条显示完成度
- 多入口访问（发现页/我的页/菜谱卡片）

### 阶段六：主页体验优化 🔵
- ✅ 搜索功能（历史记录/热门搜索）
- ✅ 骨架屏加载效果
- ✅ 卡片交互按钮优化

### Bug 修复 🔴
- ✅ B.5 发现页购物清单点击无反应


---

## 📊 项目进度

总任务：38 | 已完成：19 | 完成率：50%

详细进度查看：[UNFINISHED_FEATURES.md](docs/dev/UNFINISHED_FEATURES.md)

---

## 🛠 开发指南

### 代码规范
- 优先使用 Cupertino (iOS) 组件
- 每个文件头部添加标准注释
- 遵循 iOS 26 Liquid Glass 设计风格
- 使用 DesignTokens 统一样式

### 路由注册
所有页面必须在 `app_routes.dart` 中注册：
1. 添加 `GetPage` 到 `pages` 列表
2. 添加 `PageInfo` 到 `registerAllPages()`
3. 设置 `PageStandardsMiddleware` 中间件

### 主题定制
使用 `DesignTokens` 和 `DarkDesignTokens`：
```dart
// 主题色
DesignTokens.primary
DesignTokens.secondary

// 背景色
DesignTokens.background
DesignTokens.card

// 圆角
DesignTokens.borderRadiusLg
DesignTokens.borderRadiusMd
```

---

## 📝 更新日志

详细变更查看：[CHANGELOG.md](CHANGELOG.md)

最新版本：0.33.0 (2026-04-09)
- Bug 修复：路由拦截问题
- 新增：搜索功能
- 优化：骨架屏加载效果

---