docs(admin): 配房移除多家庭团familyIndex字段 (PR #4193)

changelogs-v2/2026-06/22_4193_配房移除多家庭团familyIndex字段_管理后台.md

@@ -0,0 +1,43 @@
+# 【修改接口·管理后台】配房/房间分配移除「多家庭团」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