1.9 KiB
1.9 KiB
【修改接口·小程序端】到达计划自驾时段 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文案。