hl-api-changelog/changelogs-v2/2026-08/11_5810b_需求车型语句改车队组成写法-修改接口-管理后台.md
Mimingguang 23dfa84f64
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
chore(changelog): #5810b 前端 not_required(实证零改动)
2026-08-11 16:58:06 +08:00

3.8 KiB

schema, ticket, title, consumer, change_type, author, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
schema ticket title consumer change_type author backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at status_note updated_at base
hl-changelog/v2 5810 需求车型语句 requirementFleetText 格式调整:座位内联 + 加号连接商务车7座×1 + SUV5座×1 admin 修改接口 wx(GIT) deployed not_required not_required mmg 2026-08-11 前端实证 not_required(2026-08-11,mmg):本条仅后端 requirementFleetText 拼接格式变化(座位内联+加号连接),字段名/类型/位置/可空性全不变,接入方式零变化(原样显示)。grep 实证前端两消费点(AssignModal.vue:791、OrderDrawer.vue:115)均 `当前需求:{{ requirementFleetText }}` 原样渲染 + v-if 防空(null 不渲染),computed 纯 `String(...??'').trim()` 透传,零解析/零自拼(无 split/×/、/+ 处理),三条红线(不解析/不自拼/null 不渲染)全满足,后端新格式自动呈现。 2026-08-11 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 绿。