Mimingguang
87ed9d0a3f
changelog-filename-gate / validate (push) Failing after 2s
处置明细(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 条按规则不回扫,保持原状。
68 行
4.6 KiB
Markdown
68 行
4.6 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "5562"
|
||
title: "用车需求槽位模型改为全程槽（expand 生成按车型全程行，车务每槽派 1 辆管全程）"
|
||
consumer: "admin"
|
||
author: "wx(GIT)"
|
||
change_type: "修改接口"
|
||
backend_status: "deployed"
|
||
gateway_status: "verified"
|
||
frontend_status: "verified"
|
||
frontend_owner: "pi-main-session"
|
||
frontend_ref: "hl-admin@0da93eaef206f5daa85b99f45ecd0fd07873d5fc"
|
||
target_release: "v2.1"
|
||
verified_at: "2026-09-18"
|
||
status_note: "后端完成：PR #5568（全程槽模型）+ #5569（换版沿用修复）已合并 dev-v3 并部署 TEST；网关验证通过（全新展开 2 条全程行 / 换版保持全程行 / 每槽派 1 辆管全程 / 整组删 removedRowCount=1 / 按天派生展示不回归）。前端槽位列表与派车交互按全程槽语义适配。[mmg 2026-09-18 批量复核翻 verified] ref 0da93eae 可达且为 v2.1 祖先;交付文件 HEAD 均在;关联 spec 批量 891 例全绿。"
|
||
updated_at: "2026-09-18"
|
||
base: "dev-v3"
|
||
generated: "2026-08-05T22:45:18+08:00"
|
||
---
|
||
|
||
# 用车需求槽位模型改为全程槽（expand 生成按车型全程行，车务每槽派 1 辆管全程）
|
||
|
||
> 后端完成：PR #5568/#5569 已合并 dev-v3 并部署 TEST，网关验证 7/7 通过。
|
||
|
||
## 关联 / 联系人
|
||
|
||
### 链接
|
||
|
||
- **Issue**: [#5562](https://git.1814.love:8443/wx/HL/issues/5562)
|
||
- **PR**: [#5568](https://git.1814.love:8443/wx/HL/pulls/5568)（全程槽模型）、[#5569](https://git.1814.love:8443/wx/HL/pulls/5569)（换版沿用修复）
|
||
- **Merge commit**: [e051fb93d](https://git.1814.love:8443/wx/HL/commit/e051fb93d)、[41792d8b9](https://git.1814.love:8443/wx/HL/commit/41792d8b9)
|
||
|
||
### 联系人
|
||
|
||
- **后端负责人**: @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 区间行迁移逻辑保留
|