31 行
1.8 KiB
Markdown
31 行
1.8 KiB
Markdown
# 房务契约补充：作废与订单调整历史字段
|
||
|
||
前端反馈“作废、人数、改期、增晚缺少明确出参”。现按当前后端实现明确如下，禁止按页面文案猜测：
|
||
|
||
## 房务详情/需求历史
|
||
|
||
接口：`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 证据；不得因普通浏览器无登录态改用插件或猜测实现。
|