API Changelog Bot ebcaf76a31 docs(前端通知): 保险订单列表补投保人/保费/保障期字段——修列表三列空(PR #3831 )

列表VO与详情VO字段名分叉,前端列表表格复用详情字段名(totalPremium/startDate/policyHolderName)
读列表落空。后端把列表接口补齐成与详情同款双名,前端多数无需改动刷新即显示。
已合并dev-v3+部署测试服双实例+6/6实测新字段齐全。

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

2026-06-15 16:27:34 +08:00

3.1 KiB

原始文件 Blame 文件历史

【行为修复·管理后台】保险订单列表「投保人 / 保障期间 / 总保费」三列不再为空

端：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 已部署）

{
  "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"
    }]
  }
}

验收

保险订单列表「投保人」显示投保主体公司名（如「内蒙古呼籁国际旅行社有限公司」），「总保费」显示金额，「保障期间」显示起止日期。出单中的单「保单号」为空/占位属正常，出单后回填。

3.1 KiB 原始文件 Blame 文件历史 Unescape Escape