26 行
2.2 KiB
Markdown
26 行
2.2 KiB
Markdown
# 配房详情逐日支持「一天多家酒店/多房型」— `currentAssignment` 单数改 `currentAssignments` 列表
|
||
|
||
> 变更类型：✨ 新增字段（修既有折叠 bug，**房务管家前端需迁移读列表**）
|
||
> 端类型：管理后台（房务管家·配房详情）
|
||
> 日期：2026-06-26 ｜ 工单：#4435 ｜ PR：#4436 ｜ 服务：hl-order-service-v3（双实例已部署 health UP，测试服实测通过）
|
||
|
||
---
|
||
|
||
## 背景/根因
|
||
配房**单日确认可选多家酒店、多个房型**，一天可有多行已配（数据层本就支持，现网已有一天 3 家的订单）。但详情 `GET /admin/house/orders/{orderId}` 原把一天的多行配房**折叠成只显示 1 家**（`currentAssignment` 是单数）。本次修复让详情逐日返回**全部**已配。
|
||
|
||
## 字段变更（`itinerary[]`）
|
||
- **新增 `itinerary[].currentAssignments`（数组）**：当天**全部**已配房，每项结构与原 `currentAssignment` 完全一致（assignmentId / hotelId / roomTypeId / hotelName / roomCategory / roomCount / protoPrice / sellPrice，金额与雪花 ID 均字符串）。
|
||
- **`itinerary[].currentAssignment`（单数）保留但已废弃**：= `currentAssignments[0]`（首个）。一天多家时只含首个，仅为向后兼容。
|
||
|
||
## 前端必改（mmg）
|
||
- 配房详情逐日展示 **改读 `currentAssignments`（列表）** 渲染当天全部已配酒店/房型，不要再只读单数 `currentAssignment`（否则一天多家只显示第一家）。
|
||
- 「单日确认」可勾选**多家候选**：对每个选中的候选逐个调 `POST /v3/admin/order/inquiry/{inquiryId}/reply` `convertToAssignment=true`（各落一行配房），该天 `currentAssignments` 即返回多家。
|
||
- 「移除某家」仍走 `DELETE /v3/admin/order/assignments/{assignmentId}`（按 currentAssignments[].assignmentId 精确删某一家）。
|
||
|
||
## 测试服实测
|
||
- 一天 3 家的订单详情逐日返回 `currentAssignments` 含全部 3 家（酒店名/房型/价格齐全），`currentAssignment`=首个；一天 1 家时列表 1 项、单数同值（不回归）。
|
||
- 全量单测 4671 通过，ArchTest 全绿。
|
||
|
||
> 关联：#4427/#4433（询房候选流程 + 询房中天级态 + 单日确认同步协议价）。本单补齐「一天多家」展示。
|