docs(changelog): #6077 订单详情新增最后操作房务/车务人员 4 个可选字段(PR #6080)
所有检测均成功
changelog-filename-gate / validate (push) Successful in 2s
所有检测均成功
changelog-filename-gate / validate (push) Successful in 2s
GET /v3/admin/order/{id} 响应顶层及 overview.customerInfo 新增
houseOperatorId/houseOperatorName/vehicleOperatorId/vehicleOperatorName,
无操作/无对应需求时为 null,前端无必须动作。
这个提交包含在:
父节点
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-v3(39c489673)并部署 TEST(hl-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-v3(merge 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」口径。
|
||||
|
||||
## 关联 / 联系人
|
||||
|
||||
- Issue:https://git.1814.love:8443/wx/HL/issues/6077
|
||||
- PR:https://git.1814.love:8443/wx/HL/pulls/6080
|
||||
- 后端负责人:wx
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户