diff --git a/changelogs/2026-04/2026-04-14_product-v2_simple_list_for_order.md b/changelogs/2026-04/2026-04-14_product-v2_simple_list_for_order.md new file mode 100644 index 0000000..2a96be0 --- /dev/null +++ b/changelogs/2026-04/2026-04-14_product-v2_simple_list_for_order.md @@ -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