From c53a6d6875b5414b4d7ba55a80c57b88dd0f08f1 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 21 Jul 2026 16:52:44 +0800
Subject: [PATCH] =?UTF-8?q?docs(house):=20=E9=80=9A=E7=9F=A5=E5=89=8D?=
 =?UTF-8?q?=E7=AB=AF=E6=B8=85=E7=90=86=E6=9C=80=E7=BB=88=E7=A1=AE=E8=AE=A4?=
 =?UTF-8?q?=E6=AE=8B=E7=95=99=E9=81=AE=E7=BD=A9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¿åŠ¡æœ€ç»ˆç¡®è®¤æˆ�功å�Žæ®‹ç•™å…¨å±�é�®ç½©-å‰�端待处ç�†.md | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 changelogs-v2/2026-07/77_房务最终确认�功�残留全��罩-�端待处�.md

diff --git a/changelogs-v2/2026-07/77_房务最终确认�功�残留全��罩-�端待处�.md b/changelogs-v2/2026-07/77_房务最终确认�功�残留全��罩-�端待处�.md
new file mode 100644
index 0000000..c45e1d2
--- /dev/null
+++ b/changelogs-v2/2026-07/77_房务最终确认�功�残留全��罩-�端待处�.md
@@ -0,0 +1,51 @@
+# 房务最终确认�功�残留全��罩（�端待处�）
+
+## 目标�端
+
+- 端类型：管���（Web）
+- 目标仓库：`mmg/hl-ui`（`https://git.1814.love:8443/mmg/hl-ui.git`）
+- �调/验收环境：`http://192.168.100.160:9527`
+- 其他�端：�程��H5 无需处�
+
+本问题属于管���交互状�清�，��求修改�端接�。
+
+## 现象
+
+房务管�员在订�详情完�最�一晚“�日确认��点击“最终确认�，业务�作�功，列表状�也已更新为“已完��，但详情抽屉关闭�页��残留覆盖整个视�的 `.n-modal-mask`。
+
+�罩使列表�暗并拦截鼠标�作，页�上没有��对�框或关闭按钮；按 `Escape` ��罩消失，页����作。
+
+## �现记录
+
+- 测试订�：`HL20260721142957939`
+- �作角色：房务管�员
+- �作步骤：选� -> 两晚�房 -> 两晚�日确认 -> 最终确认
+- �房�径：第 1 晚扣系统库存，第 2 晚�扣系统库存
+- 页�结果：最终确认�功，列表显示“已完��和“已� 2 / 共 2 晚�，但全��罩残留
+- �行观察：�功�观察 3 秒，无 console error 或 failed request
+- 截图��：`D:/work2/HL-v3/.tmp/house-final-200-browser-flow-final-transient-empty.png`
+
+按 `Escape` 清除�罩��新打开该订�，详情正常显示 `2/2`�两晚酒店与库存�径，说明�端状�和�房数��已正确�库，问题集中在�端弹层/抽屉的关闭清�。
+
+## �端处��求
+
+1. 最终确认�功�，关闭确认对�框和订�详情抽屉时�步�载对应 teleport/modal 容器，�能�留��或�交互的 `.n-modal-mask`。
+2. 无论最终确认请求�功�业务失败�网络异常或用户�消，都必须在结�路径中��页�滚动和 pointer events。
+3. �得�赖用户按 `Escape`�刷新页�或�新进入�����作。
+4. ��用全局删除所有�罩的方�修�；�清�本次最终确认�程拥有的弹层状�，�能影�站内信�全局�索等其他弹层。
+5. 最终确认�功�若自动关闭详情，列表状�与统计应正常刷新；若�留详情，则应直接展示正确的完�� `2/2` 数�。
+
+## 验收
+
+| 场景 | 预期 |
+| --- | --- |
+| 正常完�最终确认 | �功�示�无残留�罩，列表�立�点击�筛选和滚动 |
+| 最终确认业务失败 | 错误�示�关闭，原详情���作，无�罩残留 |
+| 最终确认网络失败 | loading 结�，页���交互，��试 |
+| 用户�消最终确认 | 对�框关闭，详情与列表交互正常 |
+| �功��开订� | 显示“已完���正确�房进度�全部�房行 |
+
+## 接�边界
+
+- 最终确认沿用现有房务接�，无需新增字段或修改�应结构。
+- 本次�览器�测确认�功�的列表和详情数�正确，�创建 `wx/HL` �端 Issue。