3.7 KiB
3.7 KiB
【字段移除·车辆档案】车辆保险登记瘦身 — 删除「保险公司 / 保单号」字段
变更类型:🟠 字段移除(出入参 + 列表 + 导入列) 端类型:管理后台 服务:hl-fleet-service PR:wx/HL#3600 日期:2026-06-08 影响范围:车辆新增 / 编辑 / 详情 / 列表 / Excel 导入
⚠️ 关键说明
车辆「保险登记」的两个结构化字段 insurer(保险公司)/ policyNo(保单号)已删除。
原因:保险公司、保单号、险种、保额、起止日等明细,已全部承载在「保险单」附件图片(attachments 里 category=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-service209 单测全绿。- 已部署测试服(双实例 8087 + 8187 均 UP),经运行态 OpenAPI 实测
VehicleDetailRespVO已无insurer/policyNo、仍有insureDue。 - DB
fleet_vehicle已 DROP COLUMNinsurer/policy_no(FlywayV20260608_001,双实例正常启动即迁移成功)。
5. 关联文档
| 文档 | 版本 |
|---|---|
| API-SPEC-FLEET | v1.5.16 |
| DATABASE-SCHEMA-FLEET | v1.5.13 |
| SRS-FLEET | v1.5(§5.2 保险登记) |