hl-api-changelog/changelogs-v2/2026-07/34_房务驳回后订单详情旧住宿需求展示-前端待处理-管理后台.md
2026-07-07 09:54:52 +08:00

4.2 KiB

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

背景

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

  • order_hotel_requirement.is_active = 0
  • order_hotel_requirement.status = REJECTED_TO_CONSULTANTREJECTED_TO_ADMIN
  • 原始 days、候选酒店、房型、备注、特殊诉求仍保留

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

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

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

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

前端需要调整

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

  1. 继续优先展示当前生效住宿需求:GET /v3/admin/order/{orderId}/itineraryhotelGroup.requirement
  2. 无论 hotelGroup.requirement 是否为空,都要读取历史需求接口:
GET /admin/house/orders/{orderId}/requirement-history
  1. 如果历史接口返回 list.length > 0,住宿卡片需要增加“历史需求”区域,展示旧版本需求内容。
  2. 历史区只展示旧版本:建议过滤掉 isCurrent=truesnapshot.isActive=true 的当前生效版本,避免当前需求重复显示。
  3. 历史需求使用 list[].snapshot.days 渲染,字段结构包含 dayNumber / stayDate / city / segments / candidates / rooms
  4. 被驳回或失效的旧需求必须只读,不允许出现以下动作:
    • 修改需求
    • 删除需求
    • 配房
    • 替换房型
    • 最终确认
  5. 当前无 active 需求但存在驳回历史时,“提交房型需求”仍可展示,用于定制师重新提交全新需求版本。
  6. 当前有 active 新需求时,仍然展示当前需求的“修改需求/加急/联系房务”等正常动作;历史旧需求只读,不影响当前需求操作。

历史接口字段口径

接口:

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

关键字段:

{
  "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 晚住宿需求