# 接口变更记录 — 2026-04-13 （重要）

> **变更类型**：接口路径变更
> **影响范围**：创建产品 + Step1基础信息保存
> **测试环境已部署**

---

## Step1 基础信息保存 — 接口变更

### 旧接口（已删除，不可用）

```
POST   /admin/product/item              ← 已删除
PUT    /admin/product/item/{id}/basic    ← 已删除
```

### 新接口（立即使用）

```
POST   /admin/product/item/basic
```

**一个接口同时支持创建和更新**：
- `productId` **不传** = 创建新产品，返回新productId
- `productId` **传了** = 更新已有产品，返回原productId

### 创建产品（productId不传）

```json
// POST /admin/product/item/basic
{
  "productType": "CORE",     // 创建时必传: CORE/GROUP/CUSTOM
  "name": "额吉的故乡·亲子版",  // 必传
  "tripDays": 6,             // 可选
  "lineId": 100              // CORE/GROUP必传，CUSTOM可空
}
```

**响应**：
```json
{
  "code": 200,
  "message": "成功",
  "data": 2043246204711550977    // 新产品ID
}
```

### 更新产品（productId传已有ID）

```json
// POST /admin/product/item/basic
{
  "productId": 2043246204711550977,  // 传了就是更新
  "version": 0,                      // 更新时必传（乐观锁）
  "name": "额吉的故乡·亲子版",
  "subtitle": "6天5晚草原环线",
  "tripDays": 6,
  "lineId": 100,
  "coverImageUrl": "https://...",
  "seasons": ["summer", "autumn"],
  "tags": ["亲子", "研学"],
  "tiers": [
    {"tierSeq": 1, "tierName": "舒适"},
    {"tierSeq": 2, "tierName": "豪华"}
  ],
  "paymentType": "FULL",
  "showReview": true
}
```

**响应**：
```json
{
  "code": 200,
  "message": "成功",
  "data": 2043246204711550977    // 原产品ID
}
```

### 前端使用方式

```
新建产品：
  1. 弹窗填 name + productType + lineId
  2. POST /admin/product/item/basic（不传productId）
  3. 拿到返回的 productId → 跳转编辑页

编辑产品：
  1. GET /admin/product/item/{id} 拿详情 + version
  2. 修改字段
  3. POST /admin/product/item/basic（传productId + version）
```

---

## 字典补充：payment_type 已恢复

`GET /admin/dict/data/type/payment_type`

| 值 | 中文 |
|----|------|
| FULL | 全款支付 |
| DEPOSIT | 订金+尾款 |