changelog: f794175 - fix: 保险服务余额查询超时优化 + 充值接口废弃标记

changelogs/2026-03/2026-03-24_1554_f794175_fix.md

@@ -0,0 +1,79 @@
+# 接口变更记录 — 2026-03-24 15:54
+
+> **提交** `f794175` · **作者** wx · **时间** 2026-03-24 15:54:33 +0800
+>
+> fix: 保险服务余额查询超时优化 + 充值接口废弃标记
+
+## 变更总览
+
+- **保险服务**
+  - AdminInsurance (+1, 名1)
+  - InternalInsurance (+2)
+
+---
+
+## 保险服务
+
+### AdminInsurance
+
+> 📖 **接口文档**: [http://192.168.100.236:8098/doc.html](http://192.168.100.236:8098/doc.html) → 标签 **「保险管理」**
+
+### 🆕 `POST` /admin/insurance/upload-missing-pdfs — 补传旧保单PDF到OSS
+
+> 将所有已承保但未上传PDF的保单，异步下载PDF并上传到OSS。用于历史数据迁移。
+
+**响应** `Result<Integer>`
+
+### 接口名称更新
+
+| 方法 | 路径 | 原名称 → 新名称 |
+| --- | --- | --- |
+| `GET` | `/admin/insurance/recharge-url` | 获取保游网充值链接(旧接口,保留兼容) → **获取保游网充值链接(已废弃)** |
+
+### InternalInsurance
+
+> 📖 **接口文档**: [http://192.168.100.236:8098/doc.html](http://192.168.100.236:8098/doc.html) → 标签 **「【内部接口】保险（Feign调用）」**
+
+### 🆕 `GET` /internal/insurance/policy/{id}/download — 下载单张保单PDF(内部调用)
+
+> 内部服务间调用。从保游网下载指定保险订单的电子保单PDF，以Base64编码返回。
+
+**参数**
+
+  - `{insuranceOrderId}` (`Long`) — 路径参数：保险订单ID
+
+**响应** `Result<String>`
+
+### 🆕 `POST` /internal/insurance/upload-missing-pdfs — 补传旧保单PDF到OSS(内部调用)
+
+**响应** `Result<Integer>`
+
+---
+
+## 📦 其他数据对象变更
+
+> 以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应
+
+### 保险服务
+
+#### ✏️ InsuranceOrderVO
+
+  - 🆕 `policyPdfUrl` (`String`) — 保单PDF的OSS链接（.pdf结尾，可直接访问）
+
+<details>
+<summary>📁 全部变更文件 (点击展开)</summary>
+
+```
+M	hl-insurance-service/pom.xml
+M	hl-insurance-service/src/main/java/com/hulalv/insurance/config/RestTemplateConfig.java
+M	hl-insurance-service/src/main/java/com/hulalv/insurance/constant/InsuranceConstants.java
+M	hl-insurance-service/src/main/java/com/hulalv/insurance/controller/AdminInsuranceController.java
+M	hl-insurance-service/src/main/java/com/hulalv/insurance/controller/InternalInsuranceController.java
+M	hl-insurance-service/src/main/java/com/hulalv/insurance/entity/InsuranceOrder.java
+M	hl-insurance-service/src/main/java/com/hulalv/insurance/service/BaoyouApiClient.java
+M	hl-insurance-service/src/main/java/com/hulalv/insurance/service/InsuranceOrderService.java
+A	hl-insurance-service/src/main/java/com/hulalv/insurance/service/PolicyPdfUploadService.java
+M	hl-insurance-service/src/main/java/com/hulalv/insurance/vo/InsuranceOrderVO.java
+M	hl-insurance-service/src/test/java/com/hulalv/insurance/service/BaoyouApiClientTest.java
+```
+</details>