# 房务驳回后订单详情旧住宿需求展示（前端待处理）

## 背景

房务驳回住宿需求后，旧需求不会删除。后端会把旧版本保留为历史证据：

- `order_hotel_requirement.is_active = 0`
- `order_hotel_requirement.status = REJECTED_TO_CONSULTANT` 或 `REJECTED_TO_ADMIN`
- 原始 `days`、候选酒店、房型、备注、特殊诉求仍保留

当前订单详情行程 Tab 只读取当前 active 住宿需求：

- `GET /v3/admin/order/{orderId}/itinerary`
- 驳回后该接口里的 `hotelGroup.requirement = null`

所以前端不能只依赖 `hotelGroup.requirement` 判断住宿需求展示。

最新修正：即使订单已经有新的 active 住宿需求，旧的历史需求也要展示。历史需求不是空态兜底，而是订单详情住宿卡片的固定只读历史区。

## 前端需要调整

订单详情页「行程安排 / 住宿安排」卡片：

1. 继续优先展示当前生效住宿需求：`GET /v3/admin/order/{orderId}/itinerary` 的 `hotelGroup.requirement`。
2. 无论 `hotelGroup.requirement` 是否为空，都要读取历史需求接口：

```http
GET /admin/house/orders/{orderId}/requirement-history
```

3. 如果历史接口返回 `list.length > 0`，住宿卡片需要增加“历史需求”区域，展示旧版本需求内容。
4. 历史区只展示旧版本：建议过滤掉 `isCurrent=true` 或 `snapshot.isActive=true` 的当前生效版本，避免当前需求重复显示。
5. 历史需求使用 `list[].snapshot.days` 渲染，字段结构包含 `dayNumber / stayDate / city / segments / candidates / rooms`。
6. 被驳回或失效的旧需求必须只读，不允许出现以下动作：
   - 修改需求
   - 删除需求
   - 配房
   - 替换房型
   - 最终确认
7. 当前无 active 需求但存在驳回历史时，“提交房型需求”仍可展示，用于定制师重新提交全新需求版本。
8. 当前有 active 新需求时，仍然展示当前需求的“修改需求/加急/联系房务”等正常动作；历史旧需求只读，不影响当前需求操作。

## 历史接口字段口径

接口：

```http
GET /admin/house/orders/{orderId}/requirement-history
```

关键字段：

```json
{
  "list": [
    {
      "version": 1,
      "isCurrent": false,
      "status": "REJECTED_TO_CONSULTANT",
      "currentBadge": {
        "label": "已驳回",
        "color": "red",
        "tooltip": "本版已被房务驳回, 仅作为历史需求保留"
      },
      "submittedAt": "2026-07-07 09:24:39",
      "returnReason": "驳回原因",
      "returnedAt": "2026-07-07 09:34:28",
      "snapshot": {
        "requirementId": "2074303548706701314",
        "version": 1,
        "isActive": false,
        "status": "REJECTED_TO_CONSULTANT",
        "days": []
      }
    }
  ]
}
```

展示建议：

- 标题：`历史需求` / `已驳回需求` / `旧需求`
- 徽章优先用 `currentBadge.label`，没有时按 `status` 字典展示。
- 驳回原因优先用 `returnReason`，没有时不展示原因行。
- 需求内容用 `snapshot.days`，不要把历史 `snapshot` 映射成当前 `roomRequest`，否则会误打开“修改需求”链路。
- 当前 active 新需求和历史旧需求要能同屏出现；历史区可折叠，但不能完全不展示。

## 验收口径

- 已驳回且无 active 需求的订单，住宿卡片仍能看到旧需求内容。
- 已有 active 新需求的订单，住宿卡片仍能看到旧需求内容。
- 页面可继续展示“提交房型需求”，用于重新发起全新需求。
- 旧需求没有修改、删除、配房、替换、最终确认入口。
- 当前 active 需求存在时，当前需求仍按原逻辑展示，同时展示旧需求历史区。
- 历史需求展示不影响房务抢单池；只有重新提交的新 active 需求才进入抢单池。

## 测试环境实测样例

订单：

- `orderId = 2074303545149980674`
- `orderNo = HL20260707092437709`

现象：

- `GET /v3/admin/order/2074303545149980674/itinerary`
  - `hotelGroup.requirement = null`
- `GET /admin/house/orders/2074303545149980674/requirement-history`
  - `list.length = 1`
  - `list[0].status = REJECTED_TO_CONSULTANT`
  - `list[0].snapshot.days` 有原始 2 晚住宿需求