L.star
aa2a7ae542
Decomposed the main SearchResultView into smaller, reusable components under 'src/components/SearchResult/' to improve maintainability and scalability. - Added specific components for different result types like SummaryCard, AdditiveList, MaterialCard, and PrepackagedList. - Updated 'router/index.ts' to reflect the new structure. - Included project planning and proposal documents in 'project_document/'.
109 lines
5.2 KiB
Markdown
109 lines
5.2 KiB
Markdown
# “食话食说”APP - 视图层(Views)工作日志快照
|
||
|
||
**最后更新**: 2025-07-25 01:50:00 (UTC+8)
|
||
**目的**: 为 `shihuashishuo-ui/src/views` 目录下的所有页面组件提供一份简明扼要的功能说明和状态记录，以便于快速理解项目结构和进行后续开发。
|
||
|
||
---
|
||
|
||
## **重大更新 (2025-07-24): 目录结构重构**
|
||
|
||
为提升项目代码的可维护性和组织清晰度，对 `views` 目录进行了结构性重构。主要变更如下：
|
||
|
||
* **新增 `核心体验页/` 目录**: 用于存放用户最核心的功能路径页面，如扫码、搜索、结果展示等。
|
||
* **新增 `通用基础页/` 目录**: 用于存放非核心业务，但属于应用基础功能的页面，如登录、注册、引导页等。
|
||
* **文件迁移**: 将原 `views` 根目录下的相关文件迁移至上述两个新目录中。
|
||
|
||
---
|
||
|
||
## 1. 主要导航页面 (底部Tab栏)
|
||
|
||
这些页面是APP的一级模块，保留在 `views` 根目录下。
|
||
|
||
* **`DiscoverView-发现页.vue`**
|
||
* **用途**: 内容中心，展示食品安全、健康知识相关的文章、资讯。
|
||
* **状态**: 结构占位。
|
||
* **`KitchenView-厨房页.vue`**
|
||
* **用途**: 健康厨房模块，提供健康菜谱、饮食搭配建议。
|
||
* **状态**: 结构占位。
|
||
* **`MallView-商城页.vue`**
|
||
* **用途**: 电商模块，推荐和销售健康饮食相关商品。
|
||
* **状态**: 结构占位。
|
||
* **`MeView-我的.vue`**
|
||
* **用途**: 个人中心，管理用户资料、健康档案、设置等。
|
||
* **状态**: 结构占位。
|
||
* **`MessageView-消息列表页.vue`**
|
||
* **用途**: 展示系统通知、用户互动等消息。
|
||
* **状态**: 结构占位。
|
||
* **`CustomerServiceView-客服页.vue`**
|
||
* **用途**: 提供客服联系方式、常见问题解答。
|
||
* **状态**: **基础实现 (2025-07-25)**。
|
||
* **`AnalysisHistoryView-分析历史页.vue`**
|
||
* **用途**: 展示用户的食品分析历史记录。
|
||
* **状态**: **基础实现 (2025-07-25)**。
|
||
* **`HistoryView-搜索历史页.vue`**
|
||
* **用途**: 展示用户的搜索历史记录。
|
||
* **状态**: 结构占位。
|
||
|
||
---
|
||
|
||
## 2. 核心体验流程页面 (`核心体验页/`)
|
||
|
||
* **`HomeView-首页-2.5.vue`**
|
||
* **用途**: 应用的核心仪表盘和功能入口。集成了搜索、扫描快捷方式、每日饮食与营养追踪、内容推荐等功能。
|
||
* **状态**: **功能完善 (2025-07-25)**。UI/UX 经过多次迭代，是当前最新版本。
|
||
* **`CameraView-相机页.vue`**
|
||
* **用途**: 多功能相机视图，整合了“配料查询”（拍照/扫码）和“饮食记录”两大核心功能。是图像识别的统一入口。
|
||
* **状态**: **功能完善 (2025-07-25)**。
|
||
* **`SearchView-搜索页.vue`**
|
||
* **用途**: 搜索功能的入口页面，提供关键词输入、历史记录和热门搜索。
|
||
* **状态**: **功能完善 (2025-07-25)**。
|
||
* **`SearchResultView-搜索结果页.vue`**
|
||
* **用途**: 展示搜索结果的高级列表页。支持多Tab分类（预包装、添加剂、食谱等）和复杂的排序筛选功能。
|
||
* **状态**: **功能完善 (2025-07-25)**。
|
||
* **`ResultView-结果页.vue`**
|
||
* **用途**: 展示食品或成分的最终分析报告，包括安全/营养评级、成分解读、风险提醒和替代品推荐。
|
||
* **状态**: **功能完善 (2025-07-25)**。
|
||
* **`AddFoodView-添加饮食页.vue`**
|
||
* **用途**: 用于从饮食记录流程中，手动添加食物到特定餐次。
|
||
* **状态**: 结构占位。
|
||
* **`ScanView-扫码页.vue`**
|
||
* **用途**: (已废弃/旧版) 早期的单一功能扫码页面。
|
||
* **状态**: 其功能已被 `CameraView-相机页.vue` 完全整合和取代。
|
||
* **备份文件**:
|
||
* `HomeView-首页-2.0.backup-最简.vue`
|
||
* `HomeView-首页-2.1.backup-合并前.vue`
|
||
* `HomeView-首页-2.2.backup.vue`
|
||
* `HomeView-首页-2.3.backup.vue`
|
||
* `HomeView-首页-2.4.backup.vue`
|
||
* `SearchResultView-搜索结果页-2.0.backup.vue`
|
||
|
||
---
|
||
|
||
## 3. 通用基础页面 (`通用基础页/`)
|
||
|
||
* **`SplashView-闪屏页.vue`**
|
||
* **用途**: APP启动时的品牌展示页。
|
||
* **状态**: 基础实现。
|
||
* **`OnboardingView-引导页.vue`**
|
||
* **用途**: 用户首次打开APP时的功能介绍。
|
||
* **状态**: 结构占位。
|
||
* **`OnboardingStep-引导步骤.vue`**
|
||
* **用途**: 单个引导步骤的组件。
|
||
* **状态**: 结构占位。
|
||
* **`LoginView-登录页-2.0.vue`**
|
||
* **用途**: 用户登录/注册页面。
|
||
* **状态**: 结构占位。
|
||
* **`PasswordLoginView-密码登录页.vue`**
|
||
* **用途**: 提供密码登录方式。
|
||
* **状态**: 结构占位。
|
||
* **`ForgotPasswordView-忘记密码页.vue`**
|
||
* **用途**: 找回密码流程页面。
|
||
* **状态**: 结构占位。
|
||
* **`ThirdPartyAuthView-授权登录页.vue`**
|
||
* **用途**: 处理第三方账号（如微信、QQ）授权登录。
|
||
* **状态**: 结构占位。
|
||
* **`PolicyView-协议页.vue`**
|
||
* **用途**: 展示用户协议和隐私政策。
|
||
* **状态**: 结构占位。
|
||
* **备份文件**:
|
||
* `LoginView-登录页-1.0.backup.vue` |