From 44cacffd9bc0f4df86fab051565efa6209a41fce Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sat, 13 Jun 2026 12:17:35 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E5=8F=B8=E6=9C=BA=E5=BE=85?=
 =?UTF-8?q?=E5=AE=A1=E6=A0=B8=E5=88=97=E8=A1=A8=E8=BF=87=E6=BB=A4+?=
 =?UTF-8?q?=E6=8B=89=E9=BB=91=E8=A7=A3=E5=B0=81=E7=AB=AF=E7=82=B9+?=
 =?UTF-8?q?=E5=85=A8=E5=B9=B4=E4=BF=9D=E9=99=A9=E4=B8=8B=E6=8B=89=E5=85=B3?=
 =?UTF-8?q?=E8=81=94+=E4=BF=9D=E9=99=A9=E4=B8=8B=E5=8D=95=E9=A1=B5?=
 =?UTF-8?q?=E6=A0=B8=E5=AE=9E=20(#3791/#3792/#3793)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¡¨è¿‡æ»¤æœªæ��交空壳和作废链接-行为å�˜æ›´-管ç�†å�Žå�°.md | 21 +++++++++++++
 ..._�机拉黑解�独立端点-新增接�-管���.md | 30 +++++++++++++++++++
 ...¿�å�•å�·æ”¹ä¸‹æ‹‰å…³è�”ä¿�游网ä¿�å�•-行为å�˜æ›´-管ç�†å�Žå�°.md | 23 ++++++++++++++
 ...¡µäº§å“�下拉空与å�¸æœºé™©æ··æ·†-å�Žç«¯æ­£å¸¸æ— éœ€æ”¹-管ç�†å�Žå�°.md | 18 +++++++++++
 4 files changed, 92 insertions(+)
 create mode 100644 changelogs-v2/2026-06/13_3791_待审核列表过滤未�交空壳和作废链接-行为�更-管���.md
 create mode 100644 changelogs-v2/2026-06/13_3792_�机拉黑解�独立端点-新增接�-管���.md
 create mode 100644 changelogs-v2/2026-06/13_3793_全年�险���改下拉关��游网��-行为�更-管���.md
 create mode 100644 changelogs-v2/2026-06/13_�端核实_�险下�页产�下拉空与�机险混淆-�端正常无需改-管���.md

diff --git a/changelogs-v2/2026-06/13_3791_待审核列表过滤未�交空壳和作废链接-行为�更-管���.md b/changelogs-v2/2026-06/13_3791_待审核列表过滤未�交空壳和作废链接-行为�更-管���.md
new file mode 100644
index 0000000..ce15726
--- /dev/null
+++ b/changelogs-v2/2026-06/13_3791_待审核列表过滤未�交空壳和作废链接-行为�更-管���.md
@@ -0,0 +1,21 @@
+# �行为�更·管���】�机待审核列表�回真正�交的记录——过滤未�交空壳 + 已作废链接
+
+> �务:hl-fleet-service(8087/8187) | 分支:dev-v3 | PR:#3791 | 已部署测试�并 API 实测通过(2026-06-13)
+> 背景:wx �馈「待审核页数�全空�——�片姓�/身份�/�交时间/照片全空。根因=列表把「�机点了 H5 链接但还没填写�交�的��空壳�以�已作废链接也�进了审核队列。
+
+## ⚠� 关键说明(�端动作)
+
+1. **`GET /admin/fleet/drivers/pending` 行为�更(无需改�端代�,数�自动�干净)**:列表现在�返回**真正�交过且链接未作废**的记录,与「我的链接�派生� `SUBMITTED` ��径。两��生效基线过滤:
+   - `submitted_at IS NOT NULL`——排除「生�链接但�机未填写�交�的��空壳(生�链接那一刻就�了一行 pending+未�交的��行)
+   - `void_status='NORMAL'`——排除已作废链接(作废与审核正交,死链�进审核队列)
+2. **现象解释**:测试�修��待审核 tab 有 8 张全空�片(全是未�交空壳),修��为 0 �(当�确实没有真正�交待审的�机);已驳回 tab 从 6 �(� 1 �异常空壳)� 5 �真实记录。**待审核 tab 看起�"�空"是正确的**——空壳本就�该出现。
+3. **「申请详情页��端已就绪**:审核详情端点 `GET /admin/fleet/drivers/pending/{pendingId}`(PR#3785 已�)返回�件原图 URL / 驾照正副页 / 紧急�系人 / 自带车实�照 / 备注(PII 脱�),�存在返 600402。**审核�片的「查看详情�抽屉�以接这个端点**看全�明细。
+
+## 实测(测试�)
+
+修��: 待审核 8 �全 submittedAt=null 空壳 / 全部状� 15 ��空壳。
+修��: 待审核 0 � / 全部状� 6 �(approved 1+rejected 5)全部 submittedAt �空 / 已驳回 5 �真实记录(姓�+�交时间�全)。
+
+## 影��
+
+仅列表查询行为�更,approve/reject/详情端点��影�;零接�签��化�零 DDL�零路由。
diff --git a/changelogs-v2/2026-06/13_3792_�机拉黑解�独立端点-新增接�-管���.md b/changelogs-v2/2026-06/13_3792_�机拉黑解�独立端点-新增接�-管���.md
new file mode 100644
index 0000000..09907bb
--- /dev/null
+++ b/changelogs-v2/2026-06/13_3792_�机拉黑解�独立端点-新增接�-管���.md
@@ -0,0 +1,30 @@
+# �新增接�·管���】�机风控拉黑 + 解�两个独立端点——�机�片�加「拉黑/解��按钮
+
+> �务:hl-fleet-service(8087/8187) | 分支:dev-v3 | PR:#3792 | 已部署测试�并 API 往返实测通过(2026-06-13)
+> 背景:wx �馈「�机�片没有拉黑按钮�。原先拉黑�能走通用编辑端点(PUT 设 season=blacklist),且全� VO �端�回传 attachments/tags 会误删�解�更是无任何端点。wx ��补独立端点。(车辆拉黑 wx 已撤回·看原型,本次���机)
+
+## ⚠� 关键说明(�端动作)
+
+1. 🆕 **拉黑** `POST /admin/fleet/drivers/{driverId}/blacklist`
+   - 入� body:`{"blacklistReason": "客诉原因..."}`(原因**�选**,≤256;�传�端�空串)
+   - 出�:`{"code":200,"message":"�功"}`
+   - 规则:active/pending/archived �机��拉黑;已是黑��返 **600202**;�机�存在返 **600205**
+   - **�机�片加「拉黑�按钮**(弹框让�作人填�选原因)调本端点。�端�定�写 season+拉黑原因+拉黑时间三列,**�碰附件/标签**(��有误删风险)——比之�走编辑端点 PUT 的方案安全,请改用本端点。
+2. 🆕 **解�** `POST /admin/fleet/drivers/{driverId}/unban`
+   - 入�:无 body(仅路径�数)
+   - 出�:`{"code":200,"message":"�功"}`
+   - 规则:当�必须是黑��(�则返 **600208**「�机当��是黑��状�,无需解��);解�� season 回 **active** + 清空拉黑原因/时间
+   - **黑�� tab 的�机加「解��按钮**调本端点。
+3. **拉黑/解�会�动车辆**:拉黑→该�机常驻个人车自动�用(service_status=DISABLED);解�→�� ACTIVE。
+
+## ⚠� 已知缺�(知会)
+
+解�的「主管级���门�**暂未加**(hl-fleet 当�无 RBAC 框架�hl-user 未� fleet 角色),当�任何登录管�员都能解�,待 hl-user � supervisor 角色�接入。�端解�按钮�正常对接,��收紧是�端�续动作。
+
+## 实测(测试�往返)
+
+拉黑(中文原因)→200+season=blacklist+原因�库 / 解�→200+season=active+原因清空 / �黑���解�→600208 / �存在�机→600205 / ��拉黑→600202。
+
+## 影��
+
+错误�新增 600208;网关 `/admin/fleet/**` 通�已覆盖;零 DDL。原 PR#3785 �到的「编辑端点 blacklistReason 入����留,但**拉黑按钮请改用本专用端点**(��全� VO 误删)。
diff --git a/changelogs-v2/2026-06/13_3793_全年�险���改下拉关��游网��-行为�更-管���.md b/changelogs-v2/2026-06/13_3793_全年�险���改下拉关��游网��-行为�更-管���.md
new file mode 100644
index 0000000..feac8cf
--- /dev/null
+++ b/changelogs-v2/2026-06/13_3793_全年�险���改下拉关��游网��-行为�更-管���.md
@@ -0,0 +1,23 @@
+# �行为�更·管���】编辑�机·全年�险「����从手填改为下拉关�该�机已出的�游网��
+
+> �务:hl-fleet-service(8087/8187) | 分支:dev-v3 | PR:#3793 | 已部署测试�(下拉数��端点 200 实测�达,完整投��待�端�调)(2026-06-13)
+> 背景:wx �馈编辑�机弹窗「�险�置·全年�险�的���是手填输入框,应改为从该�机已出的�游网��里下拉选择关�。wx ��:改下拉关�,�留手填兜底。
+
+## ⚠� 关键说明(�端动作)
+
+1. **编辑弹窗「����输入框 → 下拉/�索选择器**:
+   - 下拉数�� = `GET /admin/fleet/drivers/{driverId}/insurance/policies`(�机「我的���,已有端点);**仅 status=INSURED(已承�)/INSURING(在途出�中)�选**。
+   - 选中����,把该��的 `insuranceOrderId` 放进�存入� `insurance.insuranceOrderId` �交。
+   - 选中�**���/年�费/�障起止改为�读回显**(由�端按��真值回填),�端��手敲这四项。
+2. **�存入� `DriverInsuranceVO.insuranceOrderId` 已放开**(原「入�忽略�):
+   - `insurance.type=annual` 且传 `insuranceOrderId` → �端按�机维度�查该��,回填���/�费/起止 + � `annualSource=baoyou` + 关� `insurance_order_id`。
+   - 横�越�守�:传入的���属于该�机 / 状���关� → 返 **600209**「关�的�游网���存在��属于该�机或状���关��。�端正常从该�机下拉选�会触�。
+3. **手填路径�留兜底**(二选一,insuranceOrderId 优先):�传 `insuranceOrderId`�仅手填 `policyNo`+�费+起止时,�走原手填路径(`annualSource=manual`,行为零�化),用于线下买的��游网没有的��。
+
+## 实测(测试�)
+
+下拉数��端点 `/insurance/policies` code=200 �达;�查回填 + 600209 越�路径由�测覆盖(DriverServiceTest+4 / DriverAnnualPolicyLookupImplTest 5,fleet 全套 714 绿);完整「选��→回填→�存�端到端需�端接入��调。
+
+## 影��
+
+错误�新增 600209;**零新增 Feign/DTO/order-v3 端点/Flyway/网关路由**(�用现有按�机查�� Feign);�端架构用 driver �域端� + insurance �域实现解环。
diff --git a/changelogs-v2/2026-06/13_�端核实_�险下�页产�下拉空与�机险混淆-�端正常无需改-管���.md b/changelogs-v2/2026-06/13_�端核实_�险下�页产�下拉空与�机险混淆-�端正常无需改-管���.md
new file mode 100644
index 0000000..b0f191a
--- /dev/null
+++ b/changelogs-v2/2026-06/13_�端核实_�险下�页产�下拉空与�机险混淆-�端正常无需改-管���.md
@@ -0,0 +1,18 @@
+# ��端核实·管���】�险下�页「�险产�下拉空�是�端未加载——�端已返 10 个 ACTIVE 产�;此页与�机险是两套(��异物)
+
+> �务:hl-order-service-v3(�险模�) | 无 PR(�端核实,无需改) | 测试� API 实测(2026-06-13)
+> 背景:wx 看「�险管�→�险订�→投�下��弹窗,问「�险下�页�咋没改呢�,且产�下拉为空。�排查为两个独立认知点,�端无 bug。
+
+## ⚠� 关键说明
+
+1. **「�险下�页�没改�= ��异物混淆,此页本就�该跟��机险改**:
+   - 这个「�险订� / 投�下��页走的是 **游客订�险**(order-v3 `AdminInsuranceController` `/v3/admin/insurance/purchase`,`PurchaseInsuranceRequest`,productId+planId 模型)。
+   - 而最近改的「�机险走�游网�(PR#3700:perTrip→insurancePlanId 必填�删 perDayRate 等)改的是 **fleet �机档案页**的�险,是**�一套独立模型**。
+   - 两者「�险计划/insurancePlanId�**��异物**(API 文档 v1.5.64 已�术语消歧)。所以投�下�页没跟�改是正确的。
+2. **「�险产�下拉空�是�端问题,�端正常**:
+   - 测试�实测 `GET /v3/admin/insurance/products/all` 返 **code=200 + 10 个 status=ACTIVE 产�**(如「山河令(太�山东新)�)。�端产�列表端点工作正常�有数�。
+   - 截图里下拉空,是**�端未加载/未渲染**该端点数�。请�端检查投�下�弹窗的产�下拉是�正确调 `/v3/admin/insurance/products/all`�计划下拉调 `/v3/admin/insurance/products/{productId}/plans`。
+
+## 结论
+
+投�下�页端点/契约/产�计划下拉数���端全部正常,**无需�端改动**。产�下拉空请�端排查数�加载。