hl-api-changelog/changelogs-v2/2026-08/06_5573_派车候选按槽位座位需求校验(SUV槽5座不再误标座位不足)-修改接口-管理后台.md
Mimingguang da4c53221e
所有检测均成功
changelog-filename-gate / validate (push) Successful in 1s
chore(changelog): 完成 #5558 #5573 管理后台适配
修改原因:保单在线查看与槽位候选请求契约已完成管理后台交付。

修改内容:回写 implemented、v2.1 业务提交引用和验证日期。

实际验证:pnpm checkpoint 全量通过。

Changelog:#5558、#5573 对应 source 文档。
2026-08-06 09:52:20 +08:00

3.4 KiB

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 5573 派车候选按槽位座位需求校验SUV槽5座不再误标座位不足 admin wx(GIT) 修改接口 deployed verified implemented pi-main-session hl-admin@3e535fe3ad6a406529eb95d7787cefe11b9584cd v2.1 2026-08-06 后端完成PR #5578 已合并 dev-v3 并部署 TEST;网关验证通过商务槽 7 座/SUV 槽 5 座在整单 10-12 人下不再误标座位不足,车型匹配保留)。候选接口字段无变化,前端零改动;需确认派车弹窗仍传 fleetItemIndex/requiredVehicleType。 2026-08-06 dev-v3 2026-08-06T01:05:02+08:00

派车候选按槽位座位需求校验SUV槽5座不再误标座位不足

后端完成PR #5578 已合并 dev-v3 并部署 TEST,网关验证 4/4 通过。

关联 / 联系人

链接

联系人

  • 后端负责人: @wx

背景

26-4220乘客 10 人,SUV 槽 5 座 + 商务槽 7 座)派车:候选面板此前按整单 headcount10 人校验每辆候选车,SUV 槽所有 SUV5-7 座)误标"需求不匹配·座位不足"(可选但误导),考斯特 19 座也被标不匹配。

口径

槽位级派车按槽位座位需求校验SUV 槽 5 座 → 车辆座位数 ≥ 5 即匹配;乘客分配跨槽SUV 载 4 + 商务载 6 = 10。车型匹配保留SUV 槽优先 SUV,其他车型仍标不匹配原因

变更接口

方法 路径 来源
POST /admin/fleet/assignments/candidates AssignmentControllerfleet

路径前缀 /admin/fleet/** 已由网关登录/角色校验收口,无需新增网关规则。请求/响应字段无变化:后端从 order-v3 当前需求按 fleetItemIndexcount 展开定位)推导槽位要求座位数;推导不到(缺 orderId/fleetItemIndex 或需求不可达)时回退整单 headcount 旧行为。

行为变化

  • seatsEnough / requirementMatched 的座位维度:有槽位座位需求时按"车辆座位数 ≥ 槽位要求座位数"判定(不再用整单 headcount
  • 车型匹配(requiredVehicleType vs 车辆车型 key逻辑不变
  • headcount 参数保留(展示/回退用),无字段删除

前端/调用方动作

  1. 派车弹窗保持传 fleetItemIndex(当前槽位序号)与 requiredVehicleType(槽位车型)——修复依赖这两个参数定位槽位座位需求
  2. 展示逻辑不变:seatsEnough=false 才标"座位不足",requirementMatched=false 才标"需求不匹配"

验证证据

  • 定向测试AssignmentCandidateServiceTest 43/43+2槽位 5 座配 10-12 人订单不误标 / 无槽位序号回退 headcount;fleet verify 3143 用例全绿
  • 网关验证TEST商务槽 7 座headcount=107 座车 seatsEnough=true;SUV 槽 5 座headcount=12SUV 5-7 座 seatsEnough=true;mpv 车在 suv 槽仍 requirementMatched=false车型不匹配正确标注
  • 兼容性结论:无契约变化;未传 fleetItemIndex 的旧调用保持原 headcount 校验