hl-api-changelog/changelogs-v2/2026-08/19_6077_订单详情显示最后操作房务车务人员-修改接口-管理后台.md

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	not_required					后端完成：PR #6080 已合并 dev-v3（39c489673）并部署 TEST（hl-order-service-v3 双实例 8086/8186，2026-08-19 15:02 重启）。订单详情响应新增最后操作房务/车务人员 ID 与姓名共 4 个可选只读字段，无操作/无对应需求时为 null，前端按需取读即可、不展示无影响。	2026-08-19	dev-v3	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} 返回（仅列本次新增字段，其余字段省略）：

{
  "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：wx/HL#6077
• PR：wx/HL#6080
• 后端负责人：wx