# 修复:保险产品列表「保险公司」列空白,降级到默认承保方

**类型**: 后端 BUG 修复 + 配置补丁
**关联**: 工单 #1544 / PR #1545
**日期**: 2026-04-30
**影响范围**: 管理后台保险产品列表展示;后续保游网产品同步流程

---

## 现象

管理后台 `web.test.1814.love:9443/insurance/products` 列表「保险公司」列对所有产品(山河令、保游未来星、平安保游万里行、保游天下平安自驾游、平安快乐旅程III、签证宝等)全部空白,投保年龄/保障天数也都是 `-`。

API `GET /admin/insurance/products` 返回 `"insurerName":null,"companyName":null`。

## 根因

保游网 `/ApiProduct/v2/GetProductList` 接口仅返回 `{Guid, Isjw, Isjssx, ProductName}` 4 个字段,**不返回 CompanyName / ProductType / MinDays / MaxDays / MinAge / MaxAge**。

DB `insurance_product` 表 raw_json 列实证:
```json
{"Guid": "FAB0BF91...", "Isjw": 20, "Isjssx": 20, "ProductName": "保游天下..."}
```

`InsuranceManageService.mapProductFields()` 试图取这些字段,全部 null,sync 时把 NULL 写入 DB 各列。

GetPlanList / GetPlanRateList 的 raw_json 也无 CompanyName,已穷举保游网 3 个产品相关 API 确认无该字段。

## 业务事实(用户确认)

保游网即亚太财险保险有限公司销售渠道,所有保游产品承保方均为「亚太财险保险有限公司」(固定值)。

## 修复内容

### 1. BaoyouApiProperties 新增 defaultCompanyName 字段
```java
/** 保游网产品默认承保方名称(保游网 GetProductList 不返回 CompanyName,固定为亚太财险保险有限公司) */
private String defaultCompanyName;
```

### 2. mapProductFields 缺失/空白时降级
```java
String companyName = getTextSafe(item, "CompanyName");
if (companyName == null || companyName.isBlank()) {
    companyName = baoyouApiProperties.getDefaultCompanyName();
}
product.setCompanyName(companyName);
```

### 3. nacos test namespace 同步推送
`hl-order-service-v2-test.yml` `baoyou.api` 段新增:
```yaml
default-company-name: "亚太财险保险有限公司"
```
仓库 `nacos-config/hl-order-service-dev.yml` 同步加(防初始化漂移)。

### 4. 单测覆盖 3 条分支
- `mapProductFields_companyNameMissing_fallsBackToDefault` 缺失字段降级
- `mapProductFields_companyNamePresent_useFromJson` 兼容性场景用真实值
- `mapProductFields_companyNameBlank_fallsBackToDefault` 空字符串等同缺失

50/50 单测全绿。

## 修复后行为

### 数据库写入
新 sync 触发后,`insurance_product.company_name` 列从 NULL → 「亚太财险保险有限公司」。

### 历史数据回填
9 条已有 NULL 行需触发一次「同步产品」按钮 round-trip 一次性回写。

### 接口返回
`/admin/insurance/products` 响应中 `companyName` 与 `insurerName` 两字段均返回「亚太财险保险有限公司」(VO 双通道 v1 兼容)。

## 前端处理

**零影响**。前端无须改动:
- 列表表格已绑 `companyName` / `insurerName` 字段,后端返回真实值即正常显示
- 字段名不变、字段类型不变、字段数量不变

## 待修(下次迭代)

投保年龄(`minAge`/`maxAge`) 与保障天数(`minDays`/`maxDays`) 当前同样为 NULL,因保游网 GetProductList 不返回。需要接保游网详情接口(暂不知接口名)或从 InsuranceRate 的 raw_json 聚合(BeginAge/EndAge/DayRange)推算。本次不做。

## 部署状态

- ✅ PR #1545 合并到 dev (sha 8f29d4b9)
- ✅ 测试服 nacos `hl-order-service-v2-test.yml@test` 已同步 default-company-name
- ✅ 测试服后端已部署 hl-order-service-v2
- ✅ 管理端「同步产品」按钮 round-trip 验证通过
- ✅ 管理后台列表「保险公司」列显示「亚太财险保险有限公司」