# 用户使用流程图 — 购物车与优惠券

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

```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[📱 添加购物车 /cart/add]:::portMiniApp
        A2 --> A3[📱 获取购物车列表 /cart/list]:::portMiniApp
        A3 --> A4[📱 更新数量 /cart/update]:::portMiniApp
        A4 --> A5[📱 移除商品 /cart/remove]:::portMiniApp
        A5 --> A6[📱 获取数量 /cart/count]:::portMiniApp
    end

    subgraph 优惠券
        A6 --> B1[📱 获取可用优惠券 /coupon/list]:::portMiniApp
        B1 --> B2[📱 领取优惠券 /coupon/claim]:::portMiniApp
        B2 --> B3[📱 应用优惠券 /coupon/apply]:::portMiniApp
    end

    subgraph 管理员优惠券
        B3 --> C1[🖥 优惠券列表 /admin/coupon/list]:::portAdmin
        C1 --> C2[🖥 创建优惠券 /admin/coupon/create]:::portAdmin
        C2 --> C3[🖥 更新 /admin/coupon/update]:::portAdmin
        C3 --> C4[🖥 发放 /admin/coupon/issue]:::portAdmin
        C4 --> C5[🖥 删除 /admin/coupon/delete]:::portAdmin
    end

    R1(("👤 用户")):::actor
    R2(("🔧 管理员")):::role

    A1 -.- R1
    C1 -.- R2
```

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/cart/add` | 添加购物车 | 📱小程序 |
| `/api/cart/list` | 购物车列表 | 📱小程序 |
| `/api/cart/update` | 更新购物车 | 📱小程序 |
| `/api/cart/remove` | 移除商品 | 📱小程序 |
| `/api/cart/count` | 购物车数量 | 📱小程序 |
| `/api/coupon/list` | 优惠券列表 | 📱小程序 |
| `/api/coupon/claim` | 领取优惠券 | 📱小程序 |
| `/api/coupon/apply` | 应用优惠券 | 📱小程序 |
| `/api/admin/coupon/list` | 管理优惠券列表 | 🖥管理后台 |
| `/api/admin/coupon/create` | 创建优惠券 | 🖥管理后台 |
| `/api/admin/coupon/update` | 更新优惠券 | 🖥管理后台 |
| `/api/admin/coupon/issue` | 发放优惠券 | 🖥管理后台 |
| `/api/admin/coupon/delete` | 删除优惠券 | 🖥管理后台 |