feat: 新增商品选择列表接口 simple-list(订单创建用)
这个提交包含在:
父节点
e4eb430901
当前提交
666ce6030a
@ -0,0 +1,108 @@
|
||||
# 接口变更记录 — 2026-04-14
|
||||
|
||||
> **变更类型**:新增接口 + 废弃旧接口
|
||||
> **影响模块**:订单创建 → 选择商品弹窗
|
||||
> **在线文档**:
|
||||
> - 局域网:http://192.168.100.236:8080/doc.html → `1. 管理端 - 产品管理`
|
||||
> - 公网:https://api.test.1814.love:9443/doc.html(需认证)
|
||||
|
||||
---
|
||||
|
||||
## 新增「商品选择列表」接口(订单创建用)
|
||||
|
||||
订单创建时「选择商品」弹窗原来调的是 `GET /admin/order/product/page`(404,后端从未实现)。现在由产品服务提供专用轻量接口。
|
||||
|
||||
### 旧接口(废弃,404)
|
||||
|
||||
```
|
||||
GET /admin/order/product/page ← 删掉,不要再调
|
||||
```
|
||||
|
||||
### 新接口
|
||||
|
||||
```
|
||||
GET /admin/product/item/simple-list
|
||||
```
|
||||
|
||||
### 请求参数
|
||||
|
||||
| 参数 | 类型 | 必填 | 说明 |
|
||||
|------|------|------|------|
|
||||
| keyword | String | 否 | 搜索关键词(匹配产品名称) |
|
||||
| pageNo | Integer | 否 | 页码,默认1 |
|
||||
| pageSize | Integer | 否 | 每页条数,默认50 |
|
||||
|
||||
> 不需要传 productType / status 等参数,后端固定只返回**已上架**产品。
|
||||
|
||||
### 响应字段
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| productId | Long | 产品ID |
|
||||
| productNo | String | 产品编号(如 C260409001) |
|
||||
| name | String | 产品名称 |
|
||||
| tripDays | Integer | 行程天数 |
|
||||
| lineName | String | 产品线名称(LEFT JOIN 查出) |
|
||||
|
||||
### 响应示例
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "成功",
|
||||
"data": {
|
||||
"records": [
|
||||
{
|
||||
"productId": 2043895196659171329,
|
||||
"productNo": "C260409001",
|
||||
"name": "呼伦贝尔5日深度游",
|
||||
"tripDays": 5,
|
||||
"lineName": "呼伦贝尔经典线"
|
||||
}
|
||||
],
|
||||
"total": 12,
|
||||
"page": 1,
|
||||
"pageSize": 50
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 前端改动清单
|
||||
|
||||
**文件**:`src/api/order.js` 第555-556行
|
||||
|
||||
```javascript
|
||||
// 旧
|
||||
export function getOrderProductPage(params) {
|
||||
return http.get('/order/product/page', params)
|
||||
}
|
||||
|
||||
// 新
|
||||
export function getOrderProductPage(params) {
|
||||
return http.get('/product/item/simple-list', params)
|
||||
}
|
||||
```
|
||||
|
||||
**参数名映射**(需同步修改调用处):
|
||||
|
||||
| 旧参数 | 新参数 |
|
||||
|--------|--------|
|
||||
| name | keyword |
|
||||
| page | pageNo |
|
||||
| limit | pageSize |
|
||||
|
||||
**响应字段映射**(需同步修改弹窗组件):
|
||||
|
||||
| 旧字段 | 新字段 |
|
||||
|--------|--------|
|
||||
| res.list | res.records |
|
||||
| row.id | row.productId |
|
||||
|
||||
涉及的 Vue 文件:`src/views/order/components/OrderEditModal.vue` 第525-531行、第542行。
|
||||
|
||||
---
|
||||
|
||||
## 关联信息
|
||||
|
||||
- Issue:#500
|
||||
- PR:#501
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户