From 62ab4cdb2c53ecf954b3765803b58d635235a812 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sun, 19 Jul 2026 15:56:38 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E6=88=BF=E5=8A=A1?=
 =?UTF-8?q?=E8=B0=83=E6=95=B4=E5=8E=86=E5=8F=B2=E5=A5=91=E7=BA=A6=E5=AD=97?=
 =?UTF-8?q?=E6=AE=B5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../64_房务契约补充_调整历史字段明确.md       | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 changelogs-v2/2026-07/64_房务契约补充_调整历史字段明确.md

diff --git a/changelogs-v2/2026-07/64_房务契约补充_调整历史字段明确.md b/changelogs-v2/2026-07/64_房务契约补充_调整历史字段明确.md
new file mode 100644
index 0000000..273ca4d
--- /dev/null
+++ b/changelogs-v2/2026-07/64_房务契约补充_调整历史字段明确.md
@@ -0,0 +1,30 @@
+# 房务契约补充：作废与订单调整历史字段
+
+前端反馈“作废、人数、改期、增晚缺少明确出参”。现按当前后端实现明确如下，禁止按页面文案猜测：
+
+## 房务详情/需求历史
+
+接口：`GET /admin/house/orders/{orderId}`、`GET /admin/house/orders/{orderId}/requirement-history`
+
+- `requirement.recentHistory[].status`：`PENDING`、`PROCESSING`、`DONE`、`REJECTED_TO_CONSULTANT`、`REJECTED_TO_ADMIN`、`SUPERSEDED`。
+- `requirement.recentHistory[].returnReason`：退回/驳回原因；未退回为 `null`。
+- `requirement.recentHistory[].returnedBy`、`returnedAt`：退回操作人和时间；未退回为 `null`。
+- 作废订单本身使用 `order.status` 及 `statusLabel`；房务流程使用 `progress.houseStatus` 及 `houseStatusLabel`，不能把二者混用。
+
+## 人数、改期、增晚的调整记录
+
+接口：`GET /v3/admin/order/{orderId}/adjustment-record`
+
+`items[].type` 是稳定枚举，`label/before/after` 已由后端生成，前端直接展示：
+
+- `HEADCOUNT`：人数变化；`before/after` 为调整前后人数摘要。
+- `DEPART_DATE`：改期；`before/after` 为旧/新出发日期。
+- `TRIP_DAYS`：增减行程天数；`before/after` 为旧/新“X天Y晚”摘要。
+- `TRAVELER_EDIT`：仅出行人资料字段编辑，不代表人数变化。
+- `HOTEL_REQ`：住宿需求调整。
+
+调整记录同时返回 `occurredAt`、`changeCount`、`statusNote`、`balanceBefore`、`balanceAfter`。新增出行人明细不从房务详情猜测，使用既有订单出行人接口；`HEADCOUNT` 记录用于展示人数前后变化。
+
+## 验收说明
+
+当前后端测试环境已有登录态，后续验收使用仓库 CDP 调试浏览器和 Network 证据；不得因普通浏览器无登录态改用插件或猜测实现。