--- schema: "hl-changelog/v2" ticket: "6077" title: "订单详情最后操作房务/车务人员 + 住宿每晚日期回显(二次告知)" consumer: "admin" author: "wx" change_type: "修改接口" backend_status: "deployed" gateway_status: "verified" frontend_status: "verified" frontend_owner: "mmg" frontend_ref: "a684caf2" target_release: "" verified_at: "2026-08-20" status_note: "二次告知:操作人字段(6077)早已部署测试服并网关实测,前端似乎未接;住宿每晚日期 stayDate 也确认已在返回。前端按本文取值即可。" updated_at: "2026-08-20" base: "dev-v3" generated: "2026-08-20T09:00:00+08:00" --- # 订单详情最后操作人 + 住宿每晚日期回显(二次告知) ## 背景 前端反馈:①订单详情页没看到「最后操作的房务/车务人员」;②住宿安排「第一晚没有具体时间」。 核实结论:**两块数据后端都已在返回**,是前端未接/未展示。本文把取值位置一次性写清。 ## 变更接口 | 接口 | 变更 | | --- | --- | | `GET /v3/admin/order/{id}`(订单详情) | 无结构变更。`data.overview.customerInfo.houseOperatorName` / `vehicleOperatorName` 已在返回(#6077 交付),本文再次告知取值位置 | | `GET /v3/admin/order/{id}/itinerary`(行程安排) | 无结构变更。`data.hotelGroup.assignments[].stayDate`(每晚日历日期)已在返回,本文再次告知取值位置 | ## 一、最后操作房务/车务人员(#6077,已部署测试服) 接口:`GET /v3/admin/order/{id}`(订单详情) 读这里(已实测有值): ```json { "data": { "overview": { "customerInfo": { "houseOperatorName": "王骁", "vehicleOperatorName": null } } } } ``` - `data.overview.customerInfo.houseOperatorName` — 最后操作房务人员姓名(无操作为 null) - `data.overview.customerInfo.vehicleOperatorName` — 最后操作车务人员姓名(无操作为 null) - 顶层 `data.houseOperatorName` 等同名字段当前为 null,**以 `overview.customerInfo` 内为准**。 - 为 null 时前端自行决定隐藏或显示「-」。 ## 二、住宿安排每晚日期(第一晚具体时间) 接口:`GET /v3/admin/order/{id}/itinerary` → `data.hotelGroup.assignments[]` 每条回配酒店都有 `stayDate`(该晚日历日期)+ `dayNumber`(第几晚),实测: ```json { "dayNumber": 1, "stayDate": "2026-08-19", "hotelName": "呼伦贝尔香格里拉大酒店", "roomType": "BIG_BED", "roomCount": 1 } ``` 出发日 2026-08-19 → 第一晚 `stayDate=2026-08-19`、第二晚 `2026-08-20`,已对齐。前端在住宿安排卡片每行渲染 `stayDate` 即可。 注意:只有**已配房**的订单 `assignments` 才有数据;未配房(需求阶段)为空数组属正常。 ## 前端动作 1. 操作人:订单详情页读 `data.overview.customerInfo.houseOperatorName` / `vehicleOperatorName` 展示。 2. 每晚日期:住宿安排卡片每行展示 `assignments[].stayDate`。 ## 验证证据 - 6077:PR #6080 已合并 dev-v3(merge commit 39c489673),测试服双实例 2026-08-19 15:02 重启;网关实测 `overview.customerInfo.houseOperatorName="王骁"` 有值。 - stayDate:2026-08-20 测试服网关实测订单 2090087196236095490,assignments 两条 stayDate=2026-08-19/2026-08-20 正确。 ## 关联 / 联系人 - Issue #6077:https://git.1814.love:8443/wx/HL/issues/6077 - 后端负责人:wx