hl-api-changelog/changelogs-v2/2026-06/08_3600_车辆保险登记瘦身-删保险公司保单号字段-修改接口-管理后台.md

3.7 KiB

【字段移除·车辆档案】车辆保险登记瘦身 — 删除「保险公司 / 保单号」字段

变更类型🟠 字段移除(出入参 + 列表 + 导入列) 端类型:管理后台 服务hl-fleet-service PRwx/HL#3600 日期2026-06-08 影响范围:车辆新增 / 编辑 / 详情 / 列表 / Excel 导入


⚠️ 关键说明

车辆「保险登记」的两个结构化字段 insurer(保险公司)/ policyNo(保单号)已删除

原因:保险公司、保单号、险种、保额、起止日等明细,已全部承载在「保险单」附件图片attachmentscategory=insurance 的那张/那几张)中,结构化字段属重复录入,且不参与任何后端逻辑(不进筛选、不进对账、不进提醒)。

车辆保险结构化只保留 insureDue(保险到期日)——它驱动「保险到期提醒」,继续保留且可独立编辑。

注:这同时撤销了 v1.5.11 定的「保险三件套作一张保单整体更新」口径——insureDue 现在是独立可编辑字段,续保直接改到期日即可。


1. 前端要改什么

位置 改动
车辆新增 / 编辑表单 去掉「保险公司」「保单号」两个输入框;保留「保险到期日」;保险单证件继续走「保险单」附件上传
车辆详情页 出参不再返回 insurer / policyNo;保险公司、保单号看「保险单」附件图片
车辆列表页 列表项不再返回 insurer(如有展示该列请移除)
Excel 批量导入 模板去掉「保险公司」「保单号」两列;保险相关只保留「保险到期日」列

2. 字段变更明细

字段 出现位置 变更
insurer 保险公司 新增入参 / 编辑入参 / 详情出参 / 列表出参 / 导入列 移除
policyNo 保单号 新增入参 / 编辑入参 / 详情出参 / 导入列 移除
insureDue 保险到期日 新增入参 / 编辑入参 / 详情出参 / 列表出参 / 导入列 保留(独立可编辑)

3. 详情出参示例(变更后)

GET /admin/fleet/vehicles/{vehicleId}

{
  "code": 0,
  "data": {
    "id": "<vehicleId>",
    "plate": "蒙A-88888",
    "vehicleModelId": "<id>",
    "modelName": "丰田汉兰达",
    "seats": 7,
    "fleet": "own",
    "vehicleStatus": "idle",
    "vin": "LFV2A2********01",
    "regDate": "2022-03-15",
    "inspectDue": "2027-03-15",
    "insureDue": "2026-03-14",
    "regCertNo": "150102A******01",
    "regCertOwner": "内蒙古驼路旅行社",
    "regCertUsage": "营运租赁",
    "regCertFrontUrl": "https://oss.../front.jpg",
    "regCertBackUrl": "https://oss.../back.jpg",
    "primaryDriverId": "<driverId>",
    "primaryDriverName": "王师傅",
    "attachments": [
      { "category": "insurance", "url": "https://oss.../policy.jpg", "mimeType": "image/jpeg", "sortNo": 0 }
    ],
    "createTime": "2026-01-10T10:00:00+08:00"
  },
  "msg": "成功"
}

对比变更前:删去了 "insurer": "中国人保""policyNo": "PVAA20260001" 两行。


4. 验证

  • hl-fleet-service 209 单测全绿。
  • 已部署测试服(双实例 8087 + 8187 均 UP,经运行态 OpenAPI 实测 VehicleDetailRespVO 已无 insurer / policyNo、仍有 insureDue
  • DB fleet_vehicle 已 DROP COLUMN insurer / policy_noFlyway V20260608_001,双实例正常启动即迁移成功)。

5. 关联文档

文档 版本
API-SPEC-FLEET v1.5.16
DATABASE-SCHEMA-FLEET v1.5.13
SRS-FLEET v1.5§5.2 保险登记)