changelog(fleet): 车辆保险登记瘦身 — 删保险公司/保单号字段 (PR #3600)

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": "<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_no`（Flyway `V20260608_001`，双实例正常启动即迁移成功）。
+
+---
+
+## 5. 关联文档
+
+| 文档 | 版本 |
+|---|---|
+| API-SPEC-FLEET | v1.5.16 |
+| DATABASE-SCHEMA-FLEET | v1.5.13 |
+| SRS-FLEET | v1.5（§5.2 保险登记） |