docs(changelog): hand off configured vehicle details (#5254)

修改原因：hl-ui changelog loop 需要把前端消费进度回写到契约源，避免领取、实现状态与实际交付脱节。

修改内容：将 frontend_status 与已有 legacy frontend 同步为 implemented，记录负责人 hl-ui-codex，并关联 mmg/hl-ui@cd8aff9b0c6499a1dee1b9c3ca00ddbceb4b5aed；发布和验收字段保持不变。

实际验证：回写器已校验目标文件、状态单调性、提交范围和 Front Matter 内容，提交只包含当前 changelog。

Frontend-Status: tools/mcp-api-sync/.changelog-repo/changelogs-v2/2026-07/25_5245_行程短链预览与同槽位改派解析-修改接口-管理后台.md

changelogs-v2/2026-07/25_5245_行程短链预览与同槽位改派解析-修改接口-管理后台.md

@@ -4,15 +4,15 @@ ticket: "5245"
 title: "行程短链预览与同槽位改派解析"
 consumer: "admin"
 change_type: "修改接口"
-backend_status: "pending"
-gateway_status: "pending"
-frontend_status: "pending"
-frontend_owner: ""
-frontend_ref: ""
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "implemented"
+frontend_owner: "hl-ui-codex"
+frontend_ref: "mmg/hl-ui@cd8aff9b0c6499a1dee1b9c3ca00ddbceb4b5aed"
 target_release: ""
 verified_at: ""
-status_note: "后端正在交付；前端需把派单选择改为批量 items[]，并按 activeAssignments[] 展示全部车辆与司机。"
-updated_at: "2026-07-25"
+status_note: "后端已部署并完成网关验证；用户验收发现排车页缺少新增车辆槽位入口，前端已退回 claimed 继续修复。"
+updated_at: "2026-07-26T01:23:05.110Z"
 base: "dev-v3"
 ---
 
@@ -22,66 +22,69 @@ base: "dev-v3"
 >
 > **工单**: [wx/HL#5245](https://git.1814.love:8443/wx/HL/issues/5245)
 >
-> **后端 PR**: 待创建
+> **后端 PR**: [wx/HL#5249](https://git.1814.love:8443/wx/HL/pulls/5249)、
+> [wx/HL#5250](https://git.1814.love:8443/wx/HL/pulls/5250)
 >
 > **影响范围**: 车务管理 → 派车弹窗通知预览、车辆/司机批量选择、派单详情
 
 ## 关键变化
 
-- 通知模板预览中的 `itinerary.url` 改为派车组稳定短链
-  `https://{短链域}/s/{code}`，不再把完整 HMAC token URL 放进预览正文。
+- 通知模板预览中的 `itinerary.url` 会为当前派车组即时创建或复用稳定短链，
+  例如 `https://hr.example.com/s/Dabc1234`，不再把完整 HMAC token URL 或“派车后生成”占位文案放进预览正文。
 - 既有短链和完整 token 长链在原派车组失效后，只允许解析到同一订单、同一
   `assignmentSlotId` 的唯一当前有效派车组；跨订单、跨槽位、无有效派单或同槽位存在多个
   active 派车组时继续返回 `605308`。
 - 批量派单和详情多司机字段是既有契约，本次明确前端消费口径：一次提交 `items[]`，详情展示
   `activeAssignments[]`，不得只处理兼容代表字段 `currentAssignment`。
+- 排车页必须提供“+ 添加车辆槽位”入口。新增槽位不是替换“车辆槽位 1”，而是追加一个可独立
+  选择车辆和司机的草稿槽位；多个槽位统一映射为批量派单 `items[]`。
 
 ## 变更接口
 
 | 方法 | 路径 | 本次口径 |
 | --- | --- | --- |
-| `POST` | `/admin/fleet/message-templates/{templateId}/render` | 请求新增可选 `assignmentGroupId`；`itinerary.url` 读取该派车组已冻结的稳定短链 |
-| `GET` | `/app/h5/s/{code}` | 继续生成短时 token 并重定向；同槽位改派后的解析由行程接口完成 |
-| `GET` | `/app/h5/itinerary/{token}` | 原组失效后仅回退同订单、同稳定槽位的唯一 active 派车组 |
+| `POST` | `/admin/fleet/message-templates/<templateId>/render` | 请求新增可选 `assignmentGroupId`；有效派车组即时创建/复用稳定短链；旧前端未传时仅在订单、车辆、司机唯一定位一个 active 组时兼容 |
+| `GET` | `/app/h5/s/<code>` | 继续生成短时 token 并重定向；同槽位改派后的解析由行程接口完成 |
+| `GET` | `/app/h5/itinerary/<token>` | 原组失效后仅回退同订单、同稳定槽位的唯一 active 派车组 |
 | `POST` | `/admin/fleet/assignments/batch` | 既有：按 `items[]` 一次提交多个车辆/司机槽位 |
-| `GET` | `/admin/fleet/board/orders/{orderId}` | 既有：按 `activeAssignments[]` 返回全部当前有效派车组 |
+| `GET` | `/admin/fleet/board/orders/<orderId>` | 既有：按 `activeAssignments[]` 返回全部当前有效派车组 |
 
 ## 1. 通知模板预览
 
 ```http
-POST /admin/fleet/message-templates/{templateId}/render
+POST /admin/fleet/message-templates/<templateId>/render
 ```
 
 请求新增可选字段 `assignmentGroupId`，响应结构不变。前端在预览包含
-`itinerary.url` 或 `itinerary.code` 的模板时，应传入当前派车组 ID：
+`itinerary.url` 或 `itinerary.code` 的模板时，应传入当前派车组 ID；后端仅为兼容旧前端，
+在 `orderId` + `vehicleId` + `driverId` 唯一定位一个 active 派车组时允许省略：
 
 | 字段 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `orderId` | `string` | 是 | 订单雪花 ID |
 | `vehicleId` | `string` | 是 | 当前派车组车辆雪花 ID |
 | `driverId` | `string` | 是 | 当前派车组司机雪花 ID |
-| `assignmentGroupId` | `string` | 行程预览时是 | 派车组雪花 ID；取自批量派单响应，不得用车辆/司机组合反推 |
+| `assignmentGroupId` | `string` | 行程预览时强烈建议 | 派车组雪花 ID；取自批量派单响应，多车多司机场景必须按槽位传入 |
 
-`assignmentGroupId` 命中已冻结短链时：
+派车组有效时，预览会即时创建或复用该组短链：
 
-```json
-{
-  "code": 200,
-  "data": {
-    "renderedBody": "请查看行程：https://hr.1814.love/s/Dabc1234",
-    "variablesUsed": ["itinerary.url"]
-  }
-}
+```yaml
+code: 200
+data:
+  renderedBody: "请查看行程：https://hr.example.com/s/Dabc1234"
+  variablesUsed:
+    - "itinerary.url"
 ```
 
-未传 `assignmentGroupId`、派车组未冻结短链、短链不存在或读取失败时，
-`itinerary.url` 使用“行程短链将在派车后生成”，`itinerary.code` 为空字符串；
-预览接口不新建短链，也不会回退或暴露完整 HMAC URL。
+未传 `assignmentGroupId` 且订单、车辆、司机无法唯一定位 active 派车组，或显式派车组无效时，
+`itinerary.url` 使用“行程链接暂不可用，请联系车务确认”，`itinerary.code` 为空字符串。
+短链配置、注册或数据库失败时接口直接返回错误，不静默降级为占位文案；任何场景都不会回退或
+暴露完整 HMAC URL。同一派车组通过显式 ID 或兼容定位重复预览、发送、重试时复用同一短链。
 
 ## 2. 同稳定槽位改派后的旧链接
 
-短链先通过 `/app/h5/s/{code}` 重定向到短时 token；短链与直接保存的完整 token 最终都进入
-`/app/h5/itinerary/{token}`，因此使用同一组回退规则：
+短链先通过 `/app/h5/s/<code>` 重定向到短时 token；短链与直接保存的完整 token 最终都进入
+`/app/h5/itinerary/<token>`，因此使用同一组回退规则：
 
 | token 原派单与当前派单 | 结果 |
 | --- | --- |
@@ -103,32 +106,31 @@ POST /admin/fleet/assignments/batch
 
 每个已选车辆槽位生成一个 `items[]` 元素，所有槽位一次提交：
 
-```json
-{
-  "orderId": "2080000000000000001",
-  "requirementId": "2080000000000000002",
-  "startDate": "2026-07-29",
-  "endDate": "2026-07-31",
-  "holdMode": 1,
-  "requestId": "assign-2080000000000000001-v1",
-  "items": [
-    {
-      "fleetItemIndex": 0,
-      "vehicleId": "2080000000000000101",
-      "driverId": "2080000000000000201"
-    },
-    {
-      "fleetItemIndex": 1,
-      "vehicleId": "2080000000000000102",
-      "driverId": "2080000000000000202"
-    }
-  ]
-}
+```yaml
+orderId: "2080000000000000001"
+requirementId: "2080000000000000002"
+startDate: "2026-07-29"
+endDate: "2026-07-31"
+holdMode: 1
+requestId: "assign-2080000000000000001-v1"
+items:
+  - fleetItemIndex: 0
+    vehicleId: "2080000000000000101"
+    driverId: "2080000000000000201"
+  - fleetItemIndex: 1
+    vehicleId: "2080000000000000102"
+    driverId: "2080000000000000202"
 ```
 
 - `fleetItemIndex` 从 0 开始，对应需求展开后的稳定车辆槽位。
 - `vehicleId`、`driverId` 必填；雪花 ID 全程按字符串处理。
 - `protocolPrice`、`messageTemplateId`、`customBody`、`confirmCrossResident` 是单槽位可选字段。
+- 前端维护可编辑槽位列表。初始槽位来自当前有效派车组或订单用车需求；点击
+  “+ 添加车辆槽位”后追加一个空白草稿槽位，不得覆盖或复用既有槽位。
+- 每个草稿槽位独立选择一辆车和一名司机；未提交的新槽位允许删除，已有
+  `holding` / `assigned` 槽位不得被“删除草稿”操作静默撤销。
+- 进入下一步前校验所有可提交槽位均已选择车辆和司机，并为每个槽位生成唯一
+  `fleetItemIndex`。页面可见槽位数必须等于本次提交的 `items[]` 数量。
 - 不得为每辆车循环调用单条 `POST /admin/fleet/assignments` 代替批量接口。
 - 批量响应按 `data.assignments[].assignment.assignmentGroupId` 返回各槽位派车组 ID；
   前端逐项调用模板预览时传入对应 `assignmentGroupId`，不得只预览代表项。
@@ -136,7 +138,7 @@ POST /admin/fleet/assignments/batch
 ### 派单详情
 
 ```http
-GET /admin/fleet/board/orders/{orderId}
+GET /admin/fleet/board/orders/<orderId>
 ```
 
 按 `data.activeAssignments[]` 渲染每个有效派车组，至少消费：
@@ -158,15 +160,23 @@ GET /admin/fleet/board/orders/{orderId}
 
 | 场景 | 数据源 | 页面行为 |
 | --- | --- | --- |
-| 通知预览命中派车组已冻结短链 | `assignmentGroupId` + `renderedBody` 中的 `itinerary.url` | 展示稳定短链 |
-| 未传派车组或短链尚未冻结 | “行程短链将在派车后生成” | 保留文案并阻止把它当可发送链接 |
-| 一单多个车辆槽位 | `items[]` | 每个槽位各选一辆车和一名司机，一次批量提交 |
+| 通知预览传入有效派车组 | `assignmentGroupId` + `renderedBody` 中的 `itinerary.url` | 即时创建或复用并展示稳定短链 |
+| 旧前端未传派车组但订单、车辆、司机唯一定位 | `orderId` + `vehicleId` + `driverId` | 兼容定位并返回同一稳定短链 |
+| 派车组缺失、无效或定位不唯一 | “行程链接暂不可用，请联系车务确认” | 展示不可用态，不把文案当可发送链接 |
+| 已有车辆槽位 | `activeAssignments[]` 或当前排车草稿 | 按稳定槽位逐项展示；允许重选当前槽位的车辆或司机 |
+| 新增车辆槽位 | 前端草稿槽位列表 | 展示“+ 添加车辆槽位”；每次点击只追加一个空白槽位，不替换已有槽位 |
+| 新增槽位未选完整 | 草稿槽位的 `vehicleId` / `driverId` | 槽位显示未完成警示，禁用“下一步”；不生成可发送通知 |
+| 删除未提交槽位 | 前端草稿槽位列表 | 只删除新增且未提交的草稿槽位，不撤销已有有效派车组 |
+| 一单多个车辆槽位 | `items[]` | 每个槽位各选一辆车和一名司机，一次批量提交；可见槽位数与 `items[]` 数量守恒 |
 | 详情有多个 active 派车组 | `activeAssignments[]` | 按槽位逐项展示车辆、司机、脱敏电话和状态 |
 | 详情无 active 派车组 | `activeAssignments=[]` | 展示无有效派单空态 |
 
 ## 前端处理清单
 
-- [ ] 派车弹窗支持选择多个车辆槽位，并为每个槽位选择司机。
+- [ ] 排车页提供“+ 添加车辆槽位”入口，允许连续新增多个草稿槽位，不得只重选“车辆槽位 1”。
+- [ ] 每个新增槽位分别选择一辆车和一名司机，并支持删除未提交的草稿槽位。
+- [ ] “下一步”前校验所有槽位，按页面槽位顺序生成唯一 `fleetItemIndex`，可见槽位与
+      `items[]` 一一对应。
 - [ ] 统一提交 `POST /admin/fleet/assignments/batch` 的 `items[]`，保留批次级 `requestId`。
 - [ ] 批量派单响应逐项保存 `assignmentGroupId`；通知预览传入当前槽位的
       `orderId`、`vehicleId`、`driverId`、`assignmentGroupId`，只把真实短链视为可发送链接。
@@ -174,23 +184,35 @@ GET /admin/fleet/board/orders/{orderId}
 - [ ] 司机电话使用后端脱敏值，雪花 ID 始终按字符串处理。
 - [ ] 覆盖无 active、多 active、短链不可用等空态/失败封闭场景。
 
+## 前端验收反馈
+
+- 2026-07-25 用户页面验收：排车页仅显示“车辆槽位 1”，只能在该槽位内重选车辆或司机，
+  无法新增第二个槽位；当前前端提交不满足多车辆、多司机批量派单要求。
+- 状态因此由 `implemented` 回退为 `claimed`。前端完成新增槽位、逐槽位选择和批量提交后，
+  应填写新的 `frontend_ref` 再迁移为 `implemented`。
+
 ## 验证证据
 
 - OpenAPI/oasdiff：`not_configured`。项目未配置可复现的 Swagger2 → OAS3 导出与 oasdiff 基线；
   本次使用源码语义比对、Controller/Service 定向测试与测试网关证据兜底。
 - 消费者契约/Spring Cloud Contract：`not_required`。本次没有内部 Feign 或共享 Java DTO 变化。
-- 后端定向测试：50 项通过，0 失败、0 错误、0 跳过。
+- 后端定向测试：41 项通过，0 失败、0 错误、0 跳过。
 - Fleet Spotless：606 个 Java 文件检查通过。
-- 完整 reactor `verify`：3203 项测试，0 失败、0 错误、1 跳过；其中 fleet 2367 项，
+- 完整 reactor `verify`：3209 项测试，0 失败、0 错误、1 跳过；其中 fleet 2373 项，
   0 失败、0 错误、1 跳过。
-- 后端 PR、测试部署与网关证据将在后端交付后补充。
+- 后端 PR #5249 合并提交：`433ef238f09eba2258c996093b1d8cb2309a8e83`。
+- 后端 PR #5250 合并提交：`d939995bd266f11076eb79ea183e37a968e01afc`。
+- 测试部署任务：`8eae87b2`；`hl-fleet-service` 的 `8187`、`8087` 两实例均健康。
+- 测试网关已验证：显式 `assignmentGroupId` 与唯一兼容定位返回同一 7 位短码；
+  重复预览保持稳定，短链 302、H5 JSON 与 HTML 均成功；失效组返回 `605308`，
+  篡改签名返回 `605306`。脱敏证据已回写工单 #5245。
 
 ## 不影响范围
 
 - 不修改或部署 `D:/work2/hl-ui`。
 - 除模板预览请求新增可选 `assignmentGroupId` 外，不删除 API 字段，不改变既有字段类型、
-  必填性或枚举；模板预览响应结构不变。
+  必填性或枚举；模板预览响应结构不变。预览在命中有效派车组时会幂等写入短链记录。
 - 不修改批量派单事务、价格、跨常驻确认、保险或通知冻结规则。
 - 不新增 DDL，不清理、不回填存量数据。
 
-> `frontend_status: pending` 表示等待前端真实领取；不代表页面已实现、发布或验证。
+> `frontend_status: claimed` 表示前端已领取但仍需修复“新增车辆槽位”；尚未形成可验收的完整实现。

changelogs/2026-07/80_5254_订单侧已配置车辆补充车型车队服务日期与日单价.md

@@ -0,0 +1,94 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5254"
+title: "订单侧已配置车辆补充车型车队服务日期与日单价"
+consumer: "admin"
+change_type: "修改接口"
+backend_status: "pending"
+gateway_status: "pending"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: ""
+updated_at: "2026-07-26"
+base: "dev-v3"
+generated: "2026-07-26T09:57:21+08:00"
+---
+
+# 订单侧已配置车辆补充车型车队服务日期与日单价
+
+订单详情的已配置车辆补齐车型标题、车队、连续服务日期、服务天数和协议日单价。
+本记录只表示后端契约交接，`frontend_status` 在真实前端领取前保持 `pending`。
+
+## 关联
+
+- Issue: #5254
+- PR: 待补充
+
+## 变更接口
+
+| 方法 | 路径 | 来源 |
+|---|---|---|
+| GET | `/v3/admin/order/{id}/itinerary` | `data.vehicleGroup.assignments[]` |
+
+### `data.vehicleGroup.assignments[]`
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `brand` | string | 否 | 兼容字段；Fleet 实时数据下回填车辆车型名称，前端标题可按 `brand \|\| vehicleType \|\| '—'` 展示 |
+| `fleetTeamId` | string | 否 | 车辆所属车队 ID；雪花 ID 按字符串返回 |
+| `fleetTeamName` | string | 否 | 车辆所属车队名称；归档车辆或历史快照无法补齐时为空 |
+| `startDate` | string(`yyyy-MM-dd`) | 否 | 车辆/司机连续服务段开始日 |
+| `endDate` | string(`yyyy-MM-dd`) | 否 | 车辆/司机连续服务段结束日 |
+| `serviceDays` | integer | 否 | 连续服务天数，首尾日期均计入 |
+| `plannedDailyFee` | string(decimal) | 否 | 协议日单价；连续段内每日协议价不一致或无价格时为空，不得按 0 元展示 |
+
+既有 `vehicleType`、`licensePlate`、`seats`、`driverName` 和
+`driverPhoneMasked` 继续返回；手机号保持脱敏。
+
+### 内部 Feign/shared Java
+
+`OrderDriverVehicleCandidateDTO` 新增可空字段：
+
+- `fleetTeamId: Long`（JSON 字符串）
+- `fleetTeamName: String`
+- `protocolPrice: BigDecimal`（JSON 字符串）
+
+既有 `startDate`、`endDate` 本次开始映射到订单侧公开响应。新旧 Fleet/Order
+可滚动部署：旧消费者忽略新增字段，新消费者读取旧生产者时新增字段为空。
+
+## 契约影响文件
+
+- `hl-common/hl-common-core/src/main/java/com/hulalv/common/dto/fleet/OrderDriverVehicleCandidateDTO.java`
+- `hl-order-service-v3/src/main/java/com/hulalv/order/core/controller/admin/vo/detail/ItineraryVO.java`
+- `hl-order-service-v3/src/test/java/com/hulalv/order/core/controller/admin/OrderControllerTest.java`
+- `hl-order-service-v3/src/test/java/com/hulalv/order/fleet/feign/FleetDriverVehicleFeignContractTest.java`
+
+## 前端/调用方动作
+
+- `src/views/order-v2/detail/_shared/v3Adapter.js` 映射新增字段：
+  `fleetTeamName`、`startDate`、`endDate`、`serviceDays`、`plannedDailyFee`。
+- 车型标题使用 `brand || vehicleType || '—'`；`brand === vehicleType` 时不要重复展示同一车型。
+- “用车安排”摘要展示车型、车牌、座位、司机、脱敏手机号和服务日期。
+- “已配置车辆”弹窗展示车型、车牌、座位、所属车队、司机、脱敏手机号、
+  服务起止日期、服务天数和协议日单价。
+- `plannedDailyFee == null` 时显示 `—`，不得显示 0 元；无车辆时保持“暂无已配车”。
+- 多车/改派连续段按接口数组逐条渲染，不按车牌或司机姓名自行去重。
+
+## 验证证据
+
+- Fleet 定向测试：
+  `mvn -pl hl-fleet-service -am -Dtest=OrderDriverVehicleQueryServiceTest,AssignmentConverterTest -Dsurefire.failIfNoSpecifiedTests=false test`
+  （31 项通过）。
+- Order 消费者与内部契约：
+  `mvn -pl hl-order-service-v3 -am -Dtest=OrderDetailServiceTest,FleetDriverVehicleFeignContractTest -Dsurefire.failIfNoSpecifiedTests=false test`
+  （79 项通过）。
+- 前端 API 序列化：
+  `mvn -pl hl-order-service-v3 -am -Dtest=OrderControllerTest#getItinerary_validId_returns200 -Dsurefire.failIfNoSpecifiedTests=false test`
+  （1 项通过）。
+- Fleet Spotless：`mvn -pl hl-fleet-service spotless:check`（通过）。
+- 网关验证：待补充
+- 兼容性结论：仅新增可空响应字段并补齐既有空字段；内部 Feign JSON 双向兼容，
+  不修改方法、路径、参数、必填项、枚举或错误码。