# feat(评价): 评价列表/审核 admin 端新增「来源」列 + 筛选; 小程序评价 VO 新增 source 字段

> **类型**: feat (后端 + 前端均需改动)
> **关联 PR/Issue**: PR #2981 (Closes #2978) 已合 dev,测试服已部署 + API 真测通过
> **日期**: 2026-05-25
> **影响范围**: admin 端「评价审核」列表(`/admin/review/list`) + 小程序评价查询接口(`/mp/review/*`)
> **接收方**: mmg
> **前端**: **admin 端需要改造**(新增「来源」列 + 筛选下拉);小程序端按需展示

---

## 🎯 背景

业务侧需要区分评价的来源渠道。本期场景:

- **MINIPROGRAM = 小程序**:客人在小程序提交的评价(已有的全部历史数据,新增评价默认这个)
- **YOUZAN = 有赞**:从有赞平台导入的评价(本期不做导入接口,wx 自行 INSERT/批量导入)

后端字段已就绪,管理端展示 + 筛选需要前端配合。

---

## 📊 admin 端 `/admin/review/list` 改动

### 1. 响应每条评价新增 2 个字段

```diff
{
  "reviewId": 2058729444025028610,
  "status": "APPROVED",
  ...,
+ "source": "MINIPROGRAM",        // 评价来源 code
+ "sourceLabel": "小程序"          // 评价来源中文
}
```

枚举值:

| source | sourceLabel |
|--------|-------------|
| MINIPROGRAM | 小程序 |
| YOUZAN | 有赞 |

### 2. 请求新增筛选入参 `source`(可选)

```
GET /admin/review/list?pageNo=1&pageSize=20&source=YOUZAN
GET /admin/review/list?pageNo=1&pageSize=20&source=MINIPROGRAM
```

不传 = 不按来源筛选(返回全部)。

### 3. 前端期望改造

- 列表表头加一列「来源」,内容直接渲染 `sourceLabel`(已是中文,无需前端再映射)
- 筛选区(截图中现有「评价状态 / 评价等级 / 图片/视频」那一行)加一个「来源」下拉,选项:
  - 全部 (不传 source)
  - 小程序 (source=MINIPROGRAM)
  - 有赞 (source=YOUZAN)

---

## 📊 小程序 `/mp/review/*` 改动

### 受影响接口

- `GET /mp/review/target?targetType=PRODUCT&targetId=...`
- `GET /mp/review/product/{productId}`

### 响应每条评价新增 2 个字段(同 admin)

```diff
{
  "reviewId": 2031394849190555650,
  "userNickname": "xxx",
  ...,
+ "source": "MINIPROGRAM",
+ "sourceLabel": "小程序"
}
```

### 前端期望

小程序端**是否展示**「来源」标识由 mmg 决定。如果展示,直接渲染 `sourceLabel`(有赞评价可加角标区分)。

---

## 🔬 业务规则

1. **小程序新建评价 `POST /mp/review/create`** → 后端自动写入 `source=MINIPROGRAM`,前端不需要传
2. **有赞评价**本期不做导入接口,wx 自行 INSERT(`INSERT INTO order_review (..., source) VALUES (..., 'YOUZAN')`)
3. 历史所有评价已回填 `source=MINIPROGRAM`

---

## ✅ 后端验证记录

### 本地 (gateway 8080)

```
POST /admin/auth/login                       → 200, token len=259
GET  /admin/review/list?pageNo=1&pageSize=2  → source/sourceLabel 字段就位
GET  /admin/review/list?source=YOUZAN        → total=1 (手动 UPDATE 1 条测试)
GET  /admin/review/list?source=MINIPROGRAM   → total=446
GET  /mp/review/target?targetType=PRODUCT... → source/sourceLabel 透传 OK
```

### 测试服 (api.test.1814.love:9443)

```
POST /admin/auth/login                       → 200
GET  /admin/review/list?pageNo=1&pageSize=2  → source=MINIPROGRAM sourceLabel=小程序 ✓
GET  /admin/review/list?source=YOUZAN        → total=0 (干净, 等 wx 导入)
GET  /mp/review/target?targetType=PRODUCT... → source=MINIPROGRAM sourceLabel=小程序 ✓
```

Flyway `V20260525_001__add_source_to_order_review.sql` 已落库,`source VARCHAR(32) NOT NULL DEFAULT 'MINIPROGRAM'` + `idx_source` 索引。
