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

接口变更记录 — 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排序)" → "同组所有版本选项(含自己)"

📁 全部变更文件 (点击展开)

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