docs: 补充房务调整历史契约字段

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 证据；不得因普通浏览器无登录态改用插件或猜测实现。