hl-api-changelog/changelogs-v2/2026-06/11_3679_行驶证正反面图迁附件表-修改接口-管理后台.md

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

{
  "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 实测返回(节选):

"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