16 KiB
16 KiB
📋 未完成功能清单
创建: 2026-04-09 | 更新: 2026-04-13 v0.92.0 | 优先级: P1=核心 P2=重要 P3=增强 | 优先级值1-5(5=最高)
📊 总体进度
| 阶段 | 任务 | 完成 | 率 | 状态 |
|---|---|---|---|---|
| 三：热量追踪+营养分析 | 7 | 7 | 100% | ✅ |
| 四：购物清单 | 5 | 5 | 100% | ✅ |
| 十二：社交+通知增强 | 4 | 2 | 50% | 🟡 |
| 十三：AI+规划高级功能 | 4 | 4 | 100% | ✅ |
| 十四：接口能力挖掘 | 8 | 8 | 100% | ✅ |
| 十五：后端接口增强 | 6 | 0 | 0% | 🔴 |
| 十六：用户体验优化+Bug修复 | 7 | 7 | 100% | ✅ |
| 十七：紧急Bug修复 | 14 | 14 | 100% | ✅ |
| 十九：综合Bug修复+功能增强 | 18 | 18 | 100% | ✅ |
| 二十：用户体验优化+交互增强 | 7 | 7 | 100% | ✅ |
| 二十一：菜谱详情页功能增强 | 1 | 1 | 100% | ✅ |
| 二十二：Picid功能Bug修复 | 2 | 2 | 100% | ✅ |
| 二十三：数据管理中心 | 3 | 2 | 67% | 🟡 |
| 二十四：笔记+浏览记录功能 | 2 | 2 | 100% | ✅ |
| 二十六：API v3.2.0迁移 | 5 | 5 | 100% | ✅ |
| 二十七：首页Discover瀑布流 | 8 | 8 | 100% | ✅ |
| 二十八：瀑布流渐进式渲染+分页 | 3 | 3 | 100% | ✅ |
| 二十九：菜品详情页功能完善 | 9 | 9 | 100% | ✅ |
| 三十：发现页口味/工艺筛选 | 3 | 3 | 100% | ✅ |
| 三十一：搜索功能修复与高级搜索 | 3 | 3 | 100% | ✅ |
| 三十二 | 主题色全局生效修复 | 1 | 1 | 100% |
| 三十三 | 全局UI统一（圆角/颜色/空状态/加载） | 4 | 4 | 100% |
| 三十四 | 食材详情本地缓存+缓存管理 | 2 | 2 | 100% |
| 三十五 | 食材详情页闪退修复 | 1 | 1 | 100% |
| 三十六 | 21项功能批量实现 | 21 | 21 | 100% |
| 合计 | 220 | 210 | 95% |
🔴 未完成任务汇总
按优先级排序，仅列出未完成任务
| 序号 | 阶段 | 任务 | 优先级 | 优先级值 | 说明 |
|---|---|---|---|---|---|
| 1 | 十五 | 👤 用户注册登录 | P1 | 5 | 需后端支持，当前暂不开发 |
| 2 | 十五 | 💾 收藏云端同步 | P1 | 4 | 需后端支持 |
| 3 | 十二 | 🔔 烹饪提醒通知 | P2 | 3 | 定时提醒烹饪步骤，需 flutter_local_notifications |
| 4 | 二十三 | ⚠️ 过敏原智能过滤 | P2 | 3 | 搜索/推荐时自动过滤含用户过敏原的菜品 |
| 5 | 十五 | 💬 评论系统 | P2 | 3 | 需后端支持 |
| 6 | 十五 | 🔔 消息推送 | P2 | 2 | 需后端支持 |
| 7 | 十五 | 📜 浏览历史同步 | P2 | 2 | 需后端支持 |
| 8 | 十五 | 📝 菜谱上传 | P2 | 2 | 需后端支持 |
| 9 | 十四 | 📱 二维码海报 | P3 | 2 | 生成菜谱二维码分享图 |
| 10 | 十四 | 🔗 社交分享增强 | P3 | 2 | 分享链接+热度标签+社交平台 |
| 11 | 十二 | 📸 拍照记录 | P3 | 2 | 烹饪笔记支持拍照上传 |
🟢 已有API可直接开发的功能（优先开发）
以下功能后端API已就绪，仅需前端开发
第一梯队：极小工作量（改参数/加UI）
| # | 功能 | API接口 | 页面位置 | 工作量 | 状态 |
|---|---|---|---|---|---|
| 1 | 🏆 评分排行榜 | api_hot.php?sort=rate |
热门排行页 | ⭐ | ✅ v0.92.0 |
| 2 | 🌐 IP状态显示 | api_action.php?act=ip_status |
菜品详情页 | ⭐ | ✅ v0.92.0 |
| 3 | 🔍 排除筛选 | api_filter.php?act=filter_recipes exclude_*参数 |
高级搜索页 | ⭐ | ✅ v0.92.0 |
| 4 | 📋 食谱子分类 | api_filter.php?act=recipe_sub_categories&parent_id= |
分类浏览页 | ⭐ | ✅ v0.92.0 |
| 5 | 🔢 编码/模糊查询 | api_what_to_eat.php?act=detail&code=/title= |
搜索页 | ⭐ | ✅ v0.92.0 |
第二梯队：小工作量（新页面+API调用）
| # | 功能 | API接口 | 页面位置 | 工作量 | 状态 |
|---|---|---|---|---|---|
| 6 | 🕐 用餐时段推荐 | api_filter.php?act=meal_times |
首页/工具中心 | ⭐⭐ | ✅ v0.92.0 |
| 7 | ⚠️ 过敏原警示 | api.php?act=full allergens字段 |
菜品详情页 | ⭐⭐ | ✅ v0.92.0 |
| 8 | 🏷️ 分类标签联动 | api_filter.php?act=category_tags&category_id= |
分类浏览/高级搜索 | ⭐⭐ | ✅ v0.92.0 |
| 9 | 🥗 食材分类浏览 | api_filter.php?act=ingredient_main_categories/sub_categories |
发现页/工具中心 | ⭐⭐ | ✅ v0.92.0 |
| 10 | 🎲 筛选步骤引导 | api_what_to_eat.php?act=filter_steps |
今天吃什么 | ⭐⭐ | ✅ v0.92.0 |
| 11 | 🥗 食材对应菜品 | api_filter.php?act=ingredient_recipes&ingredient_id= |
食材详情页 | ⭐⭐ | ✅ v0.92.0 |
| 12 | 🔍 食材筛选 | api_filter.php?act=filter_ingredients |
高级搜索页 | ⭐⭐ | ✅ v0.92.0 |
第三梯队：中等工作量（需可视化组件/逻辑重构）
| # | 功能 | API接口 | 页面位置 | 工作量 | 状态 |
|---|---|---|---|---|---|
| 13 | 📊 营养可视化 | api.php?act=full nutrition字段 |
菜品详情页/营养中心 | ⭐⭐⭐ | ✅ v0.92.0 |
| 14 | 📱 迷你信息加载 | api.php?act=mini |
列表页/卡片 | ⭐⭐⭐ | ✅ v0.92.0 |
| 15 | 🏷️ 统一格式输出 | api.php?act=unified_list/detail/hot type=ingredient |
食材相关页面 | ⭐⭐⭐ | 待开发 |
| 16 | 🏋️ 健身餐推荐 | api_filter.php?act=filter_recipes nutrition_min/max |
工具中心/发现页 | ⭐⭐⭐ | ✅ v0.92.0 |
| 17 | 📋 过敏原报告 | api.php?act=full allergens + gmy.json |
菜品详情页 | ⭐⭐⭐ | ✅ v0.92.0 |
| 18 | 🔎 查重检测 | api_check_duplicate.php 5种act |
菜谱上传/管理 | ⭐⭐⭐ | ✅ v0.92.0 |
🟡 需组合API开发的功能
需要多个已有API组合，或需前端复杂逻辑
| # | 功能 | 所需API | 页面位置 | 工作量 | 状态 |
|---|---|---|---|---|---|
| 1 | 🧠 智能推荐 | api_feed.php?act=recommend + api_filter.php + 用户偏好 |
首页 | ⭐⭐⭐⭐ | 待开发 |
| 2 | 📅 每日菜单规划 | api_what_to_eat.php?act=filter_apply × 3次 + eating_times.json |
工具中心 | ⭐⭐⭐ | 待开发 |
| 3 | 📱 二维码海报 | api.php?act=detail code字段 + qr_flutter库 |
菜品详情页 | ⭐⭐ | 待开发 |
| 4 | 🔗 社交分享增强 | api.php?act=detail code字段 + api_hot.php statistics |
菜品详情页 | ⭐⭐ | 待开发 |
| 5 | 🥗 食材营养详情 | api.php?act=ingredient_detail + nutrition_types.json |
食材详情页 | ⭐⭐ | ✅ v0.92.0 |
| 6 | 🔄 食材替代建议 | api_filter.php?act=filter_recipes ingredient参数 + gmy.json |
食材详情页 | ⭐⭐⭐ | ✅ v0.92.0 |
| 7 | 📈 营养目标追踪 | api.php?act=full nutrition × 多菜谱 + nutrition_types.json |
营养中心 | ⭐⭐⭐⭐ | ✅ v0.92.0 |
| 8 | 📊 运营数据大屏 | stats_full.php stats/online/request/hot |
管理后台 | ⭐⭐⭐ | ✅ v0.92.0 |
| 9 | 🔄 相关菜谱推荐 | api.php?act=list cate_id + tag_id 组合查询 |
菜品详情页 | ⭐⭐⭐ | ✅ v0.92.0 |
| 10 | 🍳 烹饪模式 | api.php?act=full content字段 + 计时器 |
菜品详情页 | ⭐⭐⭐ | 待开发 |
🔴 需后端新开发API
以下功能当前后端无对应接口，需后端开发
| # | 功能 | 建议接口 | 优先级 | 说明 | 可替代方案 |
|---|---|---|---|---|---|
| 1 | 👤 用户注册登录 | api_user.php |
P1 | 暂不开发 | — |
| 2 | 💾 收藏云端同步 | api_favorite.php |
P1 | 多设备同步 | 当前本地Hive存储 |
| 3 | 💬 评论系统 | api_comment.php |
P2 | CRUD+分页+审核 | — |
| 4 | 🔔 消息推送 | api_message.php |
P2 | 推送+站内信 | 后续可能用邮箱 |
| 5 | 📜 浏览历史同步 | api_history.php |
P2 | CRUD+分页 | 当前本地存储 |
| 6 | 📝 菜谱上传 | api_recipe.php |
P2 | 表单+图片上传+审核 | — |
| 7 | 🔍 搜索建议/补全 | api.php?act=suggest&keyword= |
P3 | 前缀匹配+热门词 | 本地搜索历史替代 |
| 8 | 📊 用户营养目标 | api_nutrition.php |
P3 | CRUD+每日统计 | 当前本地GoalSettingPage |
| 9 | 🏆 用户成就系统 | api_achievement.php |
P3 | 经验值+等级+徽章 | — |
| 10 | 📝 烹饪笔记同步 | api_note.php |
P2 | CRUD+分页 | 当前本地Hive存储 |
| 11 | 🛒 购物清单同步 | api_shopping.php |
P2 | CRUD | 当前本地存储 |
| 12 | ⏰ 每周菜单存储 | api_menu.php |
P2 | CRUD+日期范围 | 当前无持久化 |
| 13 | 🔄 相关菜谱推荐 | api.php?act=related&id= |
P2 | 基于分类+标签+食材相似度 | 可用现有API组合替代 |
🎯 推荐开发路线图
第一阶段：快速见效（1-2天/功能）
| 顺序 | 功能 | 价值 | 工作量 | API状态 |
|---|---|---|---|---|
| 1 | 🏆 评分排行榜 | 热门页增加评分排序 | 极小 | ✅已可用 |
| 2 | 🌐 IP状态显示 | 评分前显示剩余次数 | 极小 | ✅已封装 |
| 3 | 🔍 排除筛选 | 高级搜索增加排除选项 | 小 | ✅已可用 |
| 4 | 🕐 用餐时段推荐 | 根据时间智能推荐 | 小 | ✅已可用 |
| 5 | ⚠️ 过敏原警示 | 详情页安全提醒 | 小 | ✅数据已有 |
第二阶段：体验提升（3-5天/功能）
| 顺序 | 功能 | 价值 | 工作量 | API状态 |
|---|---|---|---|---|
| 6 | 📊 营养可视化 | 详情页环形图展示 | 中 | ✅数据已有 |
| 7 | 🏷️ 分类标签联动 | 筛选体验提升 | 中 | ✅已可用 |
| 8 | 🥗 食材分类浏览 | 食材浏览体验完善 | 中 | ✅已可用 |
| 9 | 🎲 筛选步骤引导 | "吃什么"体验优化 | 中 | ✅已可用 |
| 10 | 📱 迷你信息加载 | 列表页性能优化 | 中 | ✅已可用 |
第三阶段：深度功能（需后端配合或复杂逻辑）
| 顺序 | 功能 | 价值 | 工作量 | API状态 |
|---|---|---|---|---|
| 11 | 📅 每日菜单规划 | 菜单规划工具 | 大 | ✅组合可用 |
| 12 | 🏋️ 健身餐推荐 | 健康饮食功能 | 大 | ✅已可用 |
| 13 | 🧠 智能推荐 | 个性化推荐 | 大 | ✅组合可用 |
| 14 | 🔄 相关菜谱推荐 | 详情页推荐 | 中 | 🟡可组合/🔴需新API |
✅ 已完成阶段（精简记录）
阶段三十五：食材详情页闪退修复 ✅
- 🐛 setState() after dispose() 修复，4处添加mounted检查
- 🍃 CupertinoIcons.leaf→Icons.eco 修复
阶段三十四：食材详情本地缓存+缓存管理 ✅
- 🥬 IngredientModel.toJson + IngredientStatistics.toJson 序列化方法
- 💾 RecipeRepository.fetchIngredientDetail 缓存逻辑（7天有效期，优先读取本地）
- 🗑️ CacheManagePage 食材缓存管理（概览+操作+列表+左滑删除）
阶段三十三：全局UI统一（圆角/颜色/空状态/加载） ✅
- 📐 统一圆角：89处硬编码 → DesignTokens变量
- 🎨 统一颜色：20处硬编码 → DesignTokens变量
- 💎 增强EmptyState：毛玻璃卡片+图标圆形背景
- 🔄 增强LoadingIndicator：毛玻璃卡片+主题色指示器
阶段三十二：主题色全局生效修复 ✅
- 🎨 批量替换为 DesignTokens.dynamicPrimary（59个文件，439处引用）
阶段三十一：搜索功能修复与高级搜索 ✅
- 🔍 切换到global_search接口，4-Tab结果
- ⚙️ 高级搜索页面
阶段三十六：21项功能批量实现 ✅
- 🏆 评分排行榜：HotPage sort=rate排序（HotRepository+HotController+HotPage三层联动）
- 🌐 IP状态显示：菜品详情页评分前显示剩余次数
- 🔍 排除筛选：高级搜索页增加7个exclude参数筛选
- 📋 食谱子分类：分类浏览页支持子分类展开
- 🔢 编码/模糊查询：搜索页支持code和title查询
- 🕐 用餐时段推荐：MealTimeRecommendPage完善
- ⚠️ 过敏原警示：菜品详情页过敏原警告+AllergenReportPage过敏原报告
- 🏷️ 分类标签联动：高级搜索页选择分类自动加载标签
- 🎲 筛选步骤引导：WhatToEatPage 3步引导指示器
- 📊 营养可视化：NutritionRingChart环形图+热量进度条
- 📱 迷你信息加载：RecipeRepository.fetchMiniRecipe
- 🏋️ 健身餐推荐：营养中心减脂/增肌/生酮/碳水补充入口
- 📋 过敏原报告：AllergenReportPage完整报告页
- 🔎 查重检测：DuplicateCheckPage 5种查重模式
- 🎯 今天吃什么增强：筛选步骤引导+3步指示器
- 🔄 食材替代建议：IngredientDetailPage 30+食材替代映射
- 🍽️ 相似菜品推荐：RecipeSimilarSection组件
- 🍽️ 食材相关菜谱：IngredientDetailPage底部菜谱列表
- 📈 运营数据大屏：StatsDashboardPage
- 📈 数据管理中心增强：DataCenterPage新增运营大屏入口
- 🔧 代码质量：flutter analyze零错误
阶段三十：发现页口味/工艺筛选 ✅
- ✅ 口味标签筛选 / ✅ 工艺标签筛选
- ✅ 相关菜谱推荐（详情页底部）— v0.92.0实现
阶段二十九：菜品详情页功能完善 ✅
- ⭐ RecipeRating模型 + 评分展示 + 标签跳转 + 分类面包屑
阶段二十七/二十八：首页Discover瀑布流+渐进式渲染 ✅
- MasonryGridView 2列瀑布流 + 渐进式渲染+骨架屏+分页
阶段二十四：笔记+浏览记录 ✅
- 笔记标签+菜品快捷输入 + 浏览记录自动记录
阶段二十三：数据管理中心 🟡
- ✅ 数据管理中心页面 + LocalDataService
- ❌ 过敏原智能过滤
阶段十二：社交+通知增强 🟡
- ✅ 分享菜谱 + 搜索建议/热词
- ❌ 烹饪提醒通知 / ❌ 拍照记录
阶段十三：AI+规划高级功能 ✅
- AI菜谱推荐+每周菜单规划+食材用量换算+就寝提醒
📊 API接口使用状态一览
基于 API_DOC.md v3.2.0 + APP_GUIDE.md v2.9.0
✅ 已使用接口
| 接口文件 | 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 | hot(today/month/total) |
api_what_to_eat.php |
WhatToEatRepository | filter_apply/detail |
api_discover.php |
DiscoverRepository | 随机数据 |
stats_full.php |
StatsRepository+OnlineRepository | online/request/hot/heartbeat |
❌ 未使用接口（可直接调用）
| 接口 | act | 功能 | 可开发功能 |
|---|---|---|---|
api.php |
mini | 迷你版菜谱(~1KB) | 列表页性能优化 |
api_filter.php |
meal_times | 用餐时段列表 | 时段推荐 |
api_filter.php |
recipe_sub_categories | 食谱子分类 | 分类浏览增强 |
api_filter.php |
ingredient_main_categories | 食材大类 | 食材分类浏览 |
api_filter.php |
ingredient_sub_categories | 食材子分类 | 食材三级浏览 |
api_filter.php |
category_tags | 分类下标签 | 标签联动筛选 |
api_filter.php |
filter_ingredients | 食材筛选 | 高级搜索食材 |
api_filter.php |
ingredient_recipes | 食材对应菜品 | 食材详情页菜品列表 |
api_filter.php |
index | 接口索引 | 调试/接口文档 |
api_what_to_eat.php |
filter_steps | 筛选步骤引导 | "吃什么"步骤UI |
api_hot.php |
sort=rate | 评分排行 | 评分排行榜 |
api_filter.php |
exclude_*参数(7个) | 排除筛选 | 高级搜索排除选项 |
api_filter.php |
nutrition_min/max | 营养范围筛选 | 健身餐推荐 |
api_check_duplicate.php |
5种act | 查重检测 | 菜谱上传查重 |
api.php |
unified_* type=ingredient | 统一格式食材 | 食材数据标准化 |
stats_full.php |
stats layer=detail/full | 详细/完整统计 | 运营数据大屏 |
❌ 未使用静态资源
| 文件 | 数据量 | 当前使用情况 | 可开发功能 |
|---|---|---|---|
eating_times.json |
34种时段 | 仅meal_time_recommend_page直接HTTP请求 | 用餐时段推荐 |
nutrition_types.json |
31种营养(含单位) | ❌完全未使用 | 营养可视化+目标追踪 |
gmy.json |
585种过敏原(21大类) | 仅allergen_checker_page直接HTTP请求 | 过敏原警示+报告 |