hl-api-changelog/changelogs-v2/2026-05/26_2988_v3精选评价source-sourceLabel对齐_PR3054.md

二期 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 节点下,现正确返回两个来源字段:

{
  "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 复用字典动态获取,与一期口径一致。