# 接口变更记录 — 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
