diff --git a/changelogs-v2/2026-05/26_2988_v3精选评价source-sourceLabel对齐_PR3054.md b/changelogs-v2/2026-05/26_2988_v3精选评价source-sourceLabel对齐_PR3054.md new file mode 100644 index 0000000..838f16a --- /dev/null +++ b/changelogs-v2/2026-05/26_2988_v3精选评价source-sourceLabel对齐_PR3054.md @@ -0,0 +1,49 @@ +# 二期 v3 精选评价补 source / sourceLabel(对齐一期 #2988) + +> **服务**: hl-order-service-v3 + hl-product-service-v2 +> **PR**: #3054(配套 dev→dev-v3 同步 #3050) +> **Issue**: #2988(一期同步到二期 v3) +> **日期**: 2026-05-26 +> **影响**: 🟢 二期 v3 环境精选评价新增填充评价来源字段(契约字段一期 #2988 已加,本次仅二期环境行为对齐,**向后兼容**) + +--- + +## ⚠️ 关键变化(前端 mmg 必读) + +### 二期 v3 环境:产品详情精选评价现返回「评价来源」 + +产品详情接口响应里 `reviewSummary.topReview` 节点下,现正确返回两个来源字段: + +```json +{ + "reviewSummary": { + "avgScore": 4.8, + "totalCount": 120, + "topReview": { + "reviewId": 123, + "nickname": "张三", + "content": "...", + "score": 5, + "source": "MINIPROGRAM", // 评价来源枚举 + "sourceLabel": "小程序" // 来源中文(字典 review_source) + } + } +} +``` + +- `source`:评价来源枚举 —— `MINIPROGRAM`=小程序 / `YOUZAN`=有赞(字典 `review_source`) +- `sourceLabel`:来源中文名,来自字典 `review_source` 的 `dict_label`(运维改字典即时生效,无需重启) + +### 行为说明 + +- **之前**:二期 v3 环境下这两字段恒为 `null`(v3 评价表无 source 列、链路未填充) +- **之后**:正常返回小程序/有赞来源 + +字段本身一期 #2988 早已加入并上线(一期环境已可用)。**前端若已按一期 #2988 接入了 source/sourceLabel,二期环境无需任何改动**,本次只是把二期 v3 的填充行为对齐到一期。 + +--- + +## 📌 备注 + +- 本次改动已合并 dev-v3(PR #3054),但**截至发稿尚未部署到测试服验证**(应需求方要求提前同步)。前端在二期测试环境实际联调前,请先确认 hl-order-service-v3 / hl-product-service-v2 已部署该版本。 +- 后端实现:v3 评价表补 `source` 列(独立库 hl_order_service_v3,V20260526_001)+ `sourceLabel` 复用字典动态获取,与一期口径一致。