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