# 功能与页面状态详解

本文档详细记录了 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` | ✅ 正常 | 支持星级评分与文本评价。 |