2.6 KiB
2.6 KiB
【修改接口·管理后台】配房/房间分配移除「多家庭团」familyIndex(家庭序号)字段 (#4193)
PR: #4193 | 服务: hl-order-service-v3 | 更新时间: 2026-06-22
1. 背景
家庭概念已废弃。「多家庭团」对应字段 familyIndex（家庭序号）原为「一个团/订单拆成多个家庭分别配房」设计（仅团期 GROUP 多家庭场景使用，团期配房已暂缓，散客单家庭恒为 1）。本次彻底移除 familyIndex：相关请求/响应 VO 不再包含该字段，DB 列已 DROP。
前端如有「家庭序号」相关入参/展示/排序逻辑，请一并清理。
2. 变更清单（familyIndex 字段移除）
| # | 场景 | 方向 | 受影响字段 |
|---|---|---|---|
| 1 | 配房批量提交项 | 请求 | AssignmentItemReqVO.familyIndex 移除 |
| 2 | 配房提交结果项 | 响应 | AssignmentSubmitRespVO.familyIndex 移除 |
| 3 | 房间分配新增 | 请求 | RoomAssignReqVO.familyIndex 移除（含原「familyIndex 连续性校验」一并取消） |
| 4 | 房间分配视图 | 响应 | RoomAssignmentVO.familyIndex / HotelAssignmentVO.familyIndex 移除 |
| 5 | 订单详情·行程配房项 | 响应 | 订单详情 itinerary 内配房项 familyIndex 移除 |
| 6 | 房控扣库存(内部) | 请求 | HouseDeductRoomStockReqVO.familyIndex 移除 |
3. 行为变化
- 入参：上述请求 VO 传入
familyIndex将被忽略（字段已不存在，多传无副作用，但建议前端移除）。 - 出参：上述响应 VO 不再返回
familyIndex字段。 - 排序：配房记录列表原「按
dayNumber、familyIndex升序」→ 现「按dayNumber升序」（同日多行按写入顺序稳定）。展示层若依赖 familyIndex 分组/排序，改为仅按 dayNumber。 - DB：
order_room_assignment/house_hotel_assignment的family_index列已 DROP（order_hotel_assignment此前已移除）。
4. 前端处理建议
- 移除配房表单/提交体中的「家庭序号」输入与
familyIndex入参。 - 移除配房列表/订单详情中对
familyIndex的读取、分组、展示。 - 多家庭分组 UI（如有）整体下线。
5. 影响评估 / 回滚
- 兼容性：响应去字段属破坏性变更（前端读
familyIndex将得 undefined）；入参去字段向后兼容（多传被忽略）。 - 回滚：revert PR #4193 重新部署 hl-order-service-v3（注：DB 列已 DROP，回滚需配套补迁移，建议前滚不回滚）。