From 213c2b40e08068cd65e2b1b3f3cc562c20cfdb73 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Fri, 12 Jun 2026 17:56:48 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E5=90=8E=E7=AB=AF=E6=A0=B8?=
 =?UTF-8?q?=E5=AE=9E=E5=9B=9E=E6=89=A7=20=E4=BF=9D=E5=8D=95=E6=8C=89?=
 =?UTF-8?q?=E9=92=AE=E4=B8=A4=E5=A4=84=E6=94=B6=E6=95=9B+=E8=BD=A6?=
 =?UTF-8?q?=E8=BE=86=E5=AF=BC=E5=85=A5=E5=BC=B9=E7=AA=97=E6=98=A0=E5=B0=84?=
 =?UTF-8?q?=E7=A1=AE=E8=AE=A4=20blob=E8=AE=AE=E9=A2=98=E5=85=B3=E9=97=AD?=
 =?UTF-8?q?=20=E9=80=9A=E7=9F=A5=20mmg?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 ...•æŒ‰é’®æ”¶æ•›ä¸Žè½¦è¾†å¯¼å…¥å¼¹çª—映射-无接å�£å�˜æ›´-管ç�†å�Žå�°.md | 53 +++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 changelogs-v2/2026-06/12_�端核实回执_��按钮收敛与车辆导入弹窗映射-无接��更-管���.md

diff --git a/changelogs-v2/2026-06/12_�端核实回执_��按钮收敛与车辆导入弹窗映射-无接��更-管���.md b/changelogs-v2/2026-06/12_�端核实回执_��按钮收敛与车辆导入弹窗映射-无接��更-管���.md
new file mode 100644
index 0000000..3ba929e
--- /dev/null
+++ b/changelogs-v2/2026-06/12_�端核实回执_��按钮收敛与车辆导入弹窗映射-无接��更-管���.md
@@ -0,0 +1,53 @@
+# ��端核实回执·管���】��按钮两处收敛 + 车辆导入弹窗映射——�端 SYNC-20260612-10 全部确认，无接��更
+
+> �务:hl-order-service-v3(8086/8186) + hl-fleet-service(8087) | 对应�端:SYNC-20260612-10(commit f642b064) | �端无代�改动,本文是核实回执(2026-06-12)
+> 背景:�端回报「下载/�传���真实�点在�险订��账页(��机抽屉),已两处按 source 收敛;并修车辆导入结果弹窗字段映射;质疑 blob 归因。�端�项核实如下。
+
+## ⚠� 关键说明
+
+1. **�端两处收敛方案�端全部确认正确,�方版本在测试�已对�**,�端无需�动。
+2. 此� changelog 12_3765 写按钮在「详情抽屉�系沿用最��馈原�,实际�点在�账页——契约指引(按 `source` 收敛)两处通用,结论��。
+3. blob/InvalidStateError 议题�方归零关闭(� §3)。
+
+## 1. ��按钮收敛——�端契约�项核实(�实测)
+
+| �端收敛点 | �端支撑 | 实测结论 |
+|---|---|---|
+| �账页 MANUAL 行��「下载/�传��� | `GET /v3/admin/insurance/list` 列表行 VO 自带 `source`(BAOYOU/MANUAL) | 测试�实测�行 source � null;直调下载/�传返 **540226** 兜底 |
+| �账页 MANUAL 行��「退��(上批已收敛) | 管�端退�接�拦 MANUAL | 返 **540224**「手工录入的年���支�退�� |
+| �机抽屉 MANUAL 行��「退��+ 加「手工录入�标识 | `GET /admin/fleet/drivers/{driverId}/insurance/policies` �行 `source` 字段�为此用 | 与 540224 守�严��� |
+
+�账列表实测示例(`GET /v3/admin/insurance/list?page=1&pageSize=10`):
+
+```json
+{
+  "insuranceOrderId": "2065360048397193217",
+  "source": "MANUAL",        // �行�返,� null
+  "bizType": "DRIVER",
+  "status": "CANCELLED"      // 该批 CANCELLED 是�端 E2E 清场数�,属正常
+}
+```
+
+注�:**判断按钮显�请�认 `source`,勿用 `bizType` 当代�**——�机行程险走�游网出�时 `bizType=DRIVER` 但 `source=BAOYOU`,有电���,下载/�传按钮应�留。
+
+## 2. 车辆导入结果弹窗映射——�端�写目标字段与�端 VO 完全一致
+
+�端 `VehicleImportRespVO` 真实字段(核实于当� dev-v3):
+
+| 字段 | 类型 | �义 |
+|---|---|---|
+| `totalRows` | int | 数�总行数 |
+| `insertedCount` | int | 新增�功数 |
+| `updatedCount` | int | 更新�功数 |
+| `errorCount` | int | 失败行数 |
+| `errors` | array | 失败明细(行�+原因) |
+| `warnedCount` | int | 警告行数 |
+| `warnings` | array | 警告明细 |
+
+�端旧映射(failed/errorRows/success/total)确实全部�存在于�端 VO,「导入�功 0 ��怪象由此而�,�写�正确。�机导入 `DriverImportRespVO` 字段结构��,如需对照�看测试� doc.html。
+
+## 3. blob/InvalidStateError 议题关闭
+
+- �端全仓核查无 `responseType:'blob'` �置;�端侧该归因�样无代�对应物——此�那�「�端Bug_车辆批�导入responseType-blob�changelog 的归因有误,以本回执为准。
+- 真实病因� §2 的弹窗字段映射 bug,已修。
+- 若真机�续��现该 console 报错,排查方�是测试�部署的�端构建��(是�旧构建残留),与�方当�代�无关。