hl-api-changelog/changelogs/2026-04/2026-04-02_1429_dca8f78c_refactor.md

72 行
3.8 KiB
Markdown

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