03f4599f91
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
前端零消费 vehicleCategoryLabel/vehicleCategoryKey(排车页卡头字段,#5904 新增 尚未接入),后端别名取值修复对前端透明,实证 not_required。
60 行
3.2 KiB
Markdown
60 行
3.2 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "5895"
|
||
title: "排车页槽位卡头车型大类标签修复——type_key 别名 normalize 成中文标签"
|
||
consumer: "admin"
|
||
change_type: "修复"
|
||
author: "wx(GIT)"
|
||
backend_status: "deployed"
|
||
gateway_status: "not_required"
|
||
frontend_status: "not_required"
|
||
frontend_owner: "mmg"
|
||
frontend_ref: ""
|
||
target_release: ""
|
||
verified_at: "2026-08-12"
|
||
status_note: "后端已修复并部署测试服，API 实测通过。排车页「车辆槽位 N」卡片头在 PR #5904 新增的 vehicleCategoryLabel 字段实测返回别名 suv2（应显示 SUV）：因为 fleet_vehicle_type.type_key 存的是别名，而 VehicleCategoryNormalizer.categoryLabel() 只认规范 key suv/mpv/bus/sedan，直接传入会原样返回别名。修复=先 normalize() 成规范 key 再取中文标签。实测订单 26-3698（蒙A-H7777 type_key=suv2）：vehicleCategoryKey 由 suv2 → suv、vehicleCategoryLabel 由 suv2 → SUV。"
|
||
updated_at: "2026-08-12"
|
||
base: "dev-v3"
|
||
---
|
||
|
||
# 排车页槽位卡头车型大类标签修复——type_key 别名 normalize 成中文标签（#5895）
|
||
|
||
> **服务**: hl-fleet-service
|
||
> **PR**: #5904（槽位头车型大类字段新增）+ #5907（别名标签修复，本条）
|
||
> **日期**: 2026-08-12
|
||
> **背景**: 用户要求排车页「车辆槽位 N」卡片头显示车型大类名（多个和车牌一样分割显示）。#5904 加了 vehicleCategoryKey/vehicleCategoryLabel 字段，但实测发现已派车辆的大类标签返回了别名 `suv2` 而非中文「SUV」。
|
||
|
||
---
|
||
|
||
## 修复内容（对前端透明，无接口契约变化）
|
||
|
||
**根因**：`fleet_vehicle_type.type_key` 存的是别名（如 `suv2`、`mpv2`），`BoardOrderService.toVehicleSlotVO` 直接把它传给 `VehicleCategoryNormalizer.categoryLabel()`，而该方法只认规范 key `suv/mpv/bus/sedan`，未匹配时**原样返回**别名 → 前端拿到 `suv2`。
|
||
|
||
**修复**：先 `VehicleCategoryNormalizer.normalize(info.getCategoryKey())` 归一别名到规范 key，再取 `categoryLabel()`；归一失败（null）时保留原值兜底。
|
||
|
||
```java
|
||
String categoryKey = VehicleCategoryNormalizer.normalize(info.getCategoryKey());
|
||
vehicleCategoryKey = categoryKey == null ? info.getCategoryKey() : categoryKey;
|
||
vehicleCategoryLabel = VehicleCategoryNormalizer.categoryLabel(vehicleCategoryKey);
|
||
```
|
||
|
||
**字段口径（#5904 原有，本条不改）**：
|
||
- 未派：`vehicleCategoryKey/Label` = 需求车型大类（如 `suv/SUV`）
|
||
- 已派：`vehicleCategoryKey/Label` = 实际车辆车型大类 normalize 后的规范 key + 中文标签
|
||
|
||
## 验证证据（测试服 API 实测，订单 26-3698 / 2086270138171994114）
|
||
|
||
`GET /admin/fleet/board/orders/2086270138171994114` → `vehicleSlots[0]`：
|
||
|
||
| 字段 | 修复前 | 修复后 |
|
||
|---|---|---|
|
||
| vehicleCategoryKey | `suv2` | `suv` |
|
||
| vehicleCategoryLabel | `suv2` | `SUV` |
|
||
|
||
DB 佐证：`fleet_vehicle` 蒙A-H7777 的 `vehicle_type_id` 对应 `fleet_vehicle_type.type_key=suv2`（别名，非规范 key），确认是别名 → normalize 路径生效。
|
||
|
||
## 测试
|
||
|
||
- 新增用例 `BoardOrderServiceTest.queryOrderDetail_vehicleSlots_vehicleCategoryAliasKeyNormalized`：已派槽位 `type_key=suv2` 别名 → normalize 成 `SUV`。
|
||
- `BoardOrderServiceTest` 125/125 绿。
|