diff --git a/changelogs-v2/2026-08/19_6077_订单详情显示最后操作房务车务人员-修改接口-管理后台.md b/changelogs-v2/2026-08/19_6077_订单详情显示最后操作房务车务人员-修改接口-管理后台.md new file mode 100644 index 0000000..ac87d18 --- /dev/null +++ b/changelogs-v2/2026-08/19_6077_订单详情显示最后操作房务车务人员-修改接口-管理后台.md @@ -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