# 用户使用流程图 — 商城交易

> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动

```mermaid
flowchart TD
    %% ============ 颜色定义 ============
    classDef actor fill:#e1f5fe,stroke:#0288d1,stroke-width:2px
    classDef action fill:#fff3e0,stroke:#f57c00,stroke-width:1px
    classDef system fill:#e8f5e9,stroke:#388e3c,stroke-width:1px
    classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
    classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
    classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2

    subgraph 商品浏览
        A1(("👤 用户")):::portMiniApp --> A2[📱 获取商品分类 /category/tree]:::portMiniApp
        A2 --> A3[📱 查看分类商品 /category/products]:::portMiniApp
        A3 --> A4[📱 获取商品列表 /list]:::portMiniApp
        A4 --> A5[📱 获取商品详情 /detail]:::portMiniApp
        A5 --> A6[📱 获取规格映射 /spec/map]:::portMiniApp
    end

    subgraph 购物车
        A6 --> B1[📱 添加购物车 /cart/add]:::portMiniApp
        B1 --> B2[📱 获取购物车列表 /cart/list]:::portMiniApp
        B2 --> B3[📱 更新购物车 /cart/update]:::portMiniApp
        B3 --> B4[📱 移除商品 /cart/remove]:::portMiniApp
        B4 --> B5[📱 获取购物车数量 /cart/count]:::portMiniApp
    end

    subgraph 下单支付
        B5 --> C1[📱 创建订单 /product/order/create]:::portMiniApp
        C1 --> C2[📱 支付 /product/order/pay]:::portMiniApp
        C2 --> C3[⚙️ 支付回调 /product/order/notify]:::portSystem
        C3 --> C4[⚙️ 处理支付成功 /handlePaymentSuccess]:::portSystem
    end

    subgraph 订单管理
        C4 --> D1[📱 获取我的订单 /my]:::portMiniApp
        D1 --> D2[📱 订单数量统计 /my/counts]:::portMiniApp
        D2 --> D3[📱 订单详情 /detail]:::portMiniApp
        D3 --> D4{📱 订单状态}:::portMiniApp
        D4 -->|待发货| D5[📱 取消订单 /cancel]:::portMiniApp
        D4 -->|已发货| D6[📱 确认收货 /confirm]:::portMiniApp
        D4 -->|待退款| D7[📱 申请退款 /refund/apply]:::portMiniApp
    end

    subgraph 商家发货
        D6 --> E1[🖥 商家发货 /ship]:::portAdmin
        E1 --> E2[📱 查询物流 /logistics/query]:::portMiniApp
    end

    subgraph 售后
        D7 --> F1[📱 创建售后 /after-sales/create]:::portMiniApp
        F1 --> F2[📱 售后列表 /after-sales/list]:::portMiniApp
        F2 --> F3[📱 售后详情 /after-sales/detail]:::portMiniApp
    end

    subgraph 评价
        D6 --> G1[📱 发表评价 /review/order]:::portMiniApp
        G1 --> G2[📱 评价详情 /review/order/detail]:::portMiniApp
        G2 --> G3[📱 评价状态 /review/order/status]:::portMiniApp
    end

    subgraph 收货地址
        G3 --> H1[📱 地址列表 /consignee/list]:::portMiniApp
        H1 --> H2[📱 添加地址 /consignee/save]:::portMiniApp
        H2 --> H3[📱 地址详情 /consignee/detail]:::portMiniApp
        H3 --> H4[📱 删除地址 /consignee/delete]:::portMiniApp
    end

    R1(("👤 用户")):::actor
    R2(("🏪 商家")):::role
    R3(("💳 支付")):::system

    A1 -.- R1
    E1 -.- R2
    C2 -.- R3
```

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/product/list` | 商品列表 | 📱小程序 |
| `/api/product/detail` | 商品详情 | 📱小程序 |
| `/api/product/spec/map` | 规格映射 | 📱小程序 |
| `/api/product/order/create` | 创建订单 | 📱小程序 |
| `/api/product/order/pay` | 支付 | 📱小程序 |
| `/api/product/order/cancel` | 取消订单 | 📱小程序 |
| `/api/product/order/my` | 我的订单 | 📱小程序 |
| `/api/product/order/my/counts` | 订单数量统计 | 📱小程序 |
| `/api/product/order/detail` | 订单详情 | 📱小程序 |
| `/api/product/order/confirm` | 确认收货 | 📱小程序 |
| `/api/product/order/refund/apply` | 申请退款 | 📱小程序 |
| `/api/cart/add` | 添加购物车 | 📱小程序 |
| `/api/cart/list` | 购物车列表 | 📱小程序 |
| `/api/cart/update` | 更新购物车 | 📱小程序 |
| `/api/cart/remove` | 移除商品 | 📱小程序 |
| `/api/cart/count` | 购物车数量 | 📱小程序 |
| `/api/shop/category/tree` | 分类树 | 📱小程序 |
| `/api/shop/category/products` | 分类商品 | 📱小程序 |
| `/api/shop/after-sales/create` | 创建售后 | 📱小程序 |
| `/api/shop/after-sales/list` | 售后列表 | 📱小程序 |
| `/api/shop/after-sales/detail` | 售后详情 | 📱小程序 |
| `/api/shop/logistics/query` | 查询物流 | 📱小程序 |
| `/api/review/order` | 发表评价 | 📱小程序 |
| `/api/review/order/detail` | 评价详情 | 📱小程序 |
| `/api/review/order/status` | 评价状态 | 📱小程序 |
| `/api/consignee/list` | 地址列表 | 📱小程序 |
| `/api/consignee/save` | 添加/保存地址 | 📱小程序 |
| `/api/consignee/detail` | 地址详情 | 📱小程序 |
| `/api/consignee/delete` | 删除地址 | 📱小程序 |
| `/api/product/create` | 创建商品 | 🖥管理后台 |
| `/api/product/update` | 更新商品 | 🖥管理后台 |
| `/api/product/my` | 我的商品 | 🖥管理后台 |
| `/api/product/shelve` | 上下架 | 🖥管理后台 |
| `/api/product/images/update` | 更新图片 | 🖥管理后台 |
| `/api/product/order/vendor` | 商家订单 | 🖥管理后台 |
| `/api/product/order/ship` | 发货 | 🖥管理后台 |
| `/api/product/order/handlePaymentSuccess` | 处理支付成功 | ⚙️系统自动 |
| `/api/product/order/notify` | 支付回调 | ⚙️系统自动 |
| `/api/product/order/activity/audit` | 活动审核 | 🖥管理后台 |
| `/api/product/order/activity/sign-in` | 活动签到 | 🖥管理后台 |
| `/api/product/order/activity/complete` | 活动完成 | 🖥管理后台 |
| `/api/product/order/activity/provision` | 活动供应 | 🖥管理后台 |
| `/api/product/order/activity/qr-image` | 活动二维码 | 🖥管理后台 |