hl-api-changelog/changelogs/2026-04/2026-04-20_order-v2_mp-travel-memory-rating.md

C端「我的旅行回忆」接入评分 — 2026-04-20

服务 hl-order-service-v2（端口 8094）+ hl-user-service（端口 8081）· 类型 feat · 关联 Issue #1011 / PR #1014 依赖变更 延续 PR #1004 的 GET /mp/order/travel-memory，本期补评分字段

---

一、现有接口字段新增（无路径/参数变更）

✏️ GET /mp/order/travel-memory — 我的旅行回忆

请求参数：不变（page / pageSize）。

MpTravelMemoryVO 新增 2 个字段：

字段	类型	必有	说明
rating	Integer	否	整体满意度评分（1-5），未评价或评价服务降级时为 null
reviewId	Long	否	评价 ID，未评价或评价服务降级时为 null

原有字段保持不变：orderId · productName · productCoverUrl · departureDate · returnDate · tripDays · tripNights · reviewed

响应示例（已评价 + 未评价混合）：

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "orderId": 2043935542092980226,
        "productName": "草原环线体验·舒适套餐",
        "productCoverUrl": "https://cdn.1814.love/product/cover/xxxx.png",
        "departureDate": "2026-07-01",
        "returnDate": "2026-07-06",
        "tripDays": 6,
        "tripNights": 5,
        "reviewed": true,
        "rating": 5,
        "reviewId": 6001
      },
      {
        "orderId": 2043935542092980211,
        "productName": "呼伦贝尔深度游·豪华版",
        "productCoverUrl": "https://cdn.1814.love/product/cover/yyyy.png",
        "departureDate": "2026-05-15",
        "returnDate": "2026-05-20",
        "tripDays": 6,
        "tripNights": 5,
        "reviewed": false,
        "rating": null,
        "reviewId": null
      }
    ],
    "total": 2,
    "page": 1,
    "pageSize": 10
  }
}

降级行为

评价服务（hl-user-service）不可用时，本接口走 Fallback：

• records 正常返回（订单基础字段齐全）
• 所有订单的 rating 和 reviewId 均为 null
• HTTP 200，code=200，不抛异常

---

二、新增内部接口（服务间，前端无需关心）

🆕 GET /internal/review/orders/summaries — 批量订单评价摘要

仅供 hl-order-service-v2 通过 Feign 调用 hl-user-service。网关未暴露，前端不调用。

请求参数：

参数	位置	类型	必填	约束	说明
orderIds	Query	String	✅	逗号分隔，≤200	订单 ID 列表

返回值 Result<List<InternalOrderReviewSummaryVO>>：

字段	类型	说明
orderId	Long	订单 ID
reviewId	Long	评价 ID
ratingOverall	Integer	整体满意度评分（1-5）
ratingAvg	BigDecimal	综合评分（各维度算术平均，1 位小数）
ratingLevel	String	评价等级：GOOD/MEDIUM/BAD
content	String	评价正文
hasImage	Boolean	是否含图片
status	String	评价状态（字典 review_status：PENDING_MODERATION/APPROVED/REJECTED 等）
createdAt	LocalDateTime	评价创建时间

查询语义：仅返回 target_type='PRODUCT' 的评价；未评价的 orderId 不出现在返回列表中；不过滤 status（包括待审核/被拒）。

---

三、数据库变更

无。评价数据已存在 order_review 表。

---

四、错误码

HTTP 始终返回 200，错误码在 Result.code 中。

code	触发	说明
200	正常	成功（评价服务降级时 code 也是 200，rating/reviewId 为 null）
400	orderIds 超过 200	批量接口校验（BusinessException）

---

五、关联

• Issue: wx/HL#1011
• PR: wx/HL#1014（已合并到 dev）
• 前置：2026-04-20_order-v2_mp-travel-memory.md（PR #1004）