4.3 KiB
4.3 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 | 5562 | 用车需求槽位模型改为全程槽（expand 生成按车型全程行，车务每槽派 1 辆管全程） | admin | wx(GIT) | 修改接口 | deployed | verified | pending | 后端完成：PR #5568（全程槽模型）+ #5569（换版沿用修复）已合并 dev-v3 并部署 TEST；网关验证通过（全新展开 2 条全程行 / 换版保持全程行 / 每槽派 1 辆管全程 / 整组删 removedRowCount=1 / 按天派生展示不回归）。前端槽位列表与派车交互按全程槽语义适配。 | 2026-08-05 | 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 候选、对账/保险均从全程行按服务期展开逐日
前端/调用方动作
- 车务槽位列表默认呈现"一条管全程"的槽位（详情
vehicleSlots[]、看板assignmentSlots[]已是全程区间语义）；删除按钮调DELETE /admin/fleet/assignments/slots/{slotId}（605007 已派拒绝/605012 不存在） - 派车弹窗按全程区间提交（
startDate=服务开始、endDate=服务结束、每槽 1 辆 1 司机）；最终方案提交仍按逐日dailyPlan[]（同槽各日须同一车/司机，后端整槽聚合） - 逐日细节（每日车/司机/价格/接送）继续用
dailyVehiclePlan，展示不变
验证证据
- 定向测试：fleet verify 全绿（3159 用例 + Testcontainers）；新增全程行展开/派车/换版沿用/DAILY_V3 派生/看板派生测试
- 网关验证（TEST）：全新展开 2 条全程行落库 → 换版保持全程行 → 每槽派 1 辆管全程（assigned 全程行）→ 整组删 removedRowCount=1 → 详情 1 条全程槽（canDelete/阻断原因）→ dailyVehiclePlan 派生 6 天不回归
- 兼容性结论：存量按天数据兼容运行（不迁移）；legacy 区间行迁移逻辑保留