From da06fa538c0e3372cdb25ac85080310f9650ebae Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 20 Jul 2026 17:07:57 +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=E5=A4=84=E7=90=86=E4=BD=9C=E5=BA=9F=E6=88=BF?=
 =?UTF-8?q?=E5=8A=A1=E9=9C=80=E6=B1=82=E5=8F=AA=E8=AF=BB=E8=AF=A6=E6=83=85?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...Ÿæˆ¿åŠ¡éœ€æ±‚å�ªè¯»ä¸ŽåŽ†å�²è¯¦æƒ…-修改接å�£-管ç�†å�Žå�°.md | 90 +++++++++++++++++++
 1 file changed, 90 insertions(+)
 create mode 100644 changelogs-v2/2026-07/71_5092_作废房务需求�读与历�详情-修改接�-管���.md

diff --git a/changelogs-v2/2026-07/71_5092_作废房务需求�读与历�详情-修改接�-管���.md b/changelogs-v2/2026-07/71_5092_作废房务需求�读与历�详情-修改接�-管���.md
new file mode 100644
index 0000000..9ac12ae
--- /dev/null
+++ b/changelogs-v2/2026-07/71_5092_作废房务需求�读与历�详情-修改接�-管���.md
@@ -0,0 +1,90 @@
+# 作废房务需求�读与历�详情（修改接�）
+
+## 目标�端
+
+- **端类型：管���（Web）**
+- **目标仓库：`mmg/hl-ui`**
+- **仓库地�：`https://git.1814.love:8443/mmg/hl-ui.git`**
+- **�调/验收环境：`http://192.168.100.160:9527`**
+- **�程�：无需处�**
+
+## 业务硬规则
+
+作废房务需求�能查看。页��得�供�系房务��系定制师�转���房�询房�替��移除�改价�清空�房�驳回�最终确认等任何业务�作。
+
+## 问题与原因
+
+�一订�调整�会�留旧的失活需求并生�新的生效需求。此�列表虽返回 `voided=true`，但�端未标红�未展示原因；点击旧行��按 `orderId` 请求详情，导致打开当�生效需求，出现旧记录与当��房串版。
+
+## 接��更
+
+### 1. 我的房务订�列表
+
+`GET /v3/admin/order/grab-pool/my-claims/hotel`
+
+作废行新增/明确字段：
+
+```json
+{
+  "id": "2078779808241668097",
+  "orderId": "2078739922130243586",
+  "requirementVersion": 2,
+  "voided": true,
+  "voidReason": "订�调整生�新版本，原需求已作废",
+  "voidedAt": "2026-07-20T16:52:29",
+  "primaryAction": {
+    "type": "VIEW",
+    "url": "/admin/order/2078739922130243586/arrange?requirementId=2078779808241668097"
+  }
+}
+```
+
+注�：列表字段 `id` 就是本行的房型需求 ID，打开详情时必须连�该 ID 传给详情接�，�能�传 `orderId`。
+
+### 2. 房务详情支�指定历�需求
+
+`GET /v3/admin/house/orders/{orderId}?requirementId={requirementId}`
+
+- �传 `requirementId`：��原行为，返回当�生效需求。
+- 传 `requirementId`：精确返回该订�的指定历�需求；ID �属于该订�时返回业务错误。
+- 作废历�需求�会混入当�需求的�房数�。
+
+详情新增顶层字段：
+
+```json
+{
+  "viewedRequirementId": "2078779808241668097",
+  "historicalRequirement": true,
+  "voided": true,
+  "voidReason": "订�调整生�新版本，原需求已作废",
+  "voidedAt": "2026-07-20T16:52:29"
+}
+```
+
+`requirement.history[]` �步增加 `requirementId`�`voided`�`voidReason`�`voidedAt`。
+
+历�作废详情中：
+
+- `actions` 下全部动作的 `enabled=false`；
+- `permissions.canEdit=false`ï¼›
+- `permissions.canSendMessage=false`ï¼›
+- `requirement.actions.canSendMessage=false`，其他写动作�样为 `false`；
+- `permissions.canViewMessage=true` �代表�许查看既有留言，�代表�回�。
+
+## 管���处��求
+
+1. `voided=true` 的列表行和详情必须使用明确的红色作废样�，并展示“已作废��`voidReason` 和作废时间。
+2. 作废列表行�能显示“查看�；�得显示“更多���或任何�系��转��房按钮。
+3. 点击作废行必须�带本行 `id` 作为 `requirementId` 请求详情，�得�用当�有效需求详情。
+4. 详情�� `voided=true` 或 `historicalRequirement=true`，�端必须�次强制�读并��全部业务�作，�能��赖�一个按钮字段。
+5. 人数调整�醒直接展示�端 `changeItems`；按通知 70，人数仅显示“总人数 4 → 3�，�显示�人/儿童等具体人员类型�化。
+
+## 验收
+
+- �一订�的作废旧行与当�有效行能明确区分，旧行标红并显示原因。
+- 旧行仅有“查看�，�存在任何写�作或�系�作。
+- 打开旧行� `viewedRequirementId` 等于该行 `id`，内容为旧需求快照，�出现当��房。
+- 作废详情仅�阅读，所有动作���或�用。
+- 删除一�出行人�，调整�醒显示“总人数 4 → 3�。
+
+�端关�：`wx/HL#5092`。