cfc/docs/flows/cart-coupon-flow.md

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

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

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	删除优惠券	🖥管理后台