consumer模块完成90%，前端完成supabase对接

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

@@ -0,0 +1,62 @@
+# 功能与页面状态详解
+
+本文档详细记录了 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` | ✅ 正常 | 支持星级评分与文本评价。 |
+