docs(changelog): 到达计划自驾时段 selfDrivePeriodLabel 文案含时间范围(小程序端)
mp 到达计划出参 selfDrivePeriodLabel 口径变化(上午→上午(06:00-12: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
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户