hl-api-changelog/changelogs-v2/2026-08/20_6077_订单详情最后操作人与住宿每晚日期回显-修改接口-管理后台.md
Mimingguang 5056ed423a
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
docs(changelog): #6077 二次告知前端 verified(操作人字段已展示)
订单详情客户信息卡新增展示最后操作房务/车务(v3Adapter 投影 overview.
customerInfo.houseOperatorName/vehicleOperatorName);住宿每晚 stayDate 前端早已
展示(RoomArrangeCard),零改动。frontend_ref=a684caf2。
2026-08-20 09:50:37 +08:00

3.4 KiB

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base, generated
schema ticket title consumer author change_type backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at status_note updated_at base generated
hl-changelog/v2 6077 订单详情最后操作房务/车务人员 + 住宿每晚日期回显(二次告知) admin wx 修改接口 deployed verified verified mmg a684caf2 2026-08-20 二次告知操作人字段6077早已部署测试服并网关实测,前端似乎未接;住宿每晚日期 stayDate 也确认已在返回。前端按本文取值即可。 2026-08-20 dev-v3 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}(订单详情)

读这里(已实测有值):

{
  "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}/itinerarydata.hotelGroup.assignments[]

每条回配酒店都有 stayDate(该晚日历日期)+ dayNumber(第几晚),实测:

{
  "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

验证证据

  • 6077PR #6080 已合并 dev-v3merge commit 39c489673,测试服双实例 2026-08-19 15:02 重启;网关实测 overview.customerInfo.houseOperatorName="王骁" 有值。
  • stayDate2026-08-20 测试服网关实测订单 2090087196236095490,assignments 两条 stayDate=2026-08-19/2026-08-20 正确。

关联 / 联系人