From 92549d76972cbefbc0f6819203f3966cc1acc978 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 7 Jul 2026 14:15:13 +0800
Subject: [PATCH] docs(house): notify reject button visibility fix

---
 ...¡åº•éƒ¨é©³å›žæŒ‰é’®ä»�误展示-å‰�端待处ç�†-管ç�†å�Žå�°.md | 97 +++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 changelogs-v2/2026-07/38_房务底部驳回按钮�误展示-�端待处�-管���.md

diff --git a/changelogs-v2/2026-07/38_房务底部驳回按钮�误展示-�端待处�-管���.md b/changelogs-v2/2026-07/38_房务底部驳回按钮�误展示-�端待处�-管���.md
new file mode 100644
index 0000000..a1c7193
--- /dev/null
+++ b/changelogs-v2/2026-07/38_房务底部驳回按钮�误展示-�端待处�-管���.md
@@ -0,0 +1,97 @@
+# 房务底部驳回需求按钮�误展示
+
+- 状�：front-end urgent
+- 影�端：管���房务详情弹窗
+- 关�通知：
+  - `29_4777_房务清空�房信�与驳回按钮动作契约-�端待处�-管���.md`
+
+## 问题
+
+2026-07-07 �测时，房务详情弹窗底部�显示“驳回需求�按钮。这是纯�端展示/交互问题：�端 action 和接�守�已�正确。
+
+当�订�示例：
+
+- 订�：`2074303545149980674`
+- 订��：`HL20260707092437709`
+- 状�：`CLAIMING / �房中`
+- �房进度：`1/2`
+- 第 1 晚：已有酒店/�房数�
+- 第 2 晚：待�房
+
+这�场景�能驳回需求。��任� day 还有 active �房/询房数�，驳回按钮都�能展示为��作入�。
+
+## �端当�返回
+
+接�：
+
+```http
+GET /admin/house/orders/2074303545149980674
+```
+
+关键字段：
+
+```json
+{
+  "actions": {
+    "canRejectRequirement": {
+      "enabled": false,
+      "code": "REJECT_REQUIREMENT",
+      "label": "驳回需求",
+      "disabledReason": "已有�房, �能驳回, 请先清空/删除�房",
+      "endpoint": "POST /v3/admin/order/2074303545149980674/hotel-requirement/supplier-reject"
+    },
+    "canClearAssignments": {
+      "enabled": true,
+      "code": "CLEAR_ASSIGNMENTS",
+      "label": "清空�房",
+      "disabledReason": null,
+      "endpoint": "DELETE /v3/admin/order/hotel-requirements/2074310408247623681/assignments"
+    }
+  },
+  "requirement": {
+    "actions": {
+      "canRejectRequirement": false,
+      "canClearAssignments": true
+    }
+  }
+}
+```
+
+强制调用驳回接�也会被�端拒�：
+
+```http
+POST /v3/admin/order/2074303545149980674/hotel-requirement/supplier-reject
+```
+
+返回：
+
+```json
+{
+  "code": 582086,
+  "success": false,
+  "message": "该需求已有�房记录, �能驳回, 请走替�/修改�房"
+}
+```
+
+## �端必须修改
+
+1. 底部“驳回需求�按钮必须绑定 `data.actions.canRejectRequirement.enabled`。
+2. `enabled=false` 时优先�展示“驳回需求�按钮。
+3. 如果产�交互���留按钮，则必须是真 disabled：
+   - `disabled=true`
+   - �绑定�交/打开驳回弹窗的点击事件
+   - 展示 `disabledReason`
+4. �止用这些�件自行推断驳回�用性：
+   - `houseStatus === CLAIMING`
+   - �房进度�是满�，例如 `1/2`
+   - 当�在“�房中��程节点
+   - 第 2 晚�待�房
+5. �端�需��展示控制，�需�在�端判断“有没有�房数��。是�能驳回以�端 action 为准。
+6. 清空任� day 或整体清空�，必须�新拉�详情；�有刷新��端返回 `enabled=true` �能展示/�用驳回入�。
+
+## 验收
+
+- 订� `2074303545149980674`：第 1 晚已有酒店数��第 2 晚待�房，底部�能出现�点击“驳回需求�。
+- �� `actions.canRejectRequirement.enabled=false`，按钮��或真实�用。
+- 点击�用�按钮�会打开驳回原因弹窗，�会调用驳回接�。
+- 清空全部�房�刷新详情，如果�端返回 `enabled=true`，��许显示/�用驳回。