5056ed423a
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
订单详情客户信息卡新增展示最后操作房务/车务(v3Adapter 投影 overview. customerInfo.houseOperatorName/vehicleOperatorName);住宿每晚 stayDate 前端早已 展示(RoomArrangeCard),零改动。frontend_ref=a684caf2。
94 行
3.4 KiB
Markdown
94 行
3.4 KiB
Markdown
---
|
||
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
|