docs(changelog): 二次告知前端-订单详情最后操作人(6077)+住宿每晚stayDate已返回

2026-08-20 01:34:13 +00:00
@@ -0,0 +1,93 @@
+---
+schema: "hl-changelog/v2"
+ticket: "6077"
+title: "订单详情最后操作房务/车务人员 + 住宿每晚日期回显（二次告知）"
+consumer: "admin"
+author: "wx"
+change_type: "修改接口"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: "mmg"
+frontend_ref: ""
+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