API Changelog Bot 11fb1a6c9b feat(评价): admin/mp 评价接口加 source 来源字段 (HL #2978/PR #2981 )

- admin /admin/review/list 加 source/sourceLabel + source 筛选入参
- mp /mp/review/target & /product/{id} 加 source/sourceLabel
- 枚举 MINIPROGRAM(小程序) / YOUZAN(有赞)
- 小程序创建评价后端写死 MINIPROGRAM
- 有赞数据本期不做导入接口,wx 自行 INSERT

2026-05-25 10:40:14 +08:00

3.6 KiB

原始文件 永久链接 Blame 文件历史

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 个字段

{
  "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)

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

前端期望

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

🔬 业务规则

小程序新建评价 POST /mp/review/create → 后端自动写入 source=MINIPROGRAM,前端不需要传
有赞评价本期不做导入接口,wx 自行 INSERT(INSERT INTO order_review (..., source) VALUES (..., 'YOUZAN'))
历史所有评价已回填 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 索引。

3.6 KiB 原始文件 永久链接 Blame 文件历史