50 行
2.4 KiB
Markdown
50 行
2.4 KiB
Markdown
# 【修改·管理后台】车辆档案:行驶证正/副页图片迁入附件体系,`regCertFrontUrl`/`regCertBackUrl` 字段移除
|
|
|
|
> 存放目录: changelogs-v2/2026-06/
|
|
> 涉及服务: hl-fleet-service(8087) + hl-user-service(字典种子)
|
|
> PR: #3679(已合并 dev-v3,**测试服双服务已部署并 API 实测通过**) | 无关联工单(wx 2026-06-11 拍定) | 日期: 2026-06-11
|
|
> 影响范围: 管理后台**车辆档案**新增/编辑表单与详情页的行驶证图片区块
|
|
|
|
## ⚠️ 关键说明(前端必改 2 处)
|
|
|
|
行驶证正反面图片本质是附件(纯展示、无业务逻辑消费),从车辆主表字段迁入统一附件体系:
|
|
|
|
1. **表单(§2.3 新增/§2.4 编辑)**:`regCertFrontUrl`/`regCertBackUrl` 两个独立字段**已移除**(传了会被忽略)。行驶证图片改放 `attachments` 数组,类目:
|
|
- `reg_cert_front` = 行驶证正面(上限 1 张)
|
|
- `reg_cert_back` = 行驶证副页(上限 1 张)
|
|
- 类目从字典 `GET /admin/dict/data/vehicle_attachment_category` 下发(现 8 类,remark=张数上限),编辑走既有 diff 语义(带 id 保留/无 id 新增/未传软删)。
|
|
2. **详情(§2.2)**:不再返回 `regCertFrontUrl`/`regCertBackUrl`,从 `attachments[category=reg_cert_front/reg_cert_back]` 读取。
|
|
|
|
**不变**:行驶证**文本**字段(`regCertNo` 行驶证号/`regCertOwner` 所有人/`regCertUsage` 使用性质)仍是主表结构化字段,表单/详情/批量导入照旧。
|
|
|
|
## 1. 实测示例(测试服)
|
|
|
|
新增车辆请求(行驶证图随 attachments 提交):
|
|
|
|
```json
|
|
{
|
|
"plate": "蒙A-66666", "vehicleModelId": "<id>", "fleet": "own",
|
|
"attachments": [
|
|
{ "category": "reg_cert_front", "url": "https://oss.../regfront.jpg", "mimeType": "image/jpeg", "sortNo": 0 },
|
|
{ "category": "reg_cert_back", "url": "https://oss.../regback.jpg", "mimeType": "image/jpeg", "sortNo": 0 }
|
|
]
|
|
}
|
|
```
|
|
|
|
详情 `attachments` 实测返回(节选):
|
|
|
|
```json
|
|
"attachments": [
|
|
{ "id": "...", "category": "reg_cert_front", "url": "https://oss.../regfront.jpg", "mimeType": "image/jpeg", "sortNo": 0 },
|
|
{ "id": "...", "category": "reg_cert_back", "url": "https://oss.../regback.jpg", "mimeType": "image/jpeg", "sortNo": 0 }
|
|
]
|
|
```
|
|
|
|
## 2. 存量数据
|
|
|
|
已有车辆的两列历史值由 Flyway 自动迁为对应类目附件行(测试服已执行),前端无需任何兼容处理。
|
|
|
|
## 3. 文档
|
|
|
|
FLEET API → **v1.5.55** / DB → **v1.5.22**,文档站:https://web.test.1814.love:9443/hl-docs/order-v3/api/API-SPEC-FLEET-V1.5.html
|