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