44 行
2.6 KiB
Markdown
44 行
2.6 KiB
Markdown
# 【修改接口·管理后台】配房/房间分配移除「多家庭团」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，回滚需配套补迁移，建议前滚不回滚）。
|
||
|
||
## 6. 关联
|
||
|
||
- **PR**: [#4193](https://git.1814.love:8443/wx/HL/pulls/4193)（前端反馈驱动，无关联 Issue）
|
||
- **后端负责人**: @wx
|