From 26ff684c82b5e16792096a37878007a0acdd406b Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 22 Jun 2026 10:53:40 +0800 Subject: [PATCH] =?UTF-8?q?docs(admin):=20=E9=85=8D=E6=88=BF=E7=A7=BB?= =?UTF-8?q?=E9=99=A4=E5=A4=9A=E5=AE=B6=E5=BA=AD=E5=9B=A2familyIndex?= =?UTF-8?q?=E5=AD=97=E6=AE=B5=20(PR=20#4193)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...房移除多家庭团familyIndex字段_管理后台.md | 43 +++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 changelogs-v2/2026-06/22_4193_配房移除多家庭团familyIndex字段_管理后台.md diff --git a/changelogs-v2/2026-06/22_4193_配房移除多家庭团familyIndex字段_管理后台.md b/changelogs-v2/2026-06/22_4193_配房移除多家庭团familyIndex字段_管理后台.md new file mode 100644 index 0000000..e178db8 --- /dev/null +++ b/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