From 7a3c0d70b76d0d3d511bb761ebf353efdf0aece4 Mon Sep 17 00:00:00 2001 From: wx <2636507191@qq.com> Date: Fri, 24 Jul 2026 18:45:34 +0800 Subject: [PATCH] docs: record deployment evidence (#5236) --- ...接送改由大交通默认驱动-修改接口-管理后台.md | 42 +++++++++---------- 1 file changed, 19 insertions(+), 23 deletions(-) diff --git a/changelogs-v2/2026-07/24_5236_用车接送改由大交通默认驱动-修改接口-管理后台.md b/changelogs-v2/2026-07/24_5236_用车接送改由大交通默认驱动-修改接口-管理后台.md index 09cd4d8..8f4d0de 100644 --- a/changelogs-v2/2026-07/24_5236_用车接送改由大交通默认驱动-修改接口-管理后台.md +++ b/changelogs-v2/2026-07/24_5236_用车接送改由大交通默认驱动-修改接口-管理后台.md @@ -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`。