32 行
2.2 KiB
Markdown
32 行
2.2 KiB
Markdown
# 改行程天数(减天)级联重置酒店配房 + 还原库存（前端对接）
|
||
|
||
> 模块：订单调整（adjustment）/ 房务配房（管理后台）
|
||
> 类型：后端 bug 修复（PR #4491 已合 dev-v3 + 测试服实测生效）+ **前端需配合一项**
|
||
> 日期：2026-06-28
|
||
|
||
## 背景 / 修了什么
|
||
|
||
定制师调整订单**减少行程天数**后，原先房务侧「超出新天数范围那几晚」的已配房 + 已扣 resource 库存**完全不被清理、永久泄漏**（2 天行程却挂着 3 晚酒店配房、第 3 晚库存永久占用）。
|
||
|
||
现已修复（与「改出发日期」同款级联）：减行程天数提交后，后端自动
|
||
- **软删超出新范围的酒店配房行** + **还原对应 resource 库存**；
|
||
- 把该订单的酒店需求**重版回抢单池**（回到「待配房」），房务重新认领/配房；
|
||
- 订单 room_control 回 PENDING、生成「需求变更(REQUIREMENT_ADJUSTED)」待办。
|
||
|
||
测试服实测：4 天 3 晚→配 3 晚确认(扣库存)→减到 2 天 → 第 3 晚 3 行配房全软删、`stock_used` 还原、需求回「待配房」。
|
||
|
||
## 前端需配合（1 项）
|
||
|
||
**减行程天数时，请同时下发裁剪后的酒店需求 `hotelRequirement.days`（只保留新天数范围内的晚）。**
|
||
|
||
- 后端库存泄漏已彻底修复（超范围配房软删 + 库存还原，与前端是否下发裁剪无关）。
|
||
- 但若前端减天数时**只改 itinerary、不同步下发裁剪后的 `hotelRequirement.days`**，则重版后的新「待配房」需求的 days 模板仍含「那一晚」的天条目（不影响库存、不影响 active 配房=0，仅房务重新配房时会多看到一晚空档）。前端同步裁剪即完全对齐。
|
||
|
||
另：请确认前端「改行程天数」入口对 CORE（短途/定制）产品是否开放；本修复对任何减天数路径都生效。
|
||
|
||
## 影响接口
|
||
- `POST /v3/admin/order/{orderId}/adjustment/submit`（itinerary 减天数分支，行为增强，入参结构不变）
|
||
- 房务侧详情/日历/待办随之反映（需求回待配房、库存释放、REQUIREMENT_ADJUSTED 待办）
|
||
|
||
后端无需前端改即不再泄漏库存；前端配合下发裁剪 days 可让重配体验完全一致。
|