medical-mall/pages/mall/consumer/doc/FEATURES_&_PAGES.md

功能与页面状态详解

本文档详细记录了 Consumer App 各个功能模块的实现状态与业务逻辑。

状态图例: ✅ 正常 (已对接真实 DB) | 🚧 开发中 | ❌ 未开始

🛍️ 核心购物流程

功能模块	页面路径	状态	备注
首页	pages/mall/consumer/index.uvue	✅ 正常	金刚区、Banner、推荐商品流。
分类	pages/mall/consumer/category.uvue	✅ 正常	一级/二级分类联动，跳转搜索结果。
商品详情	pages/mall/consumer/product-detail.uvue	✅ 正常	SKU 选择、加入购物车、立即购买。
购物车	pages/mall/consumer/cart.uvue	✅ 正常	数量增减、勾选计算、结算校验。
结算页	pages/mall/consumer/checkout.uvue	✅ 正常	选择地址、运费计算、创建订单。
收银台	pages/mall/consumer/payment.uvue	✅ 正常	模拟支付流程，更新订单为“待发货”。

👤 个人中心 (Profile)

文件: pages/mall/consumer/profile.uvue

• 资产看板: 实时加载积分、余额、优惠券数量。
• 订单看板: 待支付、待发货、待收货、退款/售后（跳转至 refund.uvue）。
• 服务矩阵:
  • 地址管理: address-list.uvue (CRUD 正常)
  • 我的收藏: favorites.uvue (商品/店铺收藏 正常)
  • 浏览足迹: footprint.uvue (按日期分组 正常)
  • 在线客服: 跳转至 chat.uvue
  • 消息通知: 跳转至 messages.uvue

📦 订单管理体系

列表页: pages/mall/consumer/orders.uvue

• 状态筛选: 全部 / 待支付 / 待发货 / 待收货 / 已完成。
• 核心操作:
  • 去支付: 跳转收银台。
  • 确认收货: 变更状态为已完成。
  • 申请售后: 跳转 apply-refund.uvue (带入订单信息)。

详情页: pages/mall/consumer/order-detail.uvue

• 信息展示: 完整的地址、商品规格、金额明细、时间线。
• 业务状态: 根据 order_status 动态展示可操作按钮。

🔄 售后服务体系 (Refunds)

申请页: pages/mall/consumer/apply-refund.uvue

• 功能: 支持仅退款/退货退款。
• 逻辑: 自动获取订单最大可退金额，防止超额申请。
• 提交: 数据写入 ml_refunds 表。

记录页: pages/mall/consumer/refund.uvue

• 列表: 展示所有历史售后申请及其当前状态。
• 进度: 可视化展示审核进度 (目前模拟进度条)。

💬 社交与互动

功能模块	页面路径	状态	说明
在线客服	pages/mall/consumer/chat.uvue	✅ 正常	支持文本/表情发送，历史记录持久化。
消息中心	pages/mall/consumer/messages.uvue	✅ 正常	聚合系统通知订单消息与客服消息。
商品评价	pages/mall/consumer/review.uvue	✅ 正常	支持星级评分与文本评价。