文件
hl-api-changelog/changelogs-v2/2026-08/05_5562_用车需求槽位模型改为全程槽(expand-生成按车型全程行,车务每槽派-1-辆管全程)-修改接口-管理后台.md
T
Mimingguang 87ed9d0a3f
changelog-filename-gate / validate (push) Failing after 2s
chore(changelog): 全量清理 implemented 存量——81 条复核翻 verified + 1 条改判 not_required + #5827 补登 frontend_ref
处置明细(mmg 2026-09-18):
- 68 条机械核验通过批量翻 verified:frontend_ref 均可达且为 v2.1 祖先、
  交付文件 HEAD 均在、关联 spec 批量 58 文件 891 例全绿。
- 11 条带演进史的例外逐条核后翻 verified:3 条交付自删文件(06_5610/
  07_5655/11_5810,删除即交付内容且终态保持);8 条被后续 changelog 预期
  演进(10_5784→#5810、07_5664/08_5592→#5827、07_5665→去槽位化 U1、
  01_5380/05_5356/06_5567/06_5581→settlement 族A扁平化与 mock 清理),
  status_note 均如实记录演进链。
- 05_5552 改判 not_required:frontend_ref 自述前端无需改动,grep 实证
  vehicleFeeAmount.js 直接读后端 calendarPrice/calendarPriceMissing。
- 11_5827 frontend_ref 原空,经核交付即 753503c8(向导 4 步改 3 步提交
  即派定),补登全哈希 753503c87cc635e5646b4368a8ed506746c79cf1。
另:保险域 2 条相邻条目(05_5530/06_5593)同标准复核翻 verified。
2026-07 历史月 45 条按规则不回扫,保持原状。
2026-09-18 15:56:52 +08:00

4.6 KiB
原始文件 Blame 文件历史

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 5562 用车需求槽位模型改为全程槽(expand 生成按车型全程行,车务每槽派 1 辆管全程) admin wx(GIT) 修改接口 deployed verified verified pi-main-session hl-admin@0da93eaef206f5daa85b99f45ecd0fd07873d5fc v2.1 2026-09-18 后端完成:PR #5568(全程槽模型)+ #5569(换版沿用修复)已合并 dev-v3 并部署 TEST;网关验证通过(全新展开 2 条全程行 / 换版保持全程行 / 每槽派 1 辆管全程 / 整组删 removedRowCount=1 / 按天派生展示不回归)。前端槽位列表与派车交互按全程槽语义适配。[mmg 2026-09-18 批量复核翻 verified] ref 0da93eae 可达且为 v2.1 祖先;交付文件 HEAD 均在;关联 spec 批量 891 例全绿。 2026-09-18 dev-v3 2026-08-05T22:45:18+08:00

用车需求槽位模型改为全程槽(expand 生成按车型全程行,车务每槽派 1 辆管全程)

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

关联 / 联系人

链接

联系人

  • 后端负责人: @wx

背景(wx 口径)

槽位数据模型本身改为全程槽:定制师需求(例 1 SUV + 1 商务 × 4 天)→ expand 默认生成 2 条全程行(SUV 全程槽 + 商务全程槽,各覆盖整个服务期),车务在每槽派 1 辆管全程的车,槽可修改/删除。不是按天 8 条散装切片 + 展示层聚合。存量按天数据不迁移(兼容运行),对账/逐日展示/行程/矩阵等按天界面从全程行派生,保持不变。

变更接口

方法 路径 来源
PUT /v3/admin/order/{id}/vehicle-requirement VehicleRequirementAdminController(order-v3)→ 触发 fleet expand

路径前缀 /v3/admin/** 与 /admin/fleet/** 已由网关登录/角色校验收口,无需新增网关规则。契约字段无变化:需求提交 VO(fleet[] 车型组合)与既有看板/详情/候选/派车/删除接口字段全部不变,变化在 Fleet 落库模型与派生行为。

模型行为(fleet_assignment)

  • 新展开:每需求×车型 1 条全程行——start_date/end_date 覆盖整个服务期,service_date/assignment_group_id 均为 NULL(1SUV+1商务×4天 = 2 条 unassigned 行)
  • 派车:create/batchCreate 在全程行上直接升级为 1 条 assigned 全程行(每槽 1 辆管全程);改派在槽上换车/司机
  • 删除:DELETE /admin/fleet/assignments/slots/{slotId} 整组删(removedRowCount=1)+ fleet_assignment_slot_removal 持久化防展开复活
  • 换版:服务期一致时全程行沿用(rebind 保持 group_id IS NULL);日期变化取消重建
  • 按天派生(显示/对账/快照层不变):看板 dailyVehiclePlan、矩阵、DAILY_V3 快照、Step2 canonical 候选、对账/保险均从全程行按服务期展开逐日

前端/调用方动作

  1. 车务槽位列表默认呈现"一条管全程"的槽位(详情 vehicleSlots[]、看板 assignmentSlots[] 已是全程区间语义);删除按钮调 DELETE /admin/fleet/assignments/slots/{slotId}(605007 已派拒绝/605012 不存在)
  2. 派车弹窗按全程区间提交(startDate=服务开始、endDate=服务结束、每槽 1 辆 1 司机);最终方案提交仍按逐日 dailyPlan[](同槽各日须同一车/司机,后端整槽聚合)
  3. 逐日细节(每日车/司机/价格/接送)继续用 dailyVehiclePlan,展示不变

验证证据

  • 定向测试:fleet verify 全绿(3159 用例 + Testcontainers);新增全程行展开/派车/换版沿用/DAILY_V3 派生/看板派生测试
  • 网关验证(TEST):全新展开 2 条全程行落库 → 换版保持全程行 → 每槽派 1 辆管全程(assigned 全程行)→ 整组删 removedRowCount=1 → 详情 1 条全程槽(canDelete/阻断原因)→ dailyVehiclePlan 派生 6 天不回归
  • 兼容性结论:存量按天数据兼容运行(不迁移);legacy 区间行迁移逻辑保留