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