changelog(#5810): requirementFleetText 格式改车队组成写法(PR #5817)
所有检测均成功
changelog-filename-gate / validate (push) Successful in 2s

这个提交包含在:
API Changelog Bot 2026-08-11 09:42:11 +08:00
父节点 44e1599741
当前提交 28e3bc46cb

查看文件

@ -0,0 +1,65 @@
---
schema: "hl-changelog/v2"
ticket: "5810"
title: "需求车型语句 requirementFleetText 格式调整:座位内联 + 加号连接商务车7座×1 + SUV5座×1"
consumer: "admin"
change_type: "修改接口"
author: "wx(GIT)"
backend_status: "deployed"
gateway_status: "not_required"
frontend_status: "pending"
frontend_owner: "mmg"
frontend_ref: ""
target_release: ""
verified_at: "2026-08-11"
status_note: ""
updated_at: "2026-08-11"
base: "dev-v3"
---
# 需求车型语句格式调整(#5810 展示口径跟进,PR #5817
> **服务**: hl-fleet-service
> **PR**: #5817(已合并 dev-v3,已部署测试服
> **日期**: 2026-08-11
> **关联**: `11_5810_换版槽位人工制-需求语句与派车日期门禁-修改接口-管理后台.md` §1 的格式部分被本条取代;配套布局要求见 `11_frontend_派单Step2需求展示区与统一选车弹窗空白-前端缺陷-管理后台.md` §3
---
## 变更接口
`GET /admin/fleet/board/orders/{orderId}` 根级字段 `requirementFleetText`,**仅格式变化,字段名/类型/位置/可空性全不变**
| | 拼接规则 | 26-9313 实例 |
|---|---------|-------------|
| 改前 | `{车型}×{数量}({座位}座)`,中文顿号 `、` 连接 | `商务车×1(7座)、SUV×1(5座)` |
| **改后** | `{车型}{座位}座×{数量}`,**` + `**(空格加号空格)连接 | **`商务车7座×1 + SUV5座×1`** |
座位数内联到车型后、多项用加号连接,对齐车务口头表述车队组成的习惯写法,一眼读出"这单要几台什么车"wx 2026-08-11 定稿)。
**兜底语义完全不变**:车型标签走归一字典(未知车型回退原始编码)、`count` 为空或非正按 1、`seats` 为空时省略座位段(形如 `SUV×2`)、需求不可达时整字段为 `null`
## 前端影响
**接入方式零变化** —— 本字段的用法一直是「后端给什么就原样显示什么」:
- ✅ 直接把字符串渲染出来即可
- 🔴 **不要解析这个字符串**(不要按 `×`/`、`/`+` 切分取车型或数量)
- 🔴 **不要自己按 `vehicleSlots` 或需求明细拼**——拼法口径归后端一处收口,否则日后改口径要改两边
- `null` 时整块不渲染不要出现「当前需求」空冒号或「当前需求null」
展示位置见配套 changelog派单弹窗 Step2「排车」页槽位表格下方常驻一行,形如 `当前需求商务车7座×1 + SUV5座×1`
## 验证证据
2026-08-11 09:4x,PR #5817 合并 dev-v3 → Deploy Panel 部署 hl-fleet-serviceexit_code=0→ SSH 确认进程 09:40 重启 → 网关 `https://api.test.1814.love:9443` 车务管理员 token 实测:
| 订单 | `requirementFleetText` 实测值 |
|------|------------------------------|
| 26-9313两车型混合 | `商务车7座×1 + SUV5座×1` ✅ |
| 26-3698 | `商务车7座×2` |
| 26-0821 | `商务车7座×2` |
| 26-3420 / 26-9452 / 26-7944 | `SUV5座×1` |
| 26-4789 / 26-6575 / 26-3281 | `商务车7座×1` |
单测:`BoardOrderServiceTest` 4 个 requirementFleetText 用例全绿(常规两项 / 空需求返 null / 缺座位缺数量兜底 / 未知车型回退原始值;fleet 全量 3382 tests 除存量环境依赖用例外全绿;`FleetRedLineArchTest` 12 tests 绿。