hl-api-changelog/changelogs-v2/2026-07/18_房务已完成配房后再次配房被缺少需求ID拦截-前端待处理-管理后台.md
2026-07-03 14:25:17 +08:00

2.9 KiB

房务已完成配房后再次配房被“缺少需求ID”拦截前端待处理

  • 日期2026-07-03
  • 端:管理后台
  • 页面:房务管家 / 待处理详情弹窗
  • 示例订单:HL20260703140009401
  • 订单 ID2072923329412427777
  • 当前状态:房务已完成配房,详情展示“已完成 / 配房进度 2/2”
  • 当前结论:已完成配房的订单也允许再次修改需求/重新配房,前端当前拦截不正确。

现象

/housekeeper/todos 打开订单详情弹窗后,订单已经完成配房,住宿行仍显示「配房」按钮。

点击「配房」时,前端弹出提示:

缺少需求 ID,暂无法配房

但业务口径是:已经完成配房的订单也可以改,配置完成后仍可以提出修改需求/重新配房。

前端问题

当前前端疑似在已完成配房场景下:

  1. 没有从详情数据中正确取到当前住宿需求 requirementId;或
  2. 因为订单/房务状态是“已完成 / 已回配 / CONFIRMED”,前端把需求 ID 当成不可用;或
  3. 点击「配房」时只读取待配房状态下的字段,没有兼容已完成配房状态下的 active requirement。

这个拦截不对。

业务口径

  • 已完成配房不等于需求不可改。
  • 定制师/房务在已完成配房后仍可以再次提出修改需求。
  • 房务侧已完成配房后,也应允许基于当前订单/当前需求进入再次配房或修改需求链路。
  • 不应因为 houseStatus=CONFIRMED、页面展示“已完成”、住宿行展示“已确认/已配房”就阻断操作。

前端处理要求

请调整房务详情弹窗里的「配房」/修改需求相关入口逻辑:

  1. 已完成配房订单点击「配房」时,不要弹出“缺少需求 ID,暂无法配房”。
  2. 应从订单详情/房务详情返回数据中取当前 active 住宿需求 ID。
  3. 如果当前展示的是已回配/已确认的住宿行,也应保留当前需求上下文,用于再次配房或发起修改需求。
  4. 若确实没有 requirementId,应先复查接口字段映射,不要直接在前端拦截掉已完成配房场景。
  5. 操作入口应兼容以下状态:
    • 待配房
    • 配房中
    • 待最终确认
    • 已完成/已确认/已回配

后端接口说明

本次无后端接口变更。

后端已有房务需求/配房数据,当前示例订单能展示配房行、配房进度、已确认酒店,说明订单与房务需求上下文存在。

前端需要修正字段取值和状态判断。

验收标准

  • HL20260703140009401 这种已完成配房订单,点击住宿行「配房」不再提示“缺少需求 ID”。
  • 已完成配房订单可以进入再次配房/修改需求操作流程。
  • 状态为“已完成 / 配房进度 2/2”的订单仍可基于当前需求继续操作。
  • 待配房、配房中、待最终确认等原有状态操作不受影响。