diff --git a/changelogs-v2/2026-06/15_保险订单列表补投保人+保费保障期字段-修列表三列空-管理后台.md b/changelogs-v2/2026-06/15_保险订单列表补投保人+保费保障期字段-修列表三列空-管理后台.md new file mode 100644 index 0000000..e5b671b --- /dev/null +++ b/changelogs-v2/2026-06/15_保险订单列表补投保人+保费保障期字段-修列表三列空-管理后台.md @@ -0,0 +1,54 @@ +# 【行为修复·管理后台】保险订单列表「投保人 / 保障期间 / 总保费」三列不再为空 + +> 端:hl-ui(保险管理 → 保险订单列表)| 服务:hl-order-service-v3 insurance | PR #3831 已合并 dev-v3 + 部署测试服双实例 + 实测 | 2026-06-15 + +## ⚠️ 关键说明 + +保险订单列表表格的「**投保人 / 保障期间 / 总保费**」三列此前全空。**后端数据一直是齐全的**(实测 premium=27.0、保障期 2026-06-16~2026-07-31 都有值),空的原因是**列表接口字段名与详情接口分叉**——前端列表表格复用了**详情接口的字段名**,而列表接口当时没给这些名。 + +本次**后端把列表接口的字段补齐成与详情接口同款**,前端**多数情况下无需改动**,刷新即可显示。 + +## 1. 列表接口 `GET /v3/admin/insurance/list` 现已返回的字段(已补齐) + +| 列 | 现在可读的字段(任选其一,**同值**) | 实测值示例 | +|---|---|---| +| **投保人** | `policyHolderName` 🆕 | `内蒙古呼籁国际旅行社有限公司` | +| **总保费** | `totalPremium` 🆕 或 `premium` | `27.00` | +| **保障期间(开始)** | `startDate` 🆕 或 `coverageStartDate` | `2026-06-16` | +| **保障期间(结束)** | `endDate` 🆕 或 `coverageEndDate` | `2026-07-31` | + +- 🆕 标记的是本次**新增**字段;之前列表只有 `premium` / `coverageStartDate` / `coverageEndDate`,且**完全没有** `policyHolderName`。 +- 现在列表与详情接口(`GET /v3/admin/insurance/orders/{id}`)**字段名完全一致**,前端列表/详情可共用同一套字段读取,不会再出现「详情有、列表空」。 + +## 2. 「保单号」列显示「出单中,保单号生成中…」属正常 + +- 状态为「**出单中(INSURING)**」的订单,保游尚未出单,**本就没有保单号**,后端 `policyNo`/`extPolicyNo` 返回 `null` 是正确的。 +- 前端对 null 显示占位文案没问题。出单成功后 `extPolicyNo` 会回填真实保单号。 +- 建议:保单号列优先读 `extPolicyNo`(`policyNo` 是兼容字段,后续版本将废弃)。 + +## 3. 列表响应示例(实测,dev-v3 已部署) + +```json +{ + "code": 200, + "data": { + "records": [{ + "insuranceOrderId": "2066402144482709506", + "extOrderNo": "BX2026061514071660000217", + "extPolicyNo": null, "policyNo": null, + "productName": "山河令(太保山东新)", "planName": "10万计划", + "policyHolderName": "内蒙古呼籁国际旅行社有限公司", + "premium": 27.00, "totalPremium": 27.00, + "insuredCount": 1, + "coverageStartDate": "2026-06-16", "coverageEndDate": "2026-07-31", + "startDate": "2026-06-16", "endDate": "2026-07-31", + "status": "INSURING", "statusLabel": "出单中", + "source": "BAOYOU", "bizType": "DRIVER" + }] + } +} +``` + +## 验收 + +保险订单列表「投保人」显示投保主体公司名(如「内蒙古呼籁国际旅行社有限公司」),「总保费」显示金额,「保障期间」显示起止日期。出单中的单「保单号」为空/占位属正常,出单后回填。