docs: record deployment evidence (#5236)
所有检测均成功
changelog-filename-gate / validate (pull_request) Successful in 2s

这个提交包含在:
wx 2026-07-24 18:45:34 +08:00
父节点 4877596de1
当前提交 7a3c0d70b7

查看文件

@ -4,14 +4,14 @@ ticket: "5236"
title: "用车接送改由大交通默认驱动"
consumer: "admin"
change_type: "修改接口"
backend_status: "pending"
gateway_status: "pending"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "pending"
frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "后端 PR #5241创建并通过本地门禁,待合并、测试环境部署和网关验证;前端待删除车辆接送开关并改用大交通摘要。"
status_note: "后端 PR #5241合并至 dev-v39578f78d5,order/fleet 已部署测试环境b57ce915/0da3b9e6,双实例 internal 契约与网关汇总/列表/详情已验证;前端仍为 pending,待删除车辆接送开关并改用大交通摘要。"
updated_at: "2026-07-24"
base: "dev-v3"
---
@ -45,14 +45,14 @@ base: "dev-v3"
| 方法 | 路径 | 变化 |
|---|---|---|
| `POST` | `/v3/admin/order/{id}/transport-plan/add` | 新增大交通未传 `pickupRequired` 时默认 `true` |
| `POST` | `/v3/admin/order/{id}/transport-plan/batch` | 批量替换中每个未传值的批次默认 `true` |
| `POST` | `/v3/admin/order/{id}/transport-plan/{planId}/edit` | 未传该字段时保留原值;显式值正常覆盖 |
| `PUT` | `/v3/admin/order/{id}/vehicle-requirement` | 两个接送字段改为兼容字段,不再是权威来源 |
| `GET` | `/v3/admin/order/{id}/adjustment/snapshot?scope=VEHICLE_REQ` | 继续通过 `vehicleTransportSummary` 返回大交通批次摘要 |
| `POST` | `/v3/admin/order/{id}/adjustment/submit` | `updates.vehicleRequirement` 中两个接送字段仅兼容接收 |
| `POST` | `/v3/admin/order/:id/transport-plan/add` | 新增大交通未传 `pickupRequired` 时默认 `true` |
| `POST` | `/v3/admin/order/:id/transport-plan/batch` | 批量替换中每个未传值的批次默认 `true` |
| `POST` | `/v3/admin/order/:id/transport-plan/:planId/edit` | 未传该字段时保留原值;显式值正常覆盖 |
| `PUT` | `/v3/admin/order/:id/vehicle-requirement` | 两个接送字段改为兼容字段,不再是权威来源 |
| `GET` | `/v3/admin/order/:id/adjustment/snapshot?scope=VEHICLE_REQ` | 继续通过 `vehicleTransportSummary` 返回大交通批次摘要 |
| `POST` | `/v3/admin/order/:id/adjustment/submit` | `updates.vehicleRequirement` 中两个接送字段仅兼容接收 |
| `GET` | `/admin/fleet/board/orders` | 卡片接送就绪状态改为按实时大交通方向聚合 |
| `GET` | `/admin/fleet/board/orders/{orderId}` | `transport.pickupRequired/dropoffRequired` 只取实时大交通聚合 |
| `GET` | `/admin/fleet/board/orders/:orderId` | `transport.pickupRequired/dropoffRequired` 只取实时大交通聚合 |
小程序内部大交通新增与批量接口使用相同默认规则,但本 changelog 的前端处理范围仅为管理后台。
@ -71,18 +71,6 @@ base: "dev-v3"
### 派单详情响应
```json
{
"transport": {
"pickupRequired": true,
"dropoffRequired": false,
"arrive": {},
"depart": {},
"batches": []
}
}
```
| 字段 | 类型 | 空值 | 说明 |
|---|---|---|---|
| `transport.pickupRequired` | `Boolean` | 无 ARRIVAL 批次时为 `null` | ARRIVAL 批次聚合 |
@ -119,8 +107,16 @@ base: "dev-v3"
- 调整/需求/出行人兼容链路 357 项通过。
- 调整快照完整字段断言 `AdjustmentServiceTest` 10 项通过。
- `mvn -pl hl-order-service-v3 -am verify` 通过。
- Order 模块 Surefire 汇总 6646 项,0 失败、0 错误、28 跳过。
- `mvn -pl hl-fleet-service -am verify` 通过Fleet 模块 2361 项,0 失败、0 错误、1 跳过。
- Fleet `spotless:check``git diff --check` 通过。
- OpenAPI/oasdiff: `not_configured`,使用源码字段/语义比对和测试作为 fallback。
- Spring Cloud Contract: `not_configured`,使用 order-v3 生产者与 Fleet 消费者测试作为 fallback。
- 测试环境部署与网关验证将在后端 PR 合并后更新。
- 后端 PR #5241 已合并,merge commit 为 `9578f78d5f0241db502d94b22283cbff0a351c53`
- 测试环境部署任务order `b57ce915`、fleet `0da3b9e6`
- `order_transport_plan.pickup_required` 已验证为 `TINYINT(1) NOT NULL DEFAULT 1`,Flyway
`20260724.001` 执行成功。
- order `8086/8186` 均通过 `/v3/internal/order/orders/:orderId/transport` 与批量看板上下文实测;
`true/false/null` 三态及 ARRIVAL/DEPARTURE 分方向聚合符合字段语义。
- 测试网关 `/admin/fleet/board/summary``/orders``/orders/:orderId` 均返回成功;
详情连续 4 次通过,运行时证据为 `D:/work2/hl-workflow/.tmp/5236-gateway-evidence.json`