From d553718b36fb67d2e87de19e3c4eedc4b2a6d804 Mon Sep 17 00:00:00 2001 From: yaosutu <770858045@qq.com> Date: Fri, 19 Jun 2026 17:51:32 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E5=88=B0=E8=BE=BE=E8=AE=A1?= =?UTF-8?q?=E5=88=92=E8=87=AA=E9=A9=BE=E6=97=B6=E6=AE=B5=20selfDrivePeriod?= =?UTF-8?q?Label=20=E6=96=87=E6=A1=88=E5=90=AB=E6=97=B6=E9=97=B4=E8=8C=83?= =?UTF-8?q?=E5=9B=B4(=E5=B0=8F=E7=A8=8B=E5=BA=8F=E7=AB=AF)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit mp 到达计划出参 selfDrivePeriodLabel 口径变化(上午→上午(06:00-12:00)),前端直显无需改代码。 --- ...自驾时段label含时间范围-修改接口-小程序端.md | 44 +++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 changelogs-v2-mp/2026-06/19_4058_到达计划自驾时段label含时间范围-修改接口-小程序端.md diff --git a/changelogs-v2-mp/2026-06/19_4058_到达计划自驾时段label含时间范围-修改接口-小程序端.md b/changelogs-v2-mp/2026-06/19_4058_到达计划自驾时段label含时间范围-修改接口-小程序端.md new file mode 100644 index 0000000..49e652d --- /dev/null +++ b/changelogs-v2-mp/2026-06/19_4058_到达计划自驾时段label含时间范围-修改接口-小程序端.md @@ -0,0 +1,44 @@ +# 【修改接口·小程序端】到达计划自驾时段 selfDrivePeriodLabel 文案口径含时间范围 + +> **PR**: #4061 | **服务**: hl-order-service-v3(经 mp-service 透传)| **更新时间**: 2026-06-19 + +## 1. 接口背景 + +大交通枚举改造(#4061)统一了自驾时段 `SelfDrivePeriod` 枚举的中文 label 口径,含时间范围。到达计划(mp)出参 `ArrivalPlanRespVO.selfDrivePeriodLabel` 随之变化。前端直接显示该 label,**无需改代码**,只是显示文案更详细了。 + +## 2. 变更清单 + +| 接口 | 方法 | 路径 | 变更 | +|---|---|---|---| +| 到达计划查询 | GET | /v3/internal/mp/order/arrival/{orderId} | 出参 selfDrivePeriodLabel 文案口径变化 | + +(同枚举也用于 mp 创建/更新/批量接口的回显出参) + +## 3. 出参变化 + +| 字段 | 类型 | 变更 | 说明 | +|---|---|---|---| +| selfDrivePeriodLabel | String | 文案口径调整 | 自驾时段中文,由「上午/下午/晚上」改为含时间范围 | + +## 4. 枚举 / 数据字典 + +| selfDrivePeriod 码值 | 改前 label | 改后 label | +|---|---|---| +| MORNING | 上午 | **上午(06:00-12:00)** | +| AFTERNOON | 下午 | **下午(12:00-18:00)** | +| EVENING | 晚上 | **晚上(18:00-24:00)** | + +## 5. 影响评估 + +- **破坏向后兼容**:否。`selfDrivePeriod` 码值不变,仅 `selfDrivePeriodLabel` 展示文案更详细。 +- **前端是否需改**:否,前端直接展示 label 即可(显示内容自动变详细)。**例外**:若前端有按 label 文案做精确匹配/判断的逻辑(不推荐),需改为按 `selfDrivePeriod` 码值判断。 + +## 6. 注意事项 + +- 自驾时段判断逻辑请用 `selfDrivePeriod` 码值(MORNING/AFTERNOON/EVENING),不要依赖 `selfDrivePeriodLabel` 文案。 + +## 7. 关联 / 联系人 + +- **Issue**: [#4058](https://git.1814.love:8443/wx/HL/issues/4058) +- **PR**: [#4061](https://git.1814.love:8443/wx/HL/pulls/4061) +- **后端负责人**: @yaosutu