wx/hl-api-changelog

派生 0

API Changelog Bot 1d0c1a78c9 补充: 产品等级字典(product_grade)说明

2026-04-02 13:45:05 +08:00

4.8 KiB

原始文件 Blame 文件历史

产品等级功能 (PR #129, #131, #132)

日期: 2026-04-02 | 服务: hl-product-service | 需重启: 是

新增字典

等级数据通过 sys_dict 管理，字典类型：product_grade

dict_value	dict_label	sort_order
LIGHT_LUXURY	轻奢	1
HIGH_END	高档	2

前端获取方式：调用 GET /dict/all 或 GET /admin/dict/data/product_grade 即可获取等级选项列表。后续新增等级（如"经济"、"至尊"）由运营在字典管理中添加，无需改代码。

新增功能

产品等级分组

同一行程的不同档次（如轻奢版、高档版）可以关联为一组，小程序列表页合并为一张卡片，详情页可切换等级。

接口变更

1. 产品列表接口（C端）

接口: GET /mp/product/list 变更类型: 返回字段新增

列表中同等级分组的产品只返回一条（主等级），附带所有等级选项。

新增返回字段:

字段	类型	说明
`productGrade`	String	产品等级编码，null=无等级。值: `LIGHT_LUXURY`=轻奢, `HIGH_END`=高档
`productGradeLabel`	String	等级中文标签，如"轻奢"
`gradeGroupId`	String	等级分组ID，null=独立产品
`gradeOptions`	Array	同组所有等级选项（含自己），null=无等级
`gradeOptions[].productId`	String	该等级对应的产品ID
`gradeOptions[].productGrade`	String	等级编码
`gradeOptions[].productGradeLabel`	String	等级中文
`gradeOptions[].startPrice`	Number	该等级起步价
`gradeOptions[].startPriceLabel`	String	"起" 或 "订金起"

返回示例（有等级的产品）:

{
  "productId": "123",
  "name": "呼伦贝尔5天亲子深度游",
  "productGrade": "LIGHT_LUXURY",
  "productGradeLabel": "轻奢",
  "gradeGroupId": "123",
  "gradeOptions": [
    {"productId": "123", "productGrade": "LIGHT_LUXURY", "productGradeLabel": "轻奢", "startPrice": 3999, "startPriceLabel": "起"},
    {"productId": "456", "productGrade": "HIGH_END", "productGradeLabel": "高档", "startPrice": 6999, "startPriceLabel": "起"}
  ]
}

返回示例（无等级的产品，不受影响）:

{
  "productId": "789",
  "name": "丽江3天自由行",
  "productGrade": null,
  "gradeGroupId": null,
  "gradeOptions": null
}

2. 产品详情接口（C端）

接口: GET /mp/product/{productId} 变更类型: 返回字段新增

product 对象中新增相同的等级字段（productGrade, productGradeLabel, gradeGroupId, gradeOptions）。

前端切换等级的方式: 用 gradeOptions 中其他等级的 productId 重新调用此接口即可，无需新接口。

3. 推荐产品列表（C端）

接口: GET /mp/product/recommend（内部Feign）同样新增等级字段，同等级分组去重。

4. 管理端产品列表

接口: GET /admin/product/item/list 新增字段: productGrade, productGradeLabel, gradeGroupId（不含gradeOptions，管理端不去重）

5. 管理端产品详情

接口: GET /admin/product/item/{productId} 新增字段同C端详情。

6. [新增] 等级分组查询

接口: GET /admin/product/item/grade-groups 参数: lineId（可选，按产品线筛选）用途: 管理端创建等级产品时，查询已有等级分组列表用于关联返回: 分组列表，每组含 gradeGroupId、groupName、products[]

7. 产品保存接口

接口: POST /admin/product/item/save 新增请求字段:

字段	类型	说明
`productGrade`	String	产品等级，不传=无等级
`gradeGroupId`	Long	等级分组ID，关联已有组时传入
`gradeSort`	Integer	等级排序，越小越前

校验规则:

同一等级分组内不能有重复等级
同一等级分组内的产品必须在同一产品线
同一产品线只能包含同一类型的产品

前端开发指引

列表页

判断 gradeOptions != null && gradeOptions.length > 1 时，显示等级价格标签
卡片示例: [轻奢￥3,999起] [高档￥6,999起]
gradeOptions == null 的产品照常展示

详情页

判断 gradeOptions != null && gradeOptions.length > 1 时，顶部显示等级切换tab
当前等级高亮（匹配 productId）
点击其他等级 → 用该等级的 productId 重新请求详情接口
报价/下单用当前页面的 productId，不受影响

DDL（已在测试/正式服务器执行）

ALTER TABLE product
  ADD COLUMN product_grade VARCHAR(16) DEFAULT NULL COMMENT '产品等级' AFTER product_type,
  ADD COLUMN grade_group_id BIGINT DEFAULT NULL COMMENT '等级分组ID' AFTER product_grade,
  ADD COLUMN grade_sort INT DEFAULT 0 COMMENT '等级排序' AFTER grade_group_id,
  ADD INDEX idx_grade_group_id (grade_group_id);

4.8 KiB 原始文件 Blame 文件历史 Unescape Escape