46 行
2.9 KiB
Markdown
46 行
2.9 KiB
Markdown
# 【修复·管理后台】车务:司机/车辆列表日期筛选参数报错修复 + 车型大类图标长度放宽 64
|
|
|
|
> 存放目录: changelogs-v2/2026-06/
|
|
> 涉及服务: hl-fleet-service(8087)
|
|
> PR: #3694 + #3695(文档版本记录)(均已合并 dev-v3,**测试服已部署并 API 实测通过**) | 无关联工单(用户即时报修) | 日期: 2026-06-11
|
|
> 影响范围: 管理后台**司机档案/车辆档案列表筛选** + **车型大类新增/编辑**
|
|
|
|
## ⚠️ 关键说明(前端必看 2 点)
|
|
|
|
1. **列表日期筛选现在能用了(之前一传就报错)**:司机列表 `licenseExpireBefore`/`insuranceAnnualEndBefore`、车辆列表 `insureDueBefore`/`inspectDueBefore` 四个 GET 日期参数,此前传 `2026-07-11` 这类标准格式直接报 `Failed to convert ... LocalDate`(后端缺日期绑定注解),现已修复。**格式仍是 `yyyy-MM-dd`,请求/响应形状零变化,前端无需改任何代码**,之前因报错被屏蔽的筛选交互可以放开。
|
|
2. **车型大类 `icon` 上限 8→64 字符**:之前传图标组件名(如 `BusOutline`=10 字符)被 400「图标长度不能超过 8」拒(原按单 emoji 设计),现在最长 64,**组件名或 emoji 都可以**;超 64 报 400「图标长度不能超过 64」。
|
|
|
|
## 1. 日期筛选修复(4 个参数)
|
|
|
|
| 接口 | 参数 | 说明 |
|
|
|------|------|------|
|
|
| `GET /admin/fleet/drivers/page` | `licenseExpireBefore` | 驾照到期日 ≤ 该日(含),yyyy-MM-dd |
|
|
| `GET /admin/fleet/drivers/page` | `insuranceAnnualEndBefore` | 年保到期日 ≤ 该日(含),仅 annual 行命中 |
|
|
| `GET /admin/fleet/vehicles/page` | `insureDueBefore` | 保险到期日 ≤ 该日(含)——同根因一并修,此前同样报错 |
|
|
| `GET /admin/fleet/vehicles/page` | `inspectDueBefore` | 年检到期日 ≤ 该日(含)——同上 |
|
|
|
|
测试服实测(用户原始报错 URL):
|
|
|
|
```
|
|
GET /admin/fleet/drivers/page?page=1&pageSize=24&season=active&insuranceAnnualEndBefore=2026-07-11&licenseExpireBefore=2026-08-10
|
|
→ {"code":200,"message":"成功","data":{"records":[],"total":0,...}}
|
|
// 不再报 Failed to convert property value of type 'java.lang.String' to 'java.time.LocalDate'
|
|
```
|
|
|
|
## 2. 车型大类 icon 放宽
|
|
|
|
`POST /admin/fleet/vehicle-types` 与 `PUT /admin/fleet/vehicle-types/{typeId}` 入参 `icon`:≤8 → **≤64**(DB 列同步 `VARCHAR(8)→VARCHAR(64)`,Flyway `V20260611_004` 纯加宽,存量 emoji 图标无损)。
|
|
|
|
测试服实测(用户原始报错请求体):
|
|
|
|
```
|
|
PUT /admin/fleet/vehicle-types/2064609312168083458
|
|
{"typeKey":"mpv","typeName":"商务车","icon":"BusOutline","description":"高级团","sortOrder":99}
|
|
→ {"code":200,"message":"成功","data":{"id":"2064609312168083458","typeKey":"mpv","typeName":"商务车","icon":"BusOutline","description":"高级团","sortOrder":99,...}}
|
|
// 列表回读 icon="BusOutline" 一致
|
|
```
|
|
|
|
## 3. 文档版本
|
|
|
|
FLEET API → **v1.5.58** / FLEET DB → **v1.5.25**,文档站已同步:https://web.test.1814.love:9443/hl-docs/order-v3/api/API-SPEC-FLEET-V1.5.html
|