# 接口变更记录 — 2026-04-02 14:29

> **提交** `dca8f78c` · **作者** wx · **时间** 2026-04-02 14:29:09 +0800
>
> refactor: 去掉产品等级概念，用产品名作为版本名

## 📦 其他数据对象变更

> 以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应

### 产品服务

#### ✏️ GradeOptionVO

  - 🆕 `name` (`String`) — 产品名称（即版本名）
  - ❌ ~~`productGrade`~~ (`String`) — 等级编码: LIGHT_LUXURY=轻奢, HIGH_END=高档
  - ❌ ~~`productGradeLabel`~~ (`String`) — 等级中文标签

#### ✏️ MpProductListVO

  - ❌ ~~`productGrade`~~ (`String`) — 产品等级编码(null=无等级): LIGHT_LUXURY=轻奢, HIGH_END=高档
  - ❌ ~~`productGradeLabel`~~ (`String`) — 产品等级中文标签
  - ✏️ `gradeGroupId`: 说明 "等级分组ID(null=独立产品)" → "版本分组ID(null=独立产品，有值时同组产品在列表合并)"
  - ✏️ `gradeOptions`: 说明 "同组所有等级选项(含自己，按gradeSort排序)" → "同组所有版本选项(含自己)"

#### ✏️ ProductCreateRequest

  - ❌ ~~`productGrade`~~ (`String`) — 产品等级: LIGHT_LUXURY=轻奢, HIGH_END=高档(不传=无等级)
  - ❌ ~~`gradeSort`~~ (`Integer`) — 等级排序(同组内)
  - ✏️ `gradeGroupId`: 说明 "等级分组ID(关联已有等级产品时传入)" → "版本分组ID(关联已有版本产品时传入)"

#### ✏️ ProductListVO

  - ❌ ~~`productGrade`~~ (`String`) — 产品等级编码(null=无等级)
  - ❌ ~~`productGradeLabel`~~ (`String`) — 产品等级中文
  - ✏️ `gradeGroupId`: 说明 "等级分组ID(null=独立产品)" → "版本分组ID(null=独立产品)"

#### ✏️ ProductSaveRequest

  - ❌ ~~`productGrade`~~ (`String`) — 产品等级: LIGHT_LUXURY=轻奢, HIGH_END=高档(不传=无等级)
  - ❌ ~~`gradeSort`~~ (`Integer`) — 等级排序(同组内，越小越靠前)
  - ✏️ `gradeGroupId`: 说明 "等级分组ID(关联已有等级产品时传入该产品的gradeGroupId，首个等级产品不传)" → "版本分组ID(关联已有版本产品时传入该产品的gradeGroupId，首个版本产品不传)"

#### ✏️ ProductUpdateRequest

  - ❌ ~~`productGrade`~~ (`String`) — 产品等级: LIGHT_LUXURY=轻奢, HIGH_END=高档(不传=无等级)
  - ❌ ~~`gradeSort`~~ (`Integer`) — 等级排序(同组内)
  - ✏️ `gradeGroupId`: 说明 "等级分组ID(关联已有等级产品时传入)" → "版本分组ID(关联已有版本产品时传入)"

#### ✏️ ProductVO

  - ❌ ~~`productGrade`~~ (`String`) — 产品等级编码(null=无等级): LIGHT_LUXURY=轻奢, HIGH_END=高档
  - ❌ ~~`productGradeLabel`~~ (`String`) — 产品等级中文标签
  - ✏️ `gradeGroupId`: 说明 "等级分组ID(null=独立产品)" → "版本分组ID(null=独立产品)"
  - ✏️ `gradeOptions`: 说明 "同组所有等级选项(含自己，按gradeSort排序)" → "同组所有版本选项(含自己)"

<details>
<summary>📁 全部变更文件 (点击展开)</summary>

```
M	hl-product-service/src/main/java/com/hulalv/product/constant/ProductConstants.java
M	hl-product-service/src/main/java/com/hulalv/product/dto/ProductCreateRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/dto/ProductSaveRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/dto/ProductUpdateRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/entity/Product.java
M	hl-product-service/src/main/java/com/hulalv/product/service/ProductService.java
M	hl-product-service/src/main/java/com/hulalv/product/vo/GradeOptionVO.java
M	hl-product-service/src/main/java/com/hulalv/product/vo/MpProductListVO.java
M	hl-product-service/src/main/java/com/hulalv/product/vo/ProductListVO.java
M	hl-product-service/src/main/java/com/hulalv/product/vo/ProductVO.java
```
</details>