From d934d7887f46449b7f041723db9fc1c4c0c2ed06 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 10 Jun 2026 14:56:39 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#3642=20=E4=BF=9D=E9=99=A9?=
 =?UTF-8?q?=E5=87=BA=E5=8D=95=E6=94=B9=E5=BC=82=E6=AD=A5-=E7=8A=B6?=
 =?UTF-8?q?=E6=80=81=E6=96=B0=E5=A2=9EINSURING-=E7=AE=A1=E7=90=86=E5=90=8E?=
 =?UTF-8?q?=E5=8F=B0+=E5=B0=8F=E7=A8=8B=E5=BA=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...Š¶æ€�新增INSURING出å�•ä¸­-修改接å�£-管ç�†å�Žå�°+å°�程åº�.md | 44 +++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 changelogs-v2/2026-06/10_3642_�险出�改异步-状�新增INSURING出�中-修改接�-管���+�程�.md

diff --git a/changelogs-v2/2026-06/10_3642_�险出�改异步-状�新增INSURING出�中-修改接�-管���+�程�.md b/changelogs-v2/2026-06/10_3642_�险出�改异步-状�新增INSURING出�中-修改接�-管���+�程�.md
new file mode 100644
index 0000000..28b6c0a
--- /dev/null
+++ b/changelogs-v2/2026-06/10_3642_�险出�改异步-状�新增INSURING出�中-修改接�-管���+�程�.md
@@ -0,0 +1,44 @@
+# �修改·管���+�程�】�险出�改异步,�险状�新增 INSURING(出�中),����能延迟回填
+
+> 存放目录: changelogs-v2/2026-06/
+> 涉��务: hl-order-service-v2 / hl-order-service-v3 / hl-gateway
+> PR: #3646(已�并 dev-v3) | Issue: #3642 | 日期: 2026-06-10
+> 影�范围: 管����险列表/订�详情��程��险展示的**状�字段**与**���字段**
+
+## ⚠� 关键说明(�端必看 2 点)
+
+�游网�险接��级到 4.2"�费出�",**出�从"�步�时返回���"改为部分产�"异步出�"**(��确认收费��回调出�结果)。对�端展示有两处影�,�为**��兼容的字段�值�化**,无字段增删�无结构�化:
+
+1. **�险状�(insuranceStatus / �险订� status)新增�值 `INSURING`(出�中)**。原值域 `NONE / INSURED / CANCELLED / FAILED`,现增加 `INSURING`。请�端在�险状�字典/映射中补这一项,文案建议"出�中",�则该状�会显示为原始� `INSURING` 或�入 default 分支。
+2. **���(extPolicyNo / policyNo)在异步出�产�下,投��功瞬间为空**,需等�游回调到达�回填。�端����为空且状�为 `INSURING` 时,应显示"出�中,���生��展示",��显示为投�失败。
+
+> 注:仅"异步出�"产�(�游下��步�应 MsgCode=80099)会�历 `INSURING` 窗�;"实时出�"产�(MsgCode=10000)�直接 `INSURED` 并立�带���,行为��。�游本月内�步切����接�,故 `INSURING` 会在切��开始出现。
+
+## 1. �险状�值域(完整字典)
+
+| 状�� | �义 | 说明 |
+|--------|------|------|
+| `NONE` | 无�险 | 订�未生��险(仅订�主表镜�字段出现) |
+| `INSURING` | **出�中(新增)** | 异步出����功,等��回调确认出� |
+| `INSURED` | 已投� | 出��功,有��� |
+| `CANCELLED` | 已退� | — |
+| `FAILED` | 投�失败 | 出�失败,��投 |
+
+管���订�主表镜� `insuranceStatus` ��优先级:`INSURED > INSURING > CANCELLED > FAILED > NONE`。
+
+## 2. �影�接�(�值�化,�结构�化)
+
+| 端 | 接� | �化点 |
+|----|------|--------|
+| 管��� | �险订�列表/详情(`/admin/insurance/*`�`/v3/admin/insurance/*`) | status/statusLabel �能为 INSURING/出�中;policyNo �能为空 |
+| 管��� | 订�详情-���险 Tab | insuranceStatus �能为 INSURING;����能空 |
+| �程� | �险详情/��展示(`/mp/insurance/*`�订��险�) | status/statusLabel �上;policyNo 空时 PDF 暂��下载(显示"出�中") |
+
+## 3. 无需�端改动的部分
+
+- �游回调接收端点(`/insurance/callback/baoyou`�`/v3/insurance/callback/baoyou`)是**�端接收�游通知**的内部端点,�端�调用。
+- 出��功回调到达�,�端自动回填��� + 翻 INSURED + 触� PDF 上传 + �投��功通知,�端按现有逻辑刷新��看到。
+
+## 验�
+
+测试�已部署(hl-gateway / hl-order-service-v2 / hl-order-service-v3),回调端点�网关 9443 �达(HTTP 200)。`INSURING` �的真实产生需�游切�异步出�产��触�。