16 KiB
16 KiB
📋 未完成功能清单
创建: 2026-04-09 | 更新: 2026-04-14 v0.92.6 | 优先级: 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% |
| 三十七 | 目录结构整理+导入路径修复 | 8 | 8 | 100% |
| 三十八 | UI布局优化+缓存修复 | 4 | 4 | 100% |
| 合计 | 232 | 222 | 96% |
🔴 未完成任务汇总
按优先级排序，仅列出未完成任务
| 序号 | 阶段 | 任务 | 优先级 | 优先级值 | 说明 |
|---|---|---|---|---|---|
| 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 |
✅ 已完成阶段（精简记录）
阶段三十六：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零错误
阶段三十七：目录结构整理+导入路径修复 ✅
- 📁 lib/src目录重组：每个文件夹≤8文件，按功能分子目录
- 🔧 导入路径更新：批量更新import路径适配新目录结构
- 🧹 BOM字符清理：72个Dart文件移除UTF-8 BOM (U+FEFF)
- 🐛 类型错误修复：ShoppingItemModel/MealRecordModel类型匹配
- 🧹 未使用代码清理：移除未使用的导入和字段
- 📊 flutter analyze：解决所有critical错误
- 🔄 路由参数修复：CategoryModel类型转换问题修复
- 📝 文档更新：同步目录结构变更
阶段三十八：UI布局优化+缓存修复 ✅
- 📱 收藏页面网格布局：GridView 2列卡片展示
- 🛠️ 工具中心增强：新增"使用工具"按钮直接打开工具功能
- 💾 食材缓存修复：CacheService键名匹配问题修复
- 🔗 缓存管理页面跳转修复：正确跳转到食材详情页
阶段三十：发现页口味/工艺筛选 ✅
- ✅ 口味标签筛选 / ✅ 工艺标签筛选
- ✅ 相关菜谱推荐（详情页底部）— v0.92.0实现
阶段二十九：菜品详情页功能完善 ✅
- ⭐ RecipeRating模型 + 评分展示 + 标签跳转 + 分类面包屑
阶段二十七/二十八：首页Discover瀑布流+渐进式渲染 ✅
- MasonryGridView 2列瀑布流 + 渐进式渲染+骨架屏+分页
阶段二十四：笔记+浏览记录 ✅
- 笔记标签+菜品快捷输入 + 浏览记录自动记录
阶段二十三：数据管理中心 🟡
- ✅ 数据管理中心页面 + LocalDataService
- ❌ 过敏原智能过滤
阶段十二：社交+通知增强 🟡
- ✅ 分享菜谱 + 搜索建议/热词
- ❌ 烹饪提醒通知 / ❌ 拍照记录
阶段十三：AI+规划高级功能 ✅
- AI菜谱推荐+每周菜单规划+食材用量换算+就寝提醒
📊 API接口使用状态一览
基于 API_DOC.md v3.2.0 + APP_GUIDE.md v2.9.0，更新于 v0.92.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/mini |
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/meal_times/recipe_sub_categories/ingredient_main_categories/ingredient_sub_categories/category_tags/filter_ingredients/ingredient_recipes |
api_hot.php |
HotRepository | hot(today/month/total) sort=view/like/rate |
api_what_to_eat.php |
WhatToEatRepository | filter_apply/detail/filter_steps |
api_discover.php |
DiscoverRepository | 随机数据 |
api_check_duplicate.php |
RecipeRepository | check_title/check_ingredient/check_step/check_content/check_all |
stats_full.php |
StatsRepository+OnlineRepository | online/request/hot/stats/heartbeat |
| 静态数据 | 各页面 | eating_times.json(✅)/nutrition_types.json(✅)/gmy.json(✅) |
🔴 未使用接口（待开发）
| 接口 | act | 功能 | 可开发功能 |
|---|---|---|---|
api.php |
unified_* type=ingredient | 统一格式食材 | 食材数据标准化 |
🃏 阶段三十九：迷你卡片功能（v0.92.8）
✅ 已完成
- 🃏 迷你卡片页面（Tinder风格左右滑动浏览菜品）
- 📂 数据模型 MiniCardModel（341道菜，11个分类）
- 🔍 分类筛选+搜索+网格视图
- ❤️ 收藏集成+喜欢/不喜欢记录
- 💾 本地缓存5-10条记录（SharedPreferences）
- 🗑️ 缓存管理页面新增迷你卡片缓存清理
- 🖼️ 图片独立组件 _MiniCardImageView，文本在图片内底部展示
- 🪟 液态玻璃效果（顶部操作栏+底部信息区 GlassContainer）
- 📱 全屏图片查看器（PageView+异步预加载5张相邻图片）
- 📤 分享按钮（share_plus，分享菜品信息+图片URL）
- 💾 缓存优先加载（查看过的卡片存入缓存，先显示缓存再内部加载）
- 🏠 首页瀑布流插入迷你卡片（1:20比例，全宽横幅）
- 每20个瀑布流item后插入1个迷你卡片横幅
- MiniCardDiscoverCard 组件：液态玻璃+全宽图片+分类标签
- SliverMainAxisGroup 分组渲染
- 🔗 路由参数支持（initialRecipeId，从首页跳转到指定卡片）
- 🔄 MiniCardService 独立数据服务（缓存优先，多页面复用）
🟡 待开发：迷你卡片交互增强
优先级：P3（增强功能）| 优先级值：3 工作量：⭐⭐（低）
- 迷你卡片横幅支持横向滑动预览多个菜品
- 迷你卡片瀑布流插入比例可配置（当前固定1:20）
- 迷你卡片数据自动刷新策略