78 行
3.5 KiB
Markdown
78 行
3.5 KiB
Markdown
---
|
||
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` 内均有，最后操作车务人员姓名） |
|
||
|
||
## 响应示例
|
||
|
||
`GET /v3/admin/order/{id}` 返回（仅列本次新增字段，其余字段省略）：
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"houseOperatorId": null,
|
||
"vehicleOperatorId": null,
|
||
"houseOperatorName": null,
|
||
"vehicleOperatorName": null,
|
||
"overview": {
|
||
"customerInfo": {
|
||
"houseOperatorName": "王骁",
|
||
"vehicleOperatorName": null
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
说明：该单已配房未派车，故 `overview.customerInfo.houseOperatorName="王骁"` 有值、`vehicleOperatorName=null`；顶层 4 字段当前实现为 null（以 `overview.customerInfo` 内同名字段为准），前端读 `overview.customerInfo.houseOperatorName` / `vehicleOperatorName` 即可。
|
||
|
||
## 行为口径
|
||
|
||
- 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
|