docs(前端通知): 保险余额显示修复(不再¥0)+保险订单刷新出单状态端点 (PR #3827)

余额: 保游Data直接是余额串非Data.Balance,后端已修,前端无需改刷新即对(实测198304.4)。
新增 POST /v3/admin/insurance/orders/{id}/sync-status 主动对账,可给出单中订单加刷新按钮;
另有定时job每5分钟自动对账兜底。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

changelogs-v2/2026-06/15_保险余额显示修复+保险订单刷新出单状态端点-管理后台.md

@@ -0,0 +1,31 @@
+# 【行为修复+新增端点·管理后台】保险账户余额显示修复（不再¥0）+ 保险订单「刷新出单状态」端点
+
+> 端：hl-ui（保险管理 → 余额展示 / 保险订单列表·详情）| 服务：hl-order-service-v3 insurance | PR #3827 已合并 dev-v3 + 部署测试服双实例 + 实测 | 2026-06-15
+
+## 1. 保险账户余额显示修复（后端 bug，前端无需改）
+
+- **现象**：保险余额一直显示 **¥0**。
+- **根因**：保游 `/Pay/GetUserBalance` 返回 `{"IsSuccess":true,"Data":"198304.40"}`——`Data` **直接就是余额字符串**，后端原代码却取 `Data.Balance`（当嵌套对象），取不到返 0。
+- **已修**：后端按 Data 文本直取（兼容旧嵌套格式）。`GET /v3/admin/insurance/balance` 现返真实余额（实测 **198304.4**）。
+- **前端无需任何改动**，刷新即正确显示。
+
+## 2. 🆕 新增「刷新出单状态」端点（可选给保险订单加按钮）
+
+异步出单（保游 80099 受理）的保险订单会先处于「**出单中(INSURING)**」，等保游出单后才变「已承保」。新增一个主动对账端点，可让运营在订单页**手动点「刷新出单状态」**立即拉保游最新状态翻态（不用干等回调）：
+
+| 用途 | 方法 + 路径 | 入参/出参 |
+|---|---|---|
+| 刷新/同步出单状态 | `POST /v3/admin/insurance/orders/{id}/sync-status` | path `id`=保险订单ID；返回 `Result<InsuranceOrderDetailVO>`（刷新后的最新详情，含 status/statusLabel/policyNo）；错误码 INSURANCE_ORDER_NOT_FOUND |
+
+- **建议**：保险订单列表/详情，对「出单中」状态的单加一个「**刷新状态**」按钮，调本端点；返回的 detail 直接刷新该行/该详情。
+- 行为：后端会查保游订单详情对账——保游已出单→翻「已承保」并回填保单号；已退保→「已退保」；仍待出单→保持「出单中」（不会误翻）。**仅对账，不会重复出单。**
+- 网关 `/v3/admin/**` 已覆盖，无需后端/网关其它改动。
+
+## 3. 说明（无需前端关心，仅背景）
+
+- 后端已加**定时对账 job**（每 5 分钟自动扫「出单中」单查保游翻态），即使没人点按钮、保游回调也没到，出单中的单也会在保游出单后**自动**变已承保。手动端点只是让运营能立即刷新、不用等 5 分钟。
+- 保游异步出单回调（DES 密钥）也已在测试环境配好作双保险。
+
+## 验收
+
+余额展示页应显示真实余额（非 ¥0）。保险订单「出单中」的单，点「刷新状态」（接 sync-status）后：保游已出单则变「已承保」+ 显示保单号；保游仍在出则保持「出单中」。