wx/hl-api-changelog

派生 0

API Changelog Bot 4f94800a05

changelog-filename-gate / validate (push) Failing after 2s

详情

docs(order): document transfer requirement options

2026-07-23 17:41:02 +08:00

5.1 KiB

原始文件 Blame 文件历史

schema, ticket, title, consumer, backend, gateway, frontend, base, generated

schema	ticket	title	consumer	backend	gateway	frontend	base	generated
hl-changelog/v1	5193	用车需求增加独立接机送机选择	admin	pending	pending	pending	dev-v3	2026-07-23T17:39:06+08:00

【修改接口·前端待处理·管理后台】用车需求增加独立接机送机选择

目标前端

端类型：管理后台（Web）
目标仓库：mmg/hl-ui
目标分支：v2.1
联调/验收环境：http://192.168.100.160:9527
小程序：无需处理

服务: hl-order-service-v3、hl-fleet-service

工单: wx/HL#5193

影响范围: 提交/调整用车需求、订单详情用车摘要、车务派单详情

业务口径

“是否需要平台接送”拆分为两个相互独立的业务选择：

pickupRequired：是否需要平台接机/接站；
dropoffRequired：是否需要平台送机/送站。

提交用车需求时两个选项默认都选中，即默认都为 true。定制师可以分别取消，支持四种组合。接机与送机选择是用车需求本身的明确口径，不从航班、站点、接送时间或大交通批次推断。

一、提交/调整用车需求

1. 直接提交或修改

PUT /v3/admin/order/{id}/vehicle-requirement

请求体新增：

{
  "fleet": [
    {
      "vehicleType": "SUV",
      "seats": 7,
      "count": 1
    }
  ],
  "pickupRequired": true,
  "dropoffRequired": true,
  "specialTags": ["中文司机"],
  "remark": "司机会蒙语"
}

2. 调整订单

POST /v3/admin/order/{id}/adjustment/submit

updates.vehicleRequirement 新增相同字段：

{
  "updates": {
    "vehicleRequirement": {
      "fleet": [
        {
          "vehicleType": "SUV",
          "seats": 7,
          "count": 1
        }
      ],
      "pickupRequired": false,
      "dropoffRequired": true,
      "specialTags": [],
      "remark": ""
    }
  }
}

字段	类型	必填	说明
`pickupRequired`	`Boolean`	前端应显式提交	`true` 需要接机/接站，`false` 不需要
`dropoffRequired`	`Boolean`	前端应显式提交	`true` 需要送机/送站，`false` 不需要

兼容规则：

首次提交缺少字段时，后端按 true 保存；
修改或调整既有需求时缺少字段，后端继承当前有效需求的原值；
前端不要依赖兼容兜底，提交时始终显式发送两个字段。

二、前端表单

在“车辆安排/提交用车需求”表单中增加两个独立开关或复选框：

是否需要接机/接站；
是否需要送机/送站。

交互要求：

新建用车需求时两个选项默认选中；
编辑或调整时以接口回显值为准，不要每次强制重置为选中；
两个选项均可独立取消，不做互斥或联动；
不根据有没有大交通、航班时间或站点决定勾选状态。

三、回显接口

以下响应均新增 pickupRequired 和 dropoffRequired，用于无损回显：

用车需求提交/修改响应；
GET /v3/admin/order/{id}/adjustment/snapshot 的 data.vehicleRequirement；
GET /v3/admin/order/{id}/itinerary 的 data.vehicleGroup.requirement；
order-v3 内部用车需求契约。

示例：

{
  "pickupRequired": false,
  "dropoffRequired": true
}

四、车务派单详情

GET /admin/fleet/board/orders/{orderId} 的 data.transport 新增/明确返回：

{
  "pickupRequired": false,
  "dropoffRequired": true
}

这两个值来自订单当前有效用车需求，是车务详情页展示的权威值。前端不得再用抵达/返程班次、站点、接送时间或批次记录推断。

页面分别显示：

字段值	接机标签	送机标签
`true`	需要平台接机	需要平台送机
`false`	无需平台接机	无需平台送机

不要再合并显示单个“需要平台接送”标签。滚动部署期间若字段暂为 null，可以暂不显示对应标签；部署完成后现有历史需求会按默认值返回 true。

五、前端处理清单

提交用车需求表单增加“是否需要接机/接站”和“是否需要送机/送站”。
新建时两个选项默认选中，提交时显式发送两个 Boolean。
调整订单预填读取 vehicleRequirement.pickupRequired/dropoffRequired，不覆盖既有值。
订单详情用车需求摘要按两个字段分别展示。
车务派单详情按 transport.pickupRequired/dropoffRequired 分别展示接机、送机标签。
不再展示单个“需要平台接送”，不根据大交通信息反推。
覆盖需要/不需要的四种组合及旧需求默认双 true。

六、不影响范围

大交通录入中的批次级 pickupRequired 继续表示该批次自身是否接送，本次不修改其录入和计算逻辑。
接送班次、站点、时间和备注字段结构不变。
车型、座位数、数量、特殊诉求和备注提交结构不变。

本文是前端接入通知，不代表已修改或发布 mmg/hl-ui；前端按“前端处理清单”接入即可。

5.1 KiB 原始文件 Blame 文件历史 Unescape Escape