From fcb002f6628f4c10a1dcc0ea6c9553113d6fcb8a Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 20 Jul 2026 17:43:23 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A6=81=E6=B1=82=E8=AE=A2=E5=8D=95?=
 =?UTF-8?q?=E8=AF=A6=E6=83=85=E5=A2=9E=E5=8A=A0=E4=BD=9C=E5=BA=9F=E8=AE=B0?=
 =?UTF-8?q?=E5=BD=95=E5=85=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...ºŸæˆ¿åŠ¡éœ€æ±‚å�ªè¯»ä¸ŽåŽ†å�²è¯¦æƒ…-修改接å�£-管ç�†å�Žå�°.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/changelogs-v2/2026-07/71_5092_作废房务需求�读与历�详情-修改接�-管���.md b/changelogs-v2/2026-07/71_5092_作废房务需求�读与历�详情-修改接�-管���.md
index 33da574..64d8a62 100644
--- a/changelogs-v2/2026-07/71_5092_作废房务需求�读与历�详情-修改接�-管���.md
+++ b/changelogs-v2/2026-07/71_5092_作废房务需求�读与历�详情-修改接�-管���.md
@@ -98,6 +98,23 @@ GET /admin/house/orders/2078739922130243586/requirement-history
 4. 详情�� `voided=true` 或 `historicalRequirement=true`，�端必须�次强制�读并��全部业务�作，�能��赖�一个按钮字段。
 5. 人数调整�醒直接展示�端 `changeItems`；按通知 70，人数仅显示“总人数 4 → 3�，�显示�人/儿童等具体人员类型�化。
 
+### 当�订�详情增加“作废记录�入�
+
+在当�有效订�的房务详情中增加按钮：`作废记录（N）`，让房务�必返回列表寻找红色�片。
+
+- `N` 为该订�历�需求中 `voided=true` 的数�；没有作废记录时���按钮或显示�用的 `作废记录（0）`。
+- 按钮建议放在详情标题区或需求信�区，与普通业务写�作分开，��误认为�以��作废需求。
+- 点击�打开�读抽屉/弹窗，列出该订�全部作废需求，至少展示：需求版本��交/作废时间�作废原因�原状�。
+- 列表数��使用详情�应的 `requirement.history[]`，按 `voided=true` 过滤；�项必须使用自身 `requirementId`。
+- 点击��“查看详情�时调用：
+
+```text
+GET /admin/house/orders/{orderId}?requirementId={该�requirementId}
+```
+
+- 历�详情继续执行严格�读规则，�能关闭/返回，�能�系�转���房�清空�驳回�最终确认或执行其他业务�作。
+- 作废记录列表按 `voidedAt DESC` 展示，最新作废记录在�；本入��改�“我的订��主列表中作废�片统一置底的规则。
+
 ## 验收
 
 - �一订�的作废旧行与当�有效行能明确区分，旧行标红并显示原因。
@@ -105,5 +122,6 @@ GET /admin/house/orders/2078739922130243586/requirement-history
 - 打开旧行� `viewedRequirementId` 等于该行 `id`，内容为旧需求快照，�出现当��房。
 - 作废详情仅�阅读，所有动作���或�用。
 - 删除一�出行人�，调整�醒显示“总人数 4 → 3�。
+- 当�有效订�详情显示“作废记录（1）�；点击�看到该订�的作废需求列表，并能打开对应�读历�详情。
 
 �端关�：`wx/HL#5092`。