# 2 商城控制器

## 2.1 订单列表

用于返回订单列表

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/shop/order-list|

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|ID|string|ID|
|USER_ID|string|会员ID|
|BE_USER_NAME|string|会员编号|
|DEC_USER_NAME|string|报单会员|
|DEC_AMOUNT|string|报单金额|
|DEC_PV|string|报单PV|
|CREATED_AT|string|创建时间|


## 2.2 报单套餐列表

用于返回套餐列表

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/shop/package|

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|ID|string|ID|
|LEVEL_ID|string|所属报单级别ID|
|LEVEL_NAME|string|所属报单级别名称|
|PACKAGE_NAME|string|套餐名称|
|AMOUNT|string|报单套餐金额|
|PV|string|报单套餐PV|
|PACKAGE_CONTENT|string|套餐内容|
|CREATED_AT|string|创建时间|

## 2.3 添加报单套餐

用于管理员添加报单套餐

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|POST|/shop/package-add|


### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|id|string|是||套餐id||
|packageName|string|是||套餐名称||
|amount|string|是||套餐金额||
|amountPv|string|是||套餐PV||
|levelId|string|是||报单级别ID||
|packageContent|string|是||套餐内容||

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|报单套餐添加成功|


## 2.4 套餐详情
用于返回套餐详情

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET,POST|/shop/package-get|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|id|string|否| |套餐ID||

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|ID|string|套餐ID|
|packageName|string|套餐名称|
|levelId|string|报单级别ID|
|packageContent|string|套餐内容|
|amount|string|套餐金额|
|amountPv|string|套餐PV|


## 2.5 商品列表
用于返回商品列表

### 请求地址
|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET|/shop/index|

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|ID|string|ID|
|GOODS_NAME|string|商品名称|
|TYPE_NAME|string|商品类型|
|SELL_TYPE_NAME|string|出售方式|
|SELL_PRICE|string|商品价格|
|PRICE_PV|string|价格PV|
|STORE_NUMS|string|库存|
|STATUS|string|状态|
|CREATED_AT|string|创建时间|

## 2.6 商品添加
用于添加商品

### 请求地址
|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|POST|/shop/goods-add|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|goodsName|string|是||商品名称||
|type|string|是||商品类型||
|sellType|string|是||出售方式||
|goodsNo|string|是||商品编号||
|unit|string|否||单位||
|cover|string|是||封面图片|
|marketPrice|string|是||市场价格|
|sellPrice|string|是||销售价格|
|pricePv|string|是||价格PV|
|storeNums|string|是||库存|
|content|string|否||商品详情|
|sort|string|是||排序|

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|商品添加成功|


## 2.7 商品编辑
用于编辑商品

### 请求地址
|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET,POST|/shop/goods-edit|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|id|string|是||商品id||
|goodsName|string|是||商品名称||
|type|string|是||商品类型||
|sellType|string|是||出售方式||
|goodsNo|string|是||商品编号||
|unit|string|否||单位||
|cover|string|是||封面图片|
|marketPrice|number|是||市场价格|
|sellPrice|number|是||销售价格|
|pricePv|number|是||价格PV|
|storeNums|number|是||库存|
|content|string|否||商品详情|
|sort|number|是||排序|

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|商品编辑成功|

## 2.8 商品删除
用于删除商品

### 请求地址
|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET,POST|/shop/goods-delete|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|selected|string|是||商品id||

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|商品删除成功|


## 2.9 商品上下架
用于上下架商品

### 请求地址
|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|POST|/shop/goods-status|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|selectedIds|string|是||商品id||
|status|string|是||上架 1 下架 0||

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|message|string|商品操作成功|


## 2.10 商品图片上传

用于商品图片上传

### 请求地址

|环境|方法|路径|
|:---:|:---:|:---:|
|本机环境|GET,POST,PUT|/shop/upload|

### 请求参数
|参数|类型|是否必填|最大长度|描述|示例|
|:---:|:---:|:---:|:---:|:---:|:---:|
|uploadToken|string|是|32|上传TOken| |
|file||是||文件| |

### 响应参数
|参数|类型|描述|
|:---|:---|:---|
|addImagesTips|string|上传成功|