docs(changelog): #6077 订单详情新增最后操作房务/车务人员 4 个可选字段(PR #6080)
所有检测均成功
changelog-filename-gate / validate (push) Successful in 2s

GET /v3/admin/order/{id} 响应顶层及 overview.customerInfo 新增
houseOperatorId/houseOperatorName/vehicleOperatorId/vehicleOperatorName,
无操作/无对应需求时为 null,前端无必须动作。
这个提交包含在:
API Changelog Bot 2026-08-19 07:28:59 +00:00
父节点 7e1e6657ec
当前提交 ebbd8ad6a3

查看文件

@ -0,0 +1,53 @@
---
schema: "hl-changelog/v2"
ticket: "6077"
title: "订单详情显示最后操作的房务/车务人员"
consumer: "admin"
author: "wx"
change_type: "修改接口"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "not_required"
frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "后端完成PR #6080 已合并 dev-v339c489673并部署 TESThl-order-service-v3 双实例 8086/8186,2026-08-19 15:02 重启)。订单详情响应新增最后操作房务/车务人员 ID 与姓名共 4 个可选只读字段,无操作/无对应需求时为 null,前端按需取读即可、不展示无影响。"
updated_at: "2026-08-19"
base: "dev-v3"
generated: "2026-08-19T15:22:40+08:00"
---
# 订单详情显示最后操作的房务/车务人员(#6077
## 背景
订单详情页需要看到该订单最后一笔配房、派车分别由哪位房务/车务人员操作,便于追溯责任。取 `order_hotel_requirement` / `order_vehicle_requirement``updated_by`,经 `admin_user` 解析为姓名。
## 变更接口
| 接口 | 变更 |
| --- | --- |
| `GET /v3/admin/order/{id}`订单详情,9 Tab 聚合) | **响应新增字段**(均可选只读,无操作/无对应需求时为 null,不影响既有任何字段`houseOperatorId`Long,顶层,最后操作房务人员 ID`vehicleOperatorId`Long,顶层,最后操作车务人员 ID`houseOperatorName`String,顶层 + `overview.customerInfo` 内均有,最后操作房务人员姓名)、`vehicleOperatorName`String,顶层 + `overview.customerInfo` 内均有,最后操作车务人员姓名) |
## 行为口径
- 4 个字段均为**只读、可选**:该订单无对应用车/用房需求或尚无操作时值为 null,接口不报错。
- 纯新增字段,不影响既有任何字段的取值与结构。
- 姓名来源为管理后台用户表,按最后操作人 ID 解析;解析不到时同样为 null。
## 前端动作
无必须动作。需要展示「最后操作房务/车务」时读 `overview.customerInfo.houseOperatorName` / `vehicleOperatorName`(或顶层同名字段)即可,为 null 时前端自行决定隐藏或显示「-」。
## 验证证据
- 单测新增 113 行覆盖(正常有值 / 无需求为 null
- 部署PR #6080 squash 合并 dev-v3merge commit `39c489673`);测试服 hl-order-service-v3 双实例 8086/8186 于 2026-08-19 15:02 重启。
- 网关实测TEST,admin token`GET /v3/admin/order/2089928715696746498` 返 200,`overview.customerInfo.houseOperatorName="王骁"`(该单已配房),`vehicleOperatorName=null`(该单未派车),符合「有操作给姓名 / 无操作为 null」口径。
## 关联 / 联系人
- Issuehttps://git.1814.love:8443/wx/HL/issues/6077
- PRhttps://git.1814.love:8443/wx/HL/pulls/6080
- 后端负责人wx