docs: hand off API contract (#5236) #27
@ -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-v3(9578f78d5),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`。
|
||||
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户