cfc/docs/flows/shop-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[📱 获取商品分类 /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	活动二维码	🖥管理后台