diff --git a/changelogs-v2/2026-06/08_3600_车辆保险登记瘦身-删保险公司保单号字段-修改接口-管理后台.md b/changelogs-v2/2026-06/08_3600_车辆保险登记瘦身-删保险公司保单号字段-修改接口-管理后台.md new file mode 100644 index 0000000..82c129c --- /dev/null +++ b/changelogs-v2/2026-06/08_3600_车辆保险登记瘦身-删保险公司保单号字段-修改接口-管理后台.md @@ -0,0 +1,98 @@ +# 【字段移除·车辆档案】车辆保险登记瘦身 — 删除「保险公司 / 保单号」字段 + +> **变更类型**:🟠 字段移除(出入参 + 列表 + 导入列) +> **端类型**:管理后台 +> **服务**:hl-fleet-service +> **PR**:https://git.1814.love:8443/wx/HL/pulls/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}` + +```json +{ + "code": 0, + "data": { + "id": "", + "plate": "蒙A-88888", + "vehicleModelId": "", + "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": "", + "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_no`(Flyway `V20260608_001`,双实例正常启动即迁移成功)。 + +--- + +## 5. 关联文档 + +| 文档 | 版本 | +|---|---| +| API-SPEC-FLEET | v1.5.16 | +| DATABASE-SCHEMA-FLEET | v1.5.13 | +| SRS-FLEET | v1.5(§5.2 保险登记) |