298 lines
16 KiB
Markdown
298 lines
16 KiB
Markdown
# 📋 未完成功能清单
|
||
|
||
> 创建: 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）
|
||
- 迷你卡片数据自动刷新策略
|