graph TD
A[开始] --> B[商品管理模块]
%% 商品管理
B --> B1[创建商品分类✅]
B --> B2[创建商品✅]
B2 --> B21[第一步: 商品信息✅]
B21 --> B22[第二步: 商品属性✅]
B22 --> B23[第三步: 提交商品✅]
%% 拼团活动
B23 --> C[拼团活动模块]
C --> C1[拼团活动列表✅]
C --> C2[创建拼团活动✅]
C2 --> C3[设置活动商品全流程✅]
C3 --> C31[获取活动商品✅]
C3 --> C32[添加商品到活动✅]
C3 --> C33[移除商品✅]
%% 订单管理
C32 --> D[订单管理模块]
D --> D1[订单列表查询✅]
D --> D2[订单详情查询✅]
D2 --> D3[订单轨迹✅]
D2 --> D4[基本信息✅]
D2 --> D5[商品信息✅]
D2 --> D6[收货信息✅]
D2 --> D7[拼团信息✅]
%% 订单操作
D --> E[订单操作模块]
E --> E1[取消订单⚠️<br/>仅未付款]
E --> E2[全部退款⚠️<br/>状态未确定]
E --> E3[导出订单⚠️<br/>字段待确认]
E --> E4[导出发货单⚠️<br/>字段待确认]
E --> E5[单个订单发货✅]
%% 批量发货需求
E --> F[批量发货需求❌]
F --> F1[导入发货单❌<br/>功能未确定]
F --> F2[批量发货❌<br/>功能未确定]
F --> F3[下载失败发货单❌<br/>功能未确定]
%% 样式
classDef implemented fill:#e8f5e8,stroke:#1b5e20,stroke-width:2px
classDef notImplemented fill:#ffebee,stroke:#b71c1c,stroke-width:2px
classDef uncertain fill:#fff3e0,stroke:#e65100,stroke-width:2px
class B1,B2,B21,B22,B23,C1,C2,C3,C31,C32,C33,D1,D2,D3,D4,D5,D6,D7,E5 implemented
class F,F1,F2,F3 notImplemented
class E1,E2,E3,E4 uncertain
模块 | 功能 | 接口 | 方法 | 关键参数 | 状态 |
---|---|---|---|---|---|
商品管理 | 创建商品分类 | mall/category |
POST | {name, parentId, sort, status} |
✅ |
商品管理 | 创建商品 | mall/product |
POST | {cateId, storeName, price, stock} |
✅ |
拼团活动 | 活动列表 | mall/flash/activity/list |
POST | {page, size, status} |
✅ |
拼团活动 | 创建活动 | mall/flash/activity |
POST | {name, startTime, endTime, content} |
✅ |
拼团活动 | 获取活动商品 | mall/combination/getActivityProductIds |
GET | {activityId} |
✅ |
拼团活动 | 添加商品 | mall/combination/addActivityProduct |
POST | {activityId, productId, groupPrice} |
✅ |
拼团活动 | 移除商品 | mall/combination/removeActivityProduct |
POST | {activityId, productId} |
✅ |
订单管理 | 订单列表 | mall/order/list |
POST | {page, size, status, orderId} |
✅ |
订单管理 | 订单详情 | mall/order/detail |
GET | {id} |
✅ |
订单管理 | 拼团信息 | mall/pink/orderPink |
GET | {id} |
✅ |
订单操作 | 取消订单 | mall/order/cancel |
POST | {id} |
✅ (仅未付款) |
订单操作 | 全部退款 | mall/order/refund |
POST | {id} |
✅ (状态未确定) |
订单操作 | 导出订单 | mall/order/export |
GET | {status, startTime, endTime} |
✅ (字段待确认) |
订单操作 | 导出发货单 | mall/order/export |
GET | {status: 5, format: "delivery"} |
✅ (字段待确认) |
订单操作 | 导入发货单 | shop/admin/order/order/dispatch |
POST | FormData: {action, express, file} |
❌ (未确定) |
订单操作 | 批量发货 | mall/order/batchDelivery |
POST | {order_ids, action} |
❌ (未确定) |
订单操作 | 单个发货 | mall/order/batchDelivery |
POST | {order_id, order_item_ids, action, express} |
✅ |
mall/category
POST
请求参数:
{
"name": "分类名称",
"parentId": "父分类ID",
"sort": "排序",
"status": "状态"
}
包含字段:
{
"cateId": "商品分类ID",
"storeName": "商品名称",
"keyword": "副标题",
"image": "商品主图"
}
包含字段:
{
"price": "商品价格",
"otPrice": "原价",
"stock": "库存",
"spec": "规格信息",
"attr": "属性信息"
}
mall/product
POST
{
"id": "",
"cateId": "6",
"storeName": "测试商品",
"keyword": "测试标题",
"itemBrand": "测试品牌",
"storeInfo": "测试介绍",
"itemNumber": "",
"price": "",
"otPrice": "",
"stock": "",
"stockThreshold": "",
"isShow": 0,
"itemSupplier": "测试供应商",
"sort": 0,
"cost": "",
"vipPrice": "",
"image": "http://124.220.229.80:9098/img/2025/08/18/201003a5e06841bdbb5b40444e12c29d.png",
"sliderImage": "http://124.220.229.80:9098/img/2025/08/18/25c2af8679a54f29b0d96de4ffca6b30.png",
"flatPattern": "http://124.220.229.80:9098/img/2025/08/18/8a23f3e53bc34069b7d20a80d29f26d8.png",
"specType": 1,
"skus": [
{
"id": 0,
"temp_id": 1,
"name": "颜色",
"batchId": "",
"pid": 0,
"children": [
{
"id": 0,
"temp_id": 1,
"name": "红色",
"pid": 0,
"imageList": [
"http://124.220.229.80:9098/img/2025/08/18/6b7a540642694495b247bf96384ff078.png"
]
},
{
"id": 0,
"temp_id": 2,
"name": "蓝色",
"pid": 0,
"imageList": [
"http://124.220.229.80:9098/img/2025/08/18/c006f84a33bc47d09cb6c5fa713c937f.png"
]
}
]
},
{
"id": 0,
"temp_id": 4,
"name": "尺寸",
"batchId": "",
"pid": 0,
"children": [
{
"id": 0,
"temp_id": 3,
"name": "S",
"pid": 0,
"imageList": []
},
{
"id": 0,
"temp_id": 4,
"name": "M",
"pid": 0,
"imageList": []
}
]
}
],
"sku_prices": [
{
"id": 0,
"temp_id": 1,
"goods_sku_ids": "",
"goods_id": 0,
"weigh": 0,
"image": "",
"imageList": [],
"stock": "50",
"stockThreshold": 0,
"price": "10",
"otPrice": "20",
"skuCode": "",
"goods_sku_text": ["红色", "S"],
"goods_sku_temp_ids": [1, 3]
}
],
"attrValue": [
{
"id": 0,
"image": "",
"price": "10",
"otPrice": "20",
"stock": "50",
"skuCode": "",
"stockThreshold": 0,
"attrValue": "{\"颜色\":\"红色\",\"尺寸\":\"S\"}",
"颜色": "红色",
"尺寸": "S",
"productId": 0
}
],
"attr": [
{
"id": 0,
"attrName": "颜色",
"attrValues": "红色,蓝色",
"attrImgValues": [
{
"name": "红色",
"img": "http://124.220.229.80:9098/img/2025/08/18/6b7a540642694495b247bf96384ff078.png"
},
{
"name": "蓝色",
"img": "http://124.220.229.80:9098/img/2025/08/18/c006f84a33bc47d09cb6c5fa713c937f.png"
}
]
},
{
"id": 0,
"attrName": "尺寸",
"attrValues": "S,M",
"attrImgValues": [
{
"name": "S",
"img": ""
},
{
"name": "M",
"img": ""
}
]
}
]
}
mall/flash/activity/list
POST
请求参数:
{
"page": "页码",
"size": "每页数量",
"status": "活动状态(0:待开始, 1:进行中, 2:已结束)"
}
功能说明: 支持按状态筛选(全部、待开始、进行中、已结束)
mall/flash/activity
POST
请求参数:
{
"name": "活动名称",
"startTime": "开始时间",
"endTime": "结束时间",
"content": {
"groupNumber": "成团默认人数",
"countdownTime": "开团倒计时结束时间"
}
}
mall/combination/getActivityProductIds
GET
{activityId: "活动ID"}
mall/combination/addActivityProduct
POST
请求参数:
{
"activityId": "活动ID",
"productId": "商品ID",
"groupPrice": "拼团价格",
"groupNumber": "成团人数"
}
mall/combination/removeActivityProduct
POST
{activityId: "活动ID", productId: "商品ID"}
mall/order/list
POST
请求参数:
{
"page": "页码",
"size": "每页数量",
"status": "订单状态",
"orderId": "订单ID",
"userPhone": "用户手机号",
"startTime": "开始时间",
"endTime": "结束时间"
}
mall/order/detail
GET
请求参数:
{
"id": "订单ID"
}
数据结构:
{
"orderStatusVO": [
{
"status": "状态码",
"statusText": "状态文本",
"createTime": "创建时间"
}
]
}
数据结构:
{
"orderId": "订单编号",
"status": "订单状态",
"pinkStatus": "拼团状态",
"totalPrice": "全部金额",
"payTime": "支付时间",
"createTime": "创建时间"
}
数据结构:
{
"productName": "商品名称",
"productImage": "商品图片",
"price": "商品价格",
"num": "购买数量",
"totalPrice": "总价"
}
数据结构:
{
"realName": "收货人姓名",
"userPhone": "收货人电话",
"userAddress": "收货地址",
"mark": "备注"
}
mall/pink/orderPink
GET
请求参数:
{
"id": "订单ID"
}
mall/order/cancel
POST
请求参数:
{
"id": "订单ID(逗号分隔)"
}
状态限制: ⚠️ 只有用户未付款的订单可以取消
mall/order/refund
POST
请求参数:
{
"id": "订单ID(逗号分隔)"
}
状态限制: ❓ 退款按钮执行状态未确定
mall/order/export
GET
请求参数:
{
"status": "订单状态",
"startTime": "开始时间",
"endTime": "结束时间"
}
注意事项: ❓ 后端Excel表格字段是否符合产品要求未确定,目前只是能导出Excel表格
mall/order/export
GET
请求参数:
{
"status": 5,
"format": "delivery"
}
注意事项: ❓ 后端Excel表格字段是否符合产品要求未确定,目前只是能导出Excel表格
shop/admin/order/order/dispatch
POST
multipart/form-data
请求参数:
{
"action": "multiple",
"express": {
"name": "快递公司名称",
"code": "快递公司代码"
},
"file": "Excel文件"
}
mall/order/batchDelivery
POST
请求参数:
{
"order_ids": ["订单ID数组"],
"action": "multiple"
}
mall/order/batchDelivery
POST
请求参数:
{
"order_id": "订单ID",
"order_item_ids": ["订单项ID数组"],
"action": "confirm",
"express": {
"name": "快递公司名称",
"code": "快递公司代码",
"no": "快递单号"
}
}
功能说明: 简单的单个订单发货功能,更新订单状态为已发货
shop/admin/order/order/dispatch
mall/order/batchDelivery
导入发货单功能
shop/admin/order/order/dispatch
批量发货接口对接
mall/order/batchDelivery
失败Excel导出
失败原因标注
导入发货单时,有失败的订单会返回失败的Excel表格链接,并且标注失败原因
本文档基于当前代码分析生成,实际实现状态以最新代码为准。