From 5b59232713efafbe31e448c7b11599f42c0730b1 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 21 Jul 2026 09:47:01 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E9=80=9A=E7=9F=A5=E7=AE=A1=E7=90=86?=
 =?UTF-8?q?=E5=90=8E=E5=8F=B0=E6=94=B9=E7=94=A8=E6=88=BF=E5=8A=A1=E4=BD=9C?=
 =?UTF-8?q?=E5=BA=9F=E7=AD=9B=E9=80=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¡è®¢å�•å¼‚常筛选替æ�¢ä¸ºä½œåºŸ-修改接å�£-管ç�†å�Žå�°.md | 68 +++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 changelogs-v2/2026-07/74_5103_房务订�异常筛选替�为作废-修改接�-管���.md

diff --git a/changelogs-v2/2026-07/74_5103_房务订�异常筛选替�为作废-修改接�-管���.md b/changelogs-v2/2026-07/74_5103_房务订�异常筛选替�为作废-修改接�-管���.md
new file mode 100644
index 0000000..9b6ddfc
--- /dev/null
+++ b/changelogs-v2/2026-07/74_5103_房务订�异常筛选替�为作废-修改接�-管���.md
@@ -0,0 +1,68 @@
+# 目标�端
+
+- 端类型：管���（Web）
+- �端仓库：`mmg/hl-ui`（`https://git.1814.love:8443/mmg/hl-ui.git`）
+- �调环境：`http://192.168.100.160:9527`
+- 其他�端：�需�处�
+
+# �更目标
+
+房务管�员“订�列表�的第五个状�筛选由“异常�替�为“作废�。该筛选必须走�端分页，�能�过滤当�页。
+
+# 接��更
+
+## 我的接�
+
+`GET /v3/admin/order/grab-pool/my-claims/hotel`
+
+新增查询�数�值：
+
+```text
+status=voided
+```
+
+语义：仅返回当�房务曾领���因订�调整生�新版本而作废的旧�宿需求。
+
+�应��原结构：
+
+- `list`：本页作废需求；�行 `voided=true`。
+- `total`：全部命中作废需求数，用于�务端分页。
+- `stats.voided`：当�房务全部作废需求计数，��当�状�筛选收窄。
+- `voidReason`�`voidedAt`：作废原因和时间。
+- `primaryAction.code=VIEW`：�读查看，��供�房�最终确认�清空�房�转�等写�作。
+
+现有 `status=exception` 契约��留给其他业务入�，语义��；本页���把它作为第五个筛选项展示。
+
+# 管���适��求
+
+房务管�员“订�列表�顶部筛选固定为：
+
+1. 全部
+2. �房中
+3. 待确认
+4. 已完�
+5. 作废
+
+第五项适�：
+
+- 文案由“异常�改为“作废�。
+- value 由 `exception` 改为 `voided`。
+- 数�徽标读� `stats.voided`，��继续读� `stats.exception`。
+- 点击�请求 `status=voided`，列表和 `total` 直接使用接�结果，�止�端当�页二次筛选。
+- 作废�片��红色�读样�，显示作废原因和作废时间。
+- “查看�必须�带该行自己的�宿需求 ID 作为 `requirementId`，进入作废历�详情。
+
+# 验收标准
+
+- 在 `http://192.168.100.160:9527/housekeeper/orders` ��显示“异常�筛选，显示“作废�。
+- “作废�徽标数�等于接� `stats.voided`。
+- 点击“作废�� Network 请求包� `status=voided`。
+- 多页作废数�的 `total`�分页与列表一致，��生�过滤当�页的问题。
+- 作废列表仅包� `voided=true` 的历�需求；正常�房中的当�需求�混入。
+- 作废行��留“查看�，详情为�读状�。
+
+# �端交付
+
+- �端 Issue：`wx/HL#5103`
+- �端分支：`fix/5103-house-voided-filter`
+- �入并部署测试环境�，�端�进行 Network 与页�验收。