# 【修改·管理后台】车辆档案:行驶证正/副页图片迁入附件体系,`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
