docs(changelog): 到达计划自驾时段 selfDrivePeriodLabel 文案含时间范围(小程序端)

mp 到达计划出参 selfDrivePeriodLabel 口径变化(上午→上午(06:00-12:00)),前端直显无需改代码。
这个提交包含在:
yaosutu 2026-06-19 17:51:32 +08:00
父节点 8c8edd364b
当前提交 d553718b36

查看文件

@ -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