diff --git a/changelogs/2026-04/2026-04-02_1306_d5c18baa_feat.md b/changelogs/2026-04/2026-04-02_1306_d5c18baa_feat.md new file mode 100644 index 0000000..5f82fed --- /dev/null +++ b/changelogs/2026-04/2026-04-02_1306_d5c18baa_feat.md @@ -0,0 +1,98 @@ +# 接口变更记录 — 2026-04-02 13:06 + +> **提交** `d5c18baa` · **作者** wx · **时间** 2026-04-02 13:06:01 +0800 +> +> feat: 产品等级功能——支持轻奢/高档等级分组 + +## 变更总览 + +- **产品服务** + - Product (+1) + +--- + +## 产品服务 + +### Product + +> 📖 **接口文档**: [http://192.168.100.236:8085/doc.html](http://192.168.100.236:8085/doc.html) → 标签 **「产品管理」** + +### 🆕 `GET` /admin/product/item/grade-groups — 查询等级分组列表(管理端选择关联等级产品用) + +**参数** + + - `lineId` (`Long`) — 查询参数:按产品线ID筛选 + +--- + +## 📦 其他数据对象变更 + +> 以下变更未直接关联到本次接口变更,但可能影响现有接口的请求/响应 + +### 产品服务 + +#### 🆕 GradeOptionVO + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `productId` | `String` | 产品ID | +| `productGrade` | `String` | 等级编码: LIGHT_LUXURY=轻奢, HIGH_END=高档 | +| `productGradeLabel` | `String` | 等级中文标签 | +| `startPrice` | `BigDecimal` | 起步价 | +| `startPriceLabel` | `String` | 起步价标签:'起' 或 '订金起' | + +#### ✏️ MpProductListVO + + - 🆕 `productGrade` (`String`) — 产品等级编码(null=无等级): LIGHT_LUXURY=轻奢, HIGH_END=高档 + - 🆕 `productGradeLabel` (`String`) — 产品等级中文标签 + - 🆕 `gradeGroupId` (`String`) — 等级分组ID(null=独立产品) + - 🆕 `gradeOptions` (`List`) — 同组所有等级选项(含自己,按gradeSort排序) + +#### ✏️ ProductCreateRequest + + - 🆕 `productGrade` (`String`) — 产品等级: LIGHT_LUXURY=轻奢, HIGH_END=高档(不传=无等级) + - 🆕 `gradeGroupId` (`Long`) — 等级分组ID(关联已有等级产品时传入) + - 🆕 `gradeSort` (`Integer`) — 等级排序(同组内) + +#### ✏️ ProductListVO + + - 🆕 `productGrade` (`String`) — 产品等级编码(null=无等级) + - 🆕 `productGradeLabel` (`String`) — 产品等级中文 + - 🆕 `gradeGroupId` (`String`) — 等级分组ID(null=独立产品) + +#### ✏️ ProductSaveRequest + + - 🆕 `productGrade` (`String`) — 产品等级: LIGHT_LUXURY=轻奢, HIGH_END=高档(不传=无等级) + - 🆕 `gradeGroupId` (`Long`) — 等级分组ID(关联已有等级产品时传入该产品的gradeGroupId,首个等级产品不传) + - 🆕 `gradeSort` (`Integer`) — 等级排序(同组内,越小越靠前) + +#### ✏️ ProductUpdateRequest + + - 🆕 `productGrade` (`String`) — 产品等级: LIGHT_LUXURY=轻奢, HIGH_END=高档(不传=无等级) + - 🆕 `gradeGroupId` (`Long`) — 等级分组ID(关联已有等级产品时传入) + - 🆕 `gradeSort` (`Integer`) — 等级排序(同组内) + +#### ✏️ ProductVO + + - 🆕 `productGrade` (`String`) — 产品等级编码(null=无等级): LIGHT_LUXURY=轻奢, HIGH_END=高档 + - 🆕 `productGradeLabel` (`String`) — 产品等级中文标签 + - 🆕 `gradeGroupId` (`String`) — 等级分组ID(null=独立产品) + - 🆕 `gradeOptions` (`List`) — 同组所有等级选项(含自己,按gradeSort排序) + +
+📁 全部变更文件 (点击展开) + +``` +M hl-product-service/src/main/java/com/hulalv/product/constant/ProductConstants.java +M hl-product-service/src/main/java/com/hulalv/product/controller/ProductController.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 +A 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 +``` +
\ No newline at end of file