From 0c62e86ced7e94c7d53785068a55db08650f7dc5 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Thu, 20 Aug 2026 07:59:35 +0000 Subject: [PATCH] =?UTF-8?q?docs(house):=20=E7=BB=88=E6=AD=A2=E8=A1=8C?= =?UTF-8?q?=E7=A8=8B=E8=AE=A2=E5=8D=95=E9=85=8D=E6=88=BF=E4=B8=89=E6=8C=89?= =?UTF-8?q?=E9=92=AE=E7=A6=81=E7=94=A8=EF=BC=88#6111=20=E5=AD=90=E9=A1=B9?= =?UTF-8?q?=EF=BC=8C=E7=BA=AF=E5=89=8D=E7=AB=AF=E6=B8=B2=E6=9F=93=E9=80=BB?= =?UTF-8?q?=E8=BE=91=E5=91=8A=E7=9F=A5=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...行程订单配房三按钮禁用-修改接口-管理后台.md | 72 +++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 changelogs-v2/2026-08/20_6111_终止行程订单配房三按钮禁用-修改接口-管理后台.md diff --git a/changelogs-v2/2026-08/20_6111_终止行程订单配房三按钮禁用-修改接口-管理后台.md b/changelogs-v2/2026-08/20_6111_终止行程订单配房三按钮禁用-修改接口-管理后台.md new file mode 100644 index 0000000..9d72b8b --- /dev/null +++ b/changelogs-v2/2026-08/20_6111_终止行程订单配房三按钮禁用-修改接口-管理后台.md @@ -0,0 +1,72 @@ +--- +schema: "hl-changelog/v2" +ticket: "6111" +title: "终止行程（异常）订单配房组「标记完成/最终确认/清空配房」三按钮禁用（纯前端渲染逻辑告知）" +consumer: "admin" +author: "wx" +change_type: "修改接口" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "pending" +frontend_owner: "mmg" +frontend_ref: "" +target_release: "" +verified_at: "2026-08-20" +status_note: "订单终止行程后，配房组 houseStatus 已返回 EXCEPTION（异常）。本文告知前端：此类订单不得再展示/可用「标记完成」「最终确认」「清空配房」三按钮（或展示但禁用），避免对异常单误操作。后端契约字段早已返回，本次无后端代码变更，纯前端渲染/禁用逻辑。" +updated_at: "2026-08-20" +base: "dev-v3" +generated: "2026-08-20T00:00:00+08:00" +--- + +# 终止行程（异常）订单配房三按钮禁用（#6111 子项） + +## 背景 + +订单**中止行程**后，房务侧会把该订单的配房组翻为异常（`houseStatus=EXCEPTION`），并产生退订待办。此时该订单的配房已处于「异常/待处理退订」状态，**不应再走正常配房流程的操作**。 + +但当前订单详情页对这类异常订单，仍然展示并可点「**标记完成**」「**最终确认**」「**清空配房**」三个按钮——这些动作对异常单无业务意义，且可能引发状态错乱。 + +**本文告知前端：依据已有契约字段 `houseStatus` 判断，对异常订单禁用（或不展示）这三按钮。后端无新增字段。** + +## 变更接口 + +| 接口 | 变更 | +| --- | --- | +| `GET /v3/admin/order/{orderId}/detail`（订单详情） | **无契约变更**。`itinerary[].hotelGroup.houseStatus` / `houseStatusLabel` 字段早已返回，本次仅告知前端据此做禁用渲染 | + +## 一、判断依据（契约字段，已返回） + +订单详情 `itinerary[].hotelGroup` 节点： + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `houseStatus` | string | 房务状态机值。**终止行程后 = `EXCEPTION`（异常）**。其它值：`CLAIMING` 抢单中 / `PENDING_FINALIZE` 待最终确认 / `CONFIRMED` 已确认 等 | +| `houseStatusLabel` | string | 对应中文标签，`EXCEPTION` → 「异常」 | +| `finalized` | boolean | 是否已最终确认（仅 `houseStatus=CONFIRMED` 时为 true） | + +## 二、前端渲染要求 + +当 `itinerary[].hotelGroup.houseStatus === "EXCEPTION"` 时： + +| 按钮 | 处理 | +| --- | --- | +| **标记完成** | 禁用（或不展示） | +| **最终确认** | 禁用（或不展示） | +| **清空配房** | 禁用（或不展示） | + +> 建议：禁用优于隐藏——保留按钮但置灰 + tooltip「订单已终止行程，配房异常待处理」，让用户知道为何不能点。 + +## 三、正常订单不受影响 + +`houseStatus` 非 `EXCEPTION` 的订单（抢单中/待最终确认/已确认等），三按钮显隐逻辑维持现状不变。 + +## 四、配套说明 + +- 「**未用房晚标记 + 行级资源释放按钮**」与「**异常原因显示（客户中止）**」是 #6111 的另外两个子项，**需后端补字段**，已在 #6111 工单跟进，不在本文范围。 +- 本文只覆盖「**异常订单禁用三按钮**」这一项——纯前端逻辑，字段已具备，可直接实现。 + +## 验证 + +- [ ] 终止行程的订单（如 26-9250）详情页配房组三按钮禁用/不展示 +- [ ] 正常进行中订单三按钮显隐不变 +- [ ] 鼠标悬停禁用按钮有「订单已终止行程」类提示（可选）