# 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`

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

```json
{
  "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](https://git.1814.love:8443/wx/HL/issues/1011)
- PR: [wx/HL#1014](https://git.1814.love:8443/wx/HL/pulls/1014)（已合并到 dev）
- 前置：[2026-04-20_order-v2_mp-travel-memory.md](./2026-04-20_order-v2_mp-travel-memory.md)（PR #1004）