Files

Developer a59f54567f 重构目录树

2026-04-13 07:51:51 +08:00

50 KiB

Raw Blame History

📱 APP 页面结构分析

创建: 2026-04-13 | 用途: 页面结构可视化 + 跳转关系 + 美观/功能问题分析 + 改进建议跳转图例: [→ 页面名] = Get.toNamed跳转, [⇥ Tab切换] = 底部Tab切换, [↑ 返回] = Get.back/Get.until

🏗️ 全局导航图

                        ┌─────────────┐
                        │  MainTabView │
                        └──────┬──────┘
              ┌────────┬───────┼───────┬────────┐
              ⇥        ⇥       ⇥       ⇥
          ┌───┴──┐ ┌───┴──┐ ┌─┴──┐ ┌──┴──┐
          │🏠首页│ │🔍发现│ │🛠️工具│ │👤我的│
          └──┬───┘ └──┬───┘ └─┬──┘ └──┬──┘
             │        │       │       │
    ┌────────┼────────┼───────┼───────┼────────────┐
    │        │        │       │       │            │
    ↓        ↓        ↓       ↓       ↓            ↓
 [→搜索]  [→详情]  [→分类]  [→计时]  [→收藏]    [→数据]
 [→详情]  [→标签]  [→标签]  [→换算]  [→足迹]    [→营养]
 [→分类]  [→热门]  [→吃什么] [→BMI]  [→笔记]    [→设置]
 [→标签]  [→搜索]          [→缩放]  [→购物]    [→反馈]
 [→高级]  [→详情]          [→过敏]  [→聊天]    [→就寝]
                                  [→时段]
                                  [→食材]
                                  [→菜单]

🏠 首页 (HomePage)

┌─────────────────────────────┐
│  HomeAppBar (双层)           │
│  ┌───────────────────────┐  │
│  │ 🍳 妈妈厨房    🔔     │  │ ← 固定顶栏
│  └───────────────────────┘  │
│  ┌───────────────────────┐  │
│  │ 🔍 搜索框  [→搜索页]   │  │ ← 可折叠副栏，点击跳转
│  └───────────────────────┘  │
├─────────────────────────────┤
│                             │
│  ┌─────────────────────┐   │
│  │ 📊 营养追踪仪表盘    │   │ ← NutritionDashboardCard
│  │  热量/蛋白质/碳水/脂肪 │   │   [→营养中心页]
│  └─────────────────────┘   │
│                             │
│  ┌──┐ ┌──┐ ┌──┐ ┌──┐     │
│  │📖│ │🥬│ │📂│ │👅│     │ ← Discover瀑布流
│  │菜│ │食│ │分│ │标│     │   (MasonryGridView 2列)
│  │品│ │材│ │类│ │签│     │
│  │ ↓│ │ ↓│ │ ↓│ │ ↓│     │
│  └──┘ └──┘ └──┘ └──┘     │
│  ┌──┐ ┌──┐                 │
│  │🍳│ │🕐│                 │
│  │工│ │时│                 │
│  │艺│ │段│                 │
│  └──┘ └──┘                 │
│                             │
│  🔄 刷新加载更多  35/80     │
│  ═══════════░░░░░░░░       │ ← 进度条
│  最后更新: 5分钟前          │
│                             │
└─────────────────────────────┘

<EFBFBD> 页面视图文件

lib/src/pages/home/home_page.dart（主页面）
lib/src/pages/home/home_recommended.dart（瀑布流推荐）

<EFBFBD> 跳转关系

触发元素	跳转方式	目标页面	路由	传参
搜索框	`Get.toNamed`	搜索页	`/search`	keyword
菜品卡片	`Get.toNamed`	菜品详情页	`/recipe-detail`	id
食材卡片	`Get.toNamed`	搜索页	`/search`	keyword=食材名
分类卡片	`Get.toNamed`	分类浏览页	`/category-browse`	category, title
口味标签	`Get.toNamed`	标签菜谱列表	`/tag-recipe-list`	tagName, tagId, tagType=taste
工艺标签	`Get.toNamed`	标签菜谱列表	`/tag-recipe-list`	tagName, tagId, tagType=cooking
时段卡片	`Get.toNamed`	搜索页	`/search`	keyword=时段名
营养仪表盘	`Get.toNamed`	营养中心	`/nutrition`	-

🎨 美观问题

#	问题	严重度	建议
1	营养仪表盘与瀑布流风格不统一，仪表盘偏Material风格	🟡中	统一为Liquid Glass卡片风格
2	瀑布流卡片间距不够精致，部分卡片高度差异过大	🟡中	调整MasonryGridView crossAxisSpacing/mainAxisSpacing
3	搜索框折叠动画与滚动不够丝滑	🟢低	使用AnimationController替代AnimatedSlide
4	底部刷新按钮区域视觉过重，占用空间大	🟡中	精简为小按钮+进度文字

⚡ 功能缺失

#	功能	优先级	说明
1	下拉刷新	P2	当前只有底部刷新按钮，缺少下拉手势
2	个性化推荐	P3	瀑布流为随机数据，未基于用户偏好
3	卡片长按菜单	P3	长按卡片可收藏/分享/不感兴趣

🔍 发现页 (DiscoverPage)

┌─────────────────────────────┐
│  发现                       │
│  ┌───────────────────────┐  │
│  │ 🔍 搜索框  [→搜索页]   │  │ ← GlassSearchBar，点击跳转
│  └───────────────────────┘  │
│                             │
│  ┌───────────────────────┐  │
│  │📖推荐│🔥热门│🎲吃什么  │  │ ← GlassSegmentedControl
│  └───────────────────────┘  │
│                             │
│  ── 推荐 Tab ──             │
│  ┌───────────────────────┐  │
│  │📖菜谱│🥬食材│👅口味│🍳工艺│  │ ← 4段子分类
│  └───────────────────────┘  │
│  ┌──┐ ┌──┐ ┌──┐           │
│  │分类│ │分类│ │分类│         │ ← 分类/标签网格
│  │ ↓│  │ ↓│  │ ↓│          │
│  └──┘ └──┘ └──┘           │
│                             │
│  ── 热门 Tab ──             │
│  [→热门排行页]              │ ← 嵌入HotPage
│                             │
│  ── 今天吃什么 Tab ──       │
│  [→今天吃什么页]            │ ← 嵌入WhatToEatPage
│                             │
└─────────────────────────────┘

📄 页面视图文件

lib/src/pages/discover/discover_page.dart（主页面）
lib/src/pages/discover/hot_page.dart（热门排行Tab）

🔗 跳转关系

触发元素	跳转方式	目标页面	路由	传参
搜索框	`Get.toNamed`	搜索页	`/search`	-
菜谱分类卡片	`Get.toNamed`	分类浏览页	`/category-browse`	category, title
食材分类卡片	`Get.toNamed`	分类浏览页	`/category-browse`	category, title, isIngredient=true
口味标签	`Get.toNamed`	标签菜谱列表	`/tag-recipe-list`	tagName, tagId, tagType=taste
工艺标签	`Get.toNamed`	标签菜谱列表	`/tag-recipe-list`	tagName, tagId, tagType=cooking
热门Tab	嵌入页面	热门排行页	`/hot`	-
吃什么Tab	嵌入页面	今天吃什么	`/what-to-eat`	-
热门菜谱卡片	`Get.toNamed`	菜品详情页	`/recipe-detail`	id

🎨 美观问题

#	问题	严重度	建议
1	推荐4段子分类(菜谱/食材/口味/工艺)切换无过渡动画	🟡中	添加AnimatedSwitcher或PageView
2	分类网格卡片样式单调，缺少图标/封面图	🟡中	分类卡片增加emoji图标或渐变色背景
3	热门排行榜列表项间距过密	🟢低	增加列表项间距
4	"今天吃什么"页面视觉冲击力不足	🟡中	大卡片+动画翻转效果

⚡ 功能缺失

#	功能	优先级	说明
1	搜索历史	P2	搜索框点击后无历史记录展示
2	热门排行榜分时段	P3	日榜/周榜/月榜切换
3	今天吃什么筛选条件	P2	可按口味/难度/时间筛选随机推荐

🔍 搜索页 (SearchPage)

┌─────────────────────────────┐
│  ← [↑返回] 🔍 搜索框  ⚙️   │ ← ⚙️ [→高级搜索页]
├─────────────────────────────┤
│                             │
│  ── 空状态 ──               │
│  🔥 热门搜索               │
│  ┌────┐┌────┐┌────┐       │
│  │红烧肉││鸡汤││蛋糕│       │ ← 点击 [→搜索页] 自动搜索
│  └────┘└────┘└────┘       │
│                             │
│  ── 搜索结果 ──             │
│  📖菜谱(5)│🥬食材(3)│👅口味│ ← 动态Tab
│                             │
│  ┌─────────────────────┐   │
│  │ 🖼️  红烧肉          │   │ ← 菜谱卡片 [→详情页]
│  │     ⭐4.5  👁️1.2k   │   │
│  └─────────────────────┘   │
│  ┌─────────────────────┐   │
│  │ 🥬 鸡蛋  分类:蛋类   │   │ ← 食材卡片 [→食材详情]
│  │    📖 128个菜谱      │   │
│  └─────────────────────┘   │
│  ┌─────────────────────┐   │
│  │ 👅 咸鲜  56道菜谱    │   │ ← 标签卡片 [→标签列表]
│  └─────────────────────┘   │
│                             │
└─────────────────────────────┘

<EFBFBD> 页面视图文件

lib/src/pages/home/search_page.dart（主页面）
lib/src/controllers/search_controller.dart（搜索控制器）

<EFBFBD> 跳转关系

触发元素	跳转方式	目标页面	路由	传参
← 返回	`Get.back`	上一个页面	-	-
⚙️ 高级搜索	`Get.toNamed`	高级搜索页	`/advanced-search`	-
热门搜索词	本页搜索	本页	-	keyword
菜谱结果卡片	`Get.toNamed`	菜品详情页	`/recipe-detail`	id
食材结果卡片	`Get.toNamed`	食材详情页	`/tools/ingredient`	ingredientId, ingredientName
口味标签结果	`Get.toNamed`	标签菜谱列表	`/tag-recipe-list`	tagName, tagId, tagType=taste
工艺标签结果	`Get.toNamed`	标签菜谱列表	`/tag-recipe-list`	tagName, tagId, tagType=cooking

🎨 美观问题

#	问题	严重度	建议
1	热门搜索标签样式过于朴素	🟡中	使用毛玻璃胶囊标签+渐变色
2	搜索结果卡片间距不统一	🟢低	统一使用DesignTokens.space3
3	Tab切换无滑动指示器	🟡中	添加下划线滑动动画

⚡ 功能缺失

#	功能	优先级	说明
1	搜索历史记录	P2	本地保存最近搜索词
2	搜索建议/自动补全	P3	输入时实时显示建议
3	搜索结果分页加载	P2	当前一次加载20条，无分页

⚙️ 高级搜索页 (AdvancedSearchPage)

┌─────────────────────────────┐
│  ← [↑返回]  高级搜索        │
├─────────────────────────────┤
│                             │
│  📂 菜谱分类                │
│  ┌──┐┌──┐┌──┐┌──┐         │
│  │家常││川菜││粤菜││湘菜│     │
│  └──┘└──┘└──┘└──┘         │
│                             │
│  <20> 口味标签                │
│  ┌──┐┌──┐┌──┐┌──┐         │
│  │咸鲜││酱香││麻辣││清淡│     │
│  └──┘└──┘└──┘└──┘         │
│                             │
│  🍳 工艺标签                │
│  ┌──┐┌──┐┌──┐┌──┐         │
│  │红烧│ │清蒸│ │炒│ │炖│     │
│  └──┘ └──┘ └──┘ └──┘     │
│                             │
│  🕐 用餐时段                │
│  ┌──┐┌──┐┌──┐             │
│  │早餐│ │午餐│ │晚餐│         │
│  └──┘└──┘└──┘             │
│                             │
│  ┌─────────────────────┐   │
│  │   🔍 搜索            │   │ ← [↑返回搜索页] 执行筛选
│  └─────────────────────┘   │
│  ┌─────────────────────┐   │
│  │   🔄 重置            │   │
│  └─────────────────────┘   │
│                             │
└─────────────────────────────┘

📄 页面视图文件

lib/src/pages/home/advanced_search_page.dart（主页面）
lib/src/repositories/recipe_repository.dart（数据源）

🔗 跳转关系

触发元素	跳转方式	目标页面	路由	传参
← 返回	`Get.back`	搜索页	-	-
🔍 搜索按钮	`Get.back` + 搜索页刷新	搜索页	`/search`	tasteName/cookingName/categoryId

<EFBFBD><EFBFBD> 菜品详情页 (RecipeDetailPage)

┌─────────────────────────────┐
│  ← [↑返回]  菜谱详情        │
├─────────────────────────────┤
│  ┌─────────────────────┐   │
│  │                     │   │
│  │   🖼️ 封面大图       │   │ ← RecipeCoverImage
│  │        ⭐ 4.5       │   │ ← 评分徽章
│  │                     │   │
│  └─────────────────────┘   │
│                             │
│  📝 红烧肉                  │ ← RecipeTitleSection
│  📂 家常菜 > 红烧           │ ← [→分类浏览页] 非末级可点击
│                             │
│  👁️1.2k  ❤️56  ⭐4.5  💬0  │ ← RecipeStatisticsBar
│                             │
│  🏷️ 咸鲜 > 酱香 > 下饭菜   │ ← [→标签列表页] 标签可点击
│                             │
│  ┌─────────────────────┐   │
│  │ ⏱️ 30分  📊 中等    │   │ ← RecipeTimeInfo
│  │ 👤 2人份            │   │
│  └─────────────────────┘   │
│                             │
│  ── 🥬 食材 ──             │
│  ┌─────────────────────┐   │
│  │ 主料: 五花肉500g  [→食材]│ ← 食材名可点击
│  │ 辅料: 生抽/老抽/糖 [→食材]│
│  └─────────────────────┘   │
│                             │
│  ── 👨‍🍳 步骤 ──             │
│  ┌─────────────────────┐   │
│  │ Step 1: 切肉...     │   │ ← RecipeStepsSection
│  │ Step 2: 煎炒...     │   │
│  │ Step 3: 炖煮...     │   │
│  └─────────────────────┘   │
│                             │
│  ── 📊 营养 ──             │
│  ┌─────────────────────┐   │
│  │ 热量: 380kcal       │   │ ← RecipeNutritionSection
│  │ 蛋白质/碳水/脂肪     │   │
│  └─────────────────────┘   │
│                             │
│  ┌─────────────────────┐   │
│  │ ❤️ 点赞  ⭐ 评分  📤分享│ ← RecipeActionBar
│  │         📝 笔记      │   │   [→笔记页]
│  └─────────────────────┘   │
│                             │
└─────────────────────────────┘

<EFBFBD> 页面视图文件

lib/src/pages/home/recipe_detail_page.dart（主页面）
lib/src/widgets/recipe_detail/recipe_statistics_bar.dart（统计栏组件）

<EFBFBD> 跳转关系

触发元素	跳转方式	目标页面	路由	传参
← 返回	`Get.back`	上一个页面	-	-
分类面包屑	`Get.toNamed`	分类浏览页	`/category-browse`	category, title
口味/工艺标签	`Get.toNamed`	标签菜谱列表	`/tag-recipe-list`	tagName, tagId, tagType
食材名称	`Get.toNamed`	食材详情页	`/tools/ingredient`	ingredientId, ingredientName
📝 笔记按钮	`Get.toNamed`	烹饪笔记页	`/cooking-note`	recipeId, recipeTitle, recipeInfo
📤 分享按钮	系统分享	iOS Share Sheet	-	-
❤️ 点赞按钮	API调用	本页更新	-	-
⭐ 评分按钮	API调用	本页弹窗	-	-

🎨 美观问题

#	问题	严重度	建议
1	封面图与标题之间缺少视觉过渡	🟡中	封面图底部添加渐变遮罩
2	步骤区域纯文字，缺少步骤图	🟡中	支持显示步骤配图(如有)
3	食材区域排版过于紧凑	🟢低	增加主料/辅料分组间距
4	底部操作栏与内容区无分隔	🟡中	添加毛玻璃分隔条
5	营养数据纯文字展示，缺少可视化	🟡中	添加环形图/进度条展示占比

⚡ 功能缺失

#	功能	优先级	说明
1	🔗 相关菜谱推荐	P2	详情页底部推荐相似菜品
2	📝 烹饪模式	P2	全屏步骤+计时器+防息屏
3	💬 评论列表	P3	展示用户评论(需后端)
4	⚠️ 过敏原警示	P2	食材含过敏原时显示警告
5	📱 二维码海报	P3	生成菜谱分享图

🛠️ 工具中心 (ToolsCenterPage)

┌─────────────────────────────┐
│  🛠️ 工具箱                  │
│  ┌───────────────────────┐  │
│  │ 🔍 搜索工具            │  │
│  └───────────────────────┘  │
│                             │
│  ── 🍳 烹饪助手 ──         │
│  ┌──┐ ┌──┐ ┌──┐           │
│  │⏱️│ │📝│ │🧮│           │
│  │计时│ │笔记│ │换算│         │
│  │ ↓│  │ ↓│  │ ↓│          │
│  └──┘ └──┘ └──┘           │
│                             │
│  ── 📋 规划管理 ──         │
│  ┌──┐ ┌──┐ ┌──┐           │
│  │📅│ │🛒│ │⚖️│           │
│  │菜单│ │购物│ │缩放│         │
│  │ ↓│  │ ↓│  │ ↓│          │
│  └──┘ └──┘ └──┘           │
│                             │
│  ── 🏥 健康工具 ──         │
│  ┌──┐ ┌──┐                 │
│  │BMI│ │🌙│                 │
│  │计算│ │就寝│               │
│  │ ↓│  │ ↓│                │
│  └──┘ └──┘                 │
│                             │
│  ── 🏷️ 热门标签 ──         │
│  ┌────┐┌────┐┌────┐       │
│  │咸鲜 ││酱香 ││清淡 │       │ ← [→标签列表页]
│  └────┘└────┘└────┘       │
│                             │
└─────────────────────────────┘

📄 页面视图文件

lib/src/pages/tools/tools_center_page.dart（主页面）
lib/src/widgets/glass/glass_container.dart（毛玻璃卡片）

🔗 跳转关系

触发元素	跳转方式	目标页面	路由	传参
⏱️ 烹饪计时	`Get.toNamed`	烹饪计时器	`/cooking-timer`	-
📝 烹饪笔记	`Get.toNamed`	烹饪笔记页	`/cooking-note`	recipeId, recipeTitle
🧮 用量换算	`Get.toNamed`	单位换算页	`/unit-converter`	-
📅 每周菜单	`Get.toNamed`	菜单规划页	`/tools/weekly-menu`	-
🛒 购物清单	`Get.toNamed`	购物清单页	`/shopping-list`	-
⚖️ 份量缩放	`Get.toNamed`	份量缩放页	`/serving-scaler`	ingredients, servings
BMI计算	`Get.toNamed`	BMI计算器	`/bmi-calculator`	-
🌙 就寝提醒	`Get.toNamed`	就寝提醒页	`/profile/bedtime-reminder`	-
热门标签	`Get.toNamed`	标签菜谱列表	`/tag-recipe-list`	tagName, tagId, tagType

🎨 美观问题

#	问题	严重度	建议
1	工具图标+文字卡片样式过于简单	🟡中	增加渐变背景或毛玻璃效果
2	分组标题缺少视觉层次	🟢低	添加分组图标和分割线
3	热门标签区域与工具卡片风格不一致	🟡中	统一为毛玻璃胶囊样式

⚡ 功能缺失

#	功能	优先级	说明
1	用餐时段推荐	P2	eating_times.json数据已有，缺页面入口
2	过敏原检测器增强	P2	当前仅展示，缺智能过滤
3	工具使用统计	P3	展示常用工具排行

👤 我的 (ProfilePage)

┌─────────────────────────────┐
│  我的                       │
│  ┌───────────────────────┐  │
│  │ 🏠 首页 │ ⚙️ 更多    │  │ ← GlassSegmentedControl
│  └───────────────────────┘  │
│                             │
│  ── 首页 Tab ──             │
│  ┌───────────────────────┐  │
│  │ 🧑 用户头像            │  │
│  │ 美食爱好者             │  │
│  │ ⭐ Lv.5 烹饪达人      │  │
│  └───────────────────────┘  │
│                             │
│  ┌──┐┌──┐┌──┐┌──┐         │
│  │❤️││👀││📝││🛒│         │ ← 功能入口
│  │收藏││足迹││笔记││购物│         │
│  │ ↓│ │ ↓│ │ ↓│ │ ↓│      │
│  └──┘└──┘└──┘└──┘         │
│                             │
│  ┌──┐┌──┐┌──┐┌──┐         │
│  │⏱️│ │🔄│ │📊│ │⚖️│         │ ← 工具快捷
│  │计时│ │换算│ │BMI│ │缩放│         │
│  │ ↓│  │ ↓│  │ ↓│  │ ↓│    │
│  └──┘ └──┘ └──┘ └──┘     │
│                             │
│  ── 更多 Tab ──             │
│  ┌───────────────────────┐  │
│  │ 📊 数据管理中心  [→]   │  │
│  │ 🎨 个性化设置    [→]   │  │
│  │ 🗑️ 缓存管理     [→]   │  │
│  │ 🌙 就寝提醒     [→]   │  │
│  │ 📋 营养中心     [→]   │  │
│  │ 💬 意见反馈     [→]   │  │
│  └───────────────────────┘  │
│                             │
└─────────────────────────────┘

<EFBFBD> 页面视图文件

lib/src/pages/profile/profile_page.dart（主页面）
lib/src/pages/profile/profile_home.dart（首页Tab）

<EFBFBD> 跳转关系

触发元素	跳转方式	目标页面	路由	传参
❤️ 收藏	`Get.toNamed`	收藏页	`/favorites`	-
👀 足迹	`Get.toNamed`	浏览记录页	`/footprints`	-
📝 笔记	`Get.toNamed`	烹饪笔记页	`/cooking-note`	-
🛒 购物	`Get.toNamed`	购物清单页	`/shopping-list`	-
⏱️ 计时	`Get.toNamed`	烹饪计时器	`/cooking-timer`	-
🔄 换算	`Get.toNamed`	单位换算页	`/unit-converter`	-
📊 BMI	`Get.toNamed`	BMI计算器	`/bmi-calculator`	-
⚖️ 缩放	`Get.toNamed`	份量缩放页	`/serving-scaler`	-
📊 数据中心	`Get.toNamed`	数据管理中心	`/data-center`	-
🎨 个性化	`Get.toNamed`	个性化设置	`/personalization`	-
🗑️ 缓存	`Get.toNamed`	缓存管理页	内页	-
🌙 就寝	`Get.toNamed`	就寝提醒	`/profile/bedtime-reminder`	-
📋 营养	`Get.toNamed`	营养中心	`/nutrition`	-
💬 反馈	`Get.toNamed`	意见反馈	`/chat`	-

🎨 美观问题

#	问题	严重度	建议
1	用户头像区域过于简单，无背景装饰	🟡中	添加渐变背景+装饰元素
2	功能入口图标样式不统一	🟡中	统一为圆形图标+渐变背景
3	设置列表项缺少图标	🟢低	每项添加对应emoji图标

⚡ 功能缺失

#	功能	优先级	说明
1	用户等级系统	P3	浏览/收藏/评论获得经验值
2	成就徽章	P3	烹饪达人/美食家等徽章
3	数据导出	P3	导出收藏/浏览记录

🥬 食材详情页 (IngredientDetailPage)

┌─────────────────────────────┐
│  ← [↑返回]  食材详情        │
├─────────────────────────────┤
│  ┌─────────────────────┐   │
│  │   🖼️ 食材图片        │   │
│  └─────────────────────┘   │
│                             │
│  🥚 鸡蛋                    │
│  📂 分类: 蛋类              │
│                             │
│  ── 📖 相关菜谱 ──         │
│  ┌──┐ ┌──┐ ┌──┐           │
│  │菜│ │菜│ │菜│           │ ← [→菜品详情页]
│  └──┘ └──┘ └──┘           │
│                             │
│  ┌─────────────────────┐   │
│  │    🏠 返回首页       │   │ ← Get.until((route) => route.isFirst)
│  └─────────────────────┘   │
└─────────────────────────────┘

📄 页面视图文件

lib/src/pages/tools/ingredient_detail_page.dart（主页面）
lib/src/controllers/ingredient_controller.dart（食材控制器）

🔗 跳转关系

触发元素	跳转方式	目标页面	路由	传参
← 返回	`Get.back`	上一个页面	-	-
相关菜谱卡片	`Get.toNamed`	菜品详情页	`/recipe-detail`	id
<EFBFBD> 返回首页	`Get.until((route) => route.isFirst)`	首页(Tab0)	-	-

<EFBFBD><EFBFBD> 美观问题

#	问题	严重度	建议
1	食材信息区域过于简单	🟡中	添加营养成分摘要/季节性/选购建议
2	相关菜谱卡片样式与首页不一致	🟡中	统一卡片样式

⚡ 功能缺失

#	功能	优先级	说明
1	食材营养详情	P2	展示食材营养成分数据
2	食材替代建议	P3	缺少该食材时的替代品推荐
3	过敏原关联	P2	关联数据管理中心的过敏原设置

📂 分类浏览页 (CategoryBrowsePage)

┌─────────────────────────────┐
│  ← [↑返回]  📂 家常菜       │
├─────────────────────────────┤
│  ┌──┐ ┌──┐ ┌──┐           │
│  │红烧│ │炖菜│ │炒菜│       │ ← 子分类网格 [→分类浏览页(递归)]
│  └──┘ └──┘ └──┘           │
│                             │
│  ── 菜谱列表 ──             │
│  ┌─────────────────────┐   │
│  │ 🖼️ 红烧肉  ⭐4.5    │   │ ← [→菜品详情页]
│  └─────────────────────┘   │
│  ┌─────────────────────┐   │
│  │ 🖼️ 炖排骨  ⭐4.2    │   │ ← [→菜品详情页]
│  └─────────────────────┘   │
│                             │
└─────────────────────────────┘

<EFBFBD> 页面视图文件

lib/src/pages/discover/category_browse_page.dart（主页面）
lib/src/controllers/category_controller.dart（分类控制器）

<EFBFBD> 跳转关系

触发元素	跳转方式	目标页面	路由	传参
← 返回	`Get.back`	上一个页面	-	-
子分类卡片	`Get.toNamed`	分类浏览页(递归)	`/category-browse`	category, title
菜谱卡片	`Get.toNamed`	菜品详情页	`/recipe-detail`	id

🎨 美观问题

#	问题	严重度	建议
1	子分类网格与菜谱列表之间缺少视觉分隔	🟢低	添加分组标题
2	菜谱列表卡片样式单调	🟡中	添加封面图+评分+浏览量

⚡ 功能缺失

#	功能	优先级	说明
1	分页加载	P2	当前一次加载，无分页
2	排序筛选	P3	按评分/浏览量/最新排序

🏷️ 标签菜谱列表 (TagRecipeListPage)

┌─────────────────────────────┐
│  ← [↑返回]  👅 咸鲜         │
├─────────────────────────────┤
│  ┌─────────────────────┐   │
│  │ 🖼️ 红烧肉  ⭐4.5    │   │ ← [→菜品详情页]
│  └─────────────────────┘   │
│  ┌─────────────────────┐   │
│  │ 🖼️ 清蒸鱼  ⭐4.3    │   │ ← [→菜品详情页]
│  └─────────────────────┘   │
│                             │
└─────────────────────────────┘

📄 页面视图文件

lib/src/pages/home/tag_recipe_list_page.dart（主页面）
lib/src/controllers/tag_controller.dart（标签控制器）

🔗 跳转关系

触发元素	跳转方式	目标页面	路由	传参
← 返回	`Get.back`	上一个页面	-	-
菜谱卡片	`Get.toNamed`	菜品详情页	`/recipe-detail`	id

🎨 美观问题

#	问题	严重度	建议
1	页面顶部缺少标签说明/统计	🟡中	添加"共XX道菜"统计
2	列表卡片样式与首页瀑布流不统一	🟡中	可考虑使用小瀑布流布局

⚡ 功能缺失

#	功能	优先级	说明
1	分页加载	P2	当前无分页
2	排序筛选	P3	按评分/浏览量排序

🔥 热门排行页 (HotPage)

┌─────────────────────────────┐
│  🔥 热门排行                │
│  <20>菜谱│🥬食材│👅口味│🍳工艺  │ ← Tab切换
│                             │
│  🥇 红烧肉  ❤️ 2.3k  [→详情]│
│  🥈 牛肉面  ❤️ 1.8k  [→详情]│
│  🥉 凉拌菜  ❤️ 1.5k  [→详情]│
│  4. 宫保鸡丁 ❤️ 1.2k [→详情]│
│  5. 糖醋排骨 ❤️ 1.1k [→详情]│
│                             │
└─────────────────────────────┘

<EFBFBD> 页面视图文件

lib/src/pages/discover/hot_page.dart（主页面）
lib/src/controllers/hot_controller.dart（热门控制器）

<EFBFBD> 跳转关系

触发元素	跳转方式	目标页面	路由	传参
排行菜谱卡片	`Get.toNamed`	菜品详情页	`/recipe-detail`	id
排行食材卡片	`Get.toNamed`	食材详情页	`/tools/ingredient`	ingredientId, ingredientName
排行标签	`Get.toNamed`	标签菜谱列表	`/tag-recipe-list`	tagName, tagId, tagType

🎨 美观问题

#	问题	严重度	建议
1	排行榜前三名缺少视觉突出	🟡中	前三名使用金银铜色+大号排名
2	列表项样式过于简单	🟡中	添加封面缩略图+评分星级

🎲 今天吃什么 (WhatToEatPage)

┌─────────────────────────────┐
│  🎲 今天吃什么              │
│                             │
│  ┌─────────────────────┐   │
│  │                     │   │
│  │   🖼️ 推荐菜谱大卡    │   │ ← [→菜品详情页]
│  │   红烧肉             │   │
│  │   ⭐4.5  👁️1.2k     │   │
│  │                     │   │
│  └─────────────────────┘   │
│                             │
│  ┌────────┐ ┌────────┐    │
│  │ 🔄换一个│ │ 📖看详情│    │ ← 换一个=刷新, 看详情=[→详情]
│  └────────┘ └────────┘    │
│                             │
└─────────────────────────────┘

📄 页面视图文件

lib/src/pages/discover/what_to_eat_page.dart（主页面）
lib/src/controllers/what_to_eat_controller.dart（推荐控制器）

🔗 跳转关系

触发元素	跳转方式	目标页面	路由	传参
📖 看详情	`Get.toNamed`	菜品详情页	`/recipe-detail`	id
🔄 换一个	本页刷新	本页	-	-

📊 全局美观问题汇总

优先级	问题	影响页面	建议	状态
🟡高	毛玻璃效果使用不一致	全局	统一GlassCard组件，所有卡片使用相同毛玻璃参数	✅已统一
🟡高	卡片圆角不统一	全局	统一使用DesignTokens.radiusMd/Lg	✅已统一(89处)
🟡高	颜色使用偶尔硬编码	全局	严格使用DesignTokens颜色变量	✅已统一(20处)
🟡中	空状态页面缺少插画	多个页面	设计统一的空状态插画+文案	✅已增强(GlassCard包裹)
🟡中	加载状态不统一	全局	统一骨架屏样式和动画	✅已增强(LoadingIndicator)
🟢低	页面转场动画单调	全局	添加iOS风格滑入动画	🔴待开发

📊 全局功能缺失汇总

优先级	功能	影响页面	说明	状态
P1	下拉刷新	首页/发现	缺少下拉手势刷新	🔴待开发
P2	搜索历史	搜索页	无本地搜索记录	🔴待开发
P2	分页加载	多个列表页	分类浏览/标签列表无分页	🔴待开发
P2	相关推荐	详情页	缺少相关菜谱推荐	🔴待开发
P2	烹饪模式	详情页	全屏步骤+计时器	🔴待开发
P2	过敏原警示	详情页	食材含过敏原时警告	🔴待开发
P2	营养可视化	详情页	环形图/进度条展示营养占比	🔴待开发
P3	排序筛选	列表页	按评分/浏览量/最新排序	🔴待开发
P3	评论系统	详情页	需后端支持	🔴需后端
P3	用户等级	个人中心	经验值+等级+徽章	🔴需后端

🔌 API能力分析：可增加功能

基于 APP_GUIDE.md(v2.9.0) 和 API_DOC.md(v3.2.0) 全面分析，2026-04-13 更新

📊 已使用API接口一览

接口文件	Repository	已用act	状态
`api.php`	RecipeRepository	list/detail/full/ingredients/ingredient_detail/search/categories/tags/stats/unified_list/unified_detail/unified_search/unified_hot/query	✅
`api_action.php`	ActionRepository	like/rate/view/ip_status	✅
`api_feed.php`	FeedRepository	recommend/latest/hot/prefetch	✅
`api_filter.php`	RecipeRepository+SearchController	recipe_main_categories/taste_tags/cooking_tags/filter_recipes/global_search	✅
`api_hot.php`	HotRepository(→stats_full.php?act=hot)	hot	✅
`api_what_to_eat.php`	WhatToEatRepository	filter_apply/detail	✅
`api_discover.php`	DiscoverRepository	随机数据	✅
`stats_full.php`	StatsRepository	online/request/hot	✅
静态数据	未使用	eating_times.json/nutrition_types.json/gmy.json	❌未使用

📊 未使用API接口一览

接口	act/参数	文档描述	当前状态
`api.php?act=mini`	mini	迷你版菜谱信息(~1KB)，适用于列表页快速加载	❌未调用
`api_filter.php?act=meal_times`	meal_times	用餐时段列表(早餐/中餐/晚餐等)	❌未调用
`api_filter.php?act=recipe_sub_categories`	recipe_sub_categories&parent_id=	食谱子分类列表	❌未调用
`api_filter.php?act=ingredient_main_categories`	ingredient_main_categories	食材大类列表	❌未调用
`api_filter.php?act=ingredient_sub_categories`	ingredient_sub_categories&parent_id=	食材子分类列表	❌未调用
`api_filter.php?act=category_tags`	category_tags&category_id=	指定分类下的口味+工艺标签	❌未调用
`api_filter.php` exclude_*参数	exclude_category/taste/cooking/allergen等	排除筛选(排除分类/口味/工艺/过敏原)	❌未调用
`api_filter.php` 高级筛选	nutrition_name/min/max, allergen, ingredient, author_id	营养范围/过敏原/食材/作者筛选	❌未调用
`api_what_to_eat.php?act=filter_steps`	filter_steps&category=	获取筛选步骤和菜谱数量	❌未调用
`api_what_to_eat.php?act=detail&code=`	detail&code=CP032892	编码查询菜谱详情	❌未调用
`api_what_to_eat.php?act=detail&title=&fuzzy=1`	detail&title=&fuzzy=1	模糊标题搜索	❌未调用
`api_hot.php?sort=rate`	sort=rate	按评分排序的热门排行	❌未调用
`api.php?act=unified_list&type=ingredient`	unified_list&type=ingredient	统一格式食材列表	❌未调用
`api.php?act=unified_detail&type=ingredient`	unified_detail&type=ingredient	统一格式食材详情	❌未调用
`api.php?act=unified_hot&type=ingredient`	unified_hot&type=ingredient	统一格式食材热门	❌未调用
`eating_times.json`	静态资源	34种用餐时段数据(标准/组合/频率/方法)	❌未使用
`nutrition_types.json`	静态资源	31种营养成分数据(含单位)	❌未使用
`gmy.json`	静态资源	585种过敏原数据(21大类)	❌未使用

🟢 已有API可直接开发（P2优先级）

#	功能	API接口	数据源	页面位置	开发复杂度	说明
1	🕐 用餐时段推荐	`api_filter.php?act=meal_times`	eating_times.json(34种)	首页/工具中心	⭐⭐	根据当前时间智能推荐早/午/晚餐，首页瀑布流已有时段卡片但跳转搜索页，应改为时段专属推荐页
2	⚠️ 过敏原警示	`api.php?act=full` allergens字段	gmy.json(585种)	菜品详情页	⭐⭐	详情页显示过敏原警告，结合用户过敏原设置自动过滤，已有allergen字段但未展示
3	📊 营养可视化	`api.php?act=full` nutrition字段	nutrition_types.json(31种)	菜品详情页/营养中心	⭐⭐⭐	环形图/进度条展示营养占比，nutrition字段已有数据，需前端可视化组件
4	🏆 评分排行榜	`api_hot.php?type=recipe&sort=rate`	api_hot.php	热门排行页	⭐	热门页已有Tab，增加"评分榜"排序选项，API已支持sort=rate
5	📱 迷你信息加载	`api.php?act=mini&id=`	api.php	列表页/卡片	⭐⭐	列表页使用mini接口(~1KB)替代detail(~10KB)，10倍性能提升，需改造列表加载逻辑
6	🔍 排除筛选	`api_filter.php?act=filter_recipes` exclude_*参数	api_filter.php	高级搜索页	⭐	高级搜索页增加"排除"选项，如排除辣味/油炸等，API已支持7个exclude参数
7	🌐 IP状态显示	`api_action.php?act=ip_status`	api_action.php	菜品详情页	⭐	评分前显示今日剩余评分次数，ActionRepository已封装fetchIpStatus()但UI未使用
8	🏷️ 分类标签联动	`api_filter.php?act=category_tags&category_id=`	api_filter.php	分类浏览页/高级搜索	⭐⭐	选择分类后自动加载该分类下的口味+工艺标签，提升筛选体验
9	🥗 食材分类浏览	`api_filter.php?act=ingredient_main_categories/sub_categories`	api_filter.php	发现页/工具中心	⭐⭐	食材大类→子类→食材列表三级浏览，当前发现页食材分类跳转分类浏览页但无食材专用分类
10	📋 食谱子分类	`api_filter.php?act=recipe_sub_categories&parent_id=`	api_filter.php	分类浏览页	⭐	当前分类浏览使用api.php?act=categories，改用filter接口可获取更丰富的子分类数据
11	🎲 筛选步骤引导	`api_what_to_eat.php?act=filter_steps`	api_what_to_eat.php	今天吃什么	⭐⭐	逐步筛选：先选分类→再选标签→显示匹配数量，比当前直接filter_apply体验更好
12	🔢 编码/模糊查询	`api_what_to_eat.php?act=detail&code=/title=`	api_what_to_eat.php	搜索页	⭐	支持菜谱编码(CP032892)查询和标题模糊搜索，扩展搜索能力

🟡 需组合API开发（P3优先级）

#	功能	所需API	页面位置	开发复杂度	说明
1	🧠 智能推荐	`api_feed.php?act=recommend` + `api_filter.php?act=filter_recipes` + `gmy.json` + 用户偏好设置	首页	⭐⭐⭐⭐	结合时段+营养+过敏原+用户偏好的智能推荐，需设计推荐算法权重
2	📅 每日菜单规划	`api_what_to_eat.php?act=filter_apply` × 3次 + `eating_times.json`	工具中心	⭐⭐⭐	一次性生成早中晚餐完整菜单，需新建菜单规划页面
3	📱 二维码海报	`api.php?act=detail` code字段 + qr_flutter库	菜品详情页	⭐⭐	生成菜谱二维码分享图，code字段已有(如CP032892)
4	🔗 社交分享增强	`api.php?act=detail` code字段 + `api_hot.php` statistics	菜品详情页	⭐⭐	分享链接含菜谱编码+热度标签，当前分享功能已有但内容简单
5	🏋️ 健身餐推荐	`api_filter.php?act=filter_recipes` nutrition_min/max + nutrition_types.json	工具中心/发现页	⭐⭐⭐	高蛋白(>30g)/低脂(<10g)/低碳水菜谱筛选，需营养目标设置UI
6	📋 过敏原报告	`api.php?act=full` allergens + `gmy.json`	菜品详情页	⭐⭐⭐	菜谱过敏原完整分析报告，交叉比对585种过敏原数据
7	🥗 食材营养详情	`api.php?act=ingredient_detail` + `nutrition_types.json`	食材详情页	⭐⭐	食材详情页增加营养成分表格+单位匹配，nutrition_types.json提供31种营养单位
8	🔄 食材替代建议	`api_filter.php?act=filter_recipes` ingredient参数 + `gmy.json`	食材详情页	⭐⭐⭐	缺少某食材时推荐替代品，需建立食材替代关系映射
9	📈 营养目标追踪	`api.php?act=full` nutrition × 多菜谱 + `nutrition_types.json`	营养中心	⭐⭐⭐⭐	每日营养摄入统计+目标追踪，需记录用户每日饮食
10	🏷️ 统一格式输出	`api.php?act=unified_list/detail/search/hot` type=ingredient	食材相关页面	⭐⭐	统一格式简化食材数据处理，当前食材页面使用不同接口格式

🔴 需后端新开发API

#	功能	建议接口	优先级	开发建议	说明
1	👤 用户注册登录	`api_user.php`	P1	暂不开发	需要用户认证体系，当前阶段不涉及
2	💾 收藏云端同步	`api_favorite.php`	P1	CRUD接口	当前收藏仅本地存储，需云端同步支持多设备
3	💬 评论系统	`api_comment.php`	P2	CRUD+分页	互动功能，需防刷+审核机制
4	🔔 消息推送	`api_message.php`	P2	推送+站内信	后续可能使用邮箱实现
5	📜 浏览历史同步	`api_history.php`	P2	CRUD+分页	当前仅本地存储，需云端同步
6	📝 菜谱上传	`api_recipe.php`	P2	表单提交+图片上传	UGC内容，需审核流程
7	🔄 相关菜谱推荐	`api.php?act=related&id=`	P2	基于分类+标签+食材相似度	详情页底部推荐相似菜品，可基于同分类+同标签实现
8	🔍 搜索建议/补全	`api.php?act=suggest&keyword=`	P3	前缀匹配+热门词	输入时实时建议，需后端建立搜索索引
9	📊 用户营养目标	`api_nutrition.php`	P3	CRUD+每日统计	每日营养摄入目标追踪，需用户系统
10	🏆 用户成就系统	`api_achievement.php`	P3	经验值+等级+徽章	需用户系统支撑
11	📝 烹饪笔记同步	`api_note.php`	P2	CRUD+分页	当前笔记仅本地Hive存储，需云端同步
12	🛒 购物清单同步	`api_shopping.php`	P2	CRUD	当前购物清单仅本地存储
13	⏰ 每周菜单存储	`api_menu.php`	P2	CRUD+日期范围	当前菜单规划功能无持久化

🎯 推荐开发路线图

第一阶段：快速见效（利用已有API，1-2天/功能）

顺序	功能	价值	工作量
1	🏆 评分排行榜	热门页增加评分排序	极小(改sort参数)
2	🌐 IP状态显示	评分前显示剩余次数	极小(已有方法)
3	🔍 排除筛选	高级搜索增加排除选项	小(增加UI+参数)
4	🕐 用餐时段推荐	根据时间智能推荐	小(新页面+API)
5	⚠️ 过敏原警示	详情页安全提醒	小(展示已有字段)

第二阶段：体验提升（组合API，3-5天/功能）

顺序	功能	价值	工作量
6	📊 营养可视化	详情页环形图展示	中(可视化组件)
7	🏷️ 分类标签联动	筛选体验提升	中(联动逻辑)
8	🥗 食材分类浏览	食材浏览体验完善	中(新页面)
9	🎲 筛选步骤引导	"吃什么"体验优化	中(步骤UI)
10	📱 迷你信息加载	列表页性能优化	中(改造加载逻辑)

第三阶段：深度功能（需后端配合或复杂逻辑）

顺序	功能	价值	工作量
11	📅 每日菜单规划	菜单规划工具	大(新页面+逻辑)
12	🏋️ 健身餐推荐	健康饮食功能	大(营养目标+筛选)
13	🧠 智能推荐	个性化推荐	大(推荐算法)
14	🔄 相关菜谱推荐	详情页推荐	需后端开发API

📋 已完成功能记录

2026-04-13 更新

阶段	功能	涉及文件
三十二	主题色全局生效修复	DesignTokens.dynamicPrimary替换(59文件439处)
三十三	全局UI统一	圆角89处+颜色20处+EmptyState+LoadingIndicator
三十四	食材详情本地缓存	IngredientModel.toJson+RecipeRepository缓存+CacheManagePage食材管理

50 KiB Raw Blame History Unescape Escape

📱 APP 页面结构分析

🏗️ 全局导航图

🏠 首页 (HomePage)

<EFBFBD> 页面视图文件

<EFBFBD> 跳转关系

🎨 美观问题

⚡ 功能缺失

🔍 发现页 (DiscoverPage)

📄 页面视图文件

🔗 跳转关系

🎨 美观问题

⚡ 功能缺失

🔍 搜索页 (SearchPage)

<EFBFBD> 页面视图文件

<EFBFBD> 跳转关系

🎨 美观问题

⚡ 功能缺失

⚙️ 高级搜索页 (AdvancedSearchPage)

📄 页面视图文件

🔗 跳转关系

<EFBFBD><EFBFBD> 菜品详情页 (RecipeDetailPage)

<EFBFBD> 页面视图文件

<EFBFBD> 跳转关系

🎨 美观问题

⚡ 功能缺失

🛠️ 工具中心 (ToolsCenterPage)

📄 页面视图文件

🔗 跳转关系

🎨 美观问题

⚡ 功能缺失

👤 我的 (ProfilePage)

<EFBFBD> 页面视图文件

<EFBFBD> 跳转关系

🎨 美观问题

⚡ 功能缺失

🥬 食材详情页 (IngredientDetailPage)

📄 页面视图文件

🔗 跳转关系

<EFBFBD><EFBFBD> 美观问题

⚡ 功能缺失

📂 分类浏览页 (CategoryBrowsePage)

<EFBFBD> 页面视图文件

<EFBFBD> 跳转关系

🎨 美观问题

⚡ 功能缺失

🏷️ 标签菜谱列表 (TagRecipeListPage)

📄 页面视图文件

🔗 跳转关系

🎨 美观问题

⚡ 功能缺失

🔥 热门排行页 (HotPage)

<EFBFBD> 页面视图文件

<EFBFBD> 跳转关系

🎨 美观问题

🎲 今天吃什么 (WhatToEatPage)

📄 页面视图文件

🔗 跳转关系

📊 全局美观问题汇总

📊 全局功能缺失汇总

🔌 API能力分析：可增加功能

📊 已使用API接口一览

📊 未使用API接口一览

🟢 已有API可直接开发（P2优先级）

🟡 需组合API开发（P3优先级）

🔴 需后端新开发API

🎯 推荐开发路线图

第一阶段：快速见效（利用已有API，1-2天/功能）

第二阶段：体验提升（组合API，3-5天/功能）

第三阶段：深度功能（需后端配合或复杂逻辑）

📋 已完成功能记录

50 KiB

Raw Blame History