ebcaf76a31
列表VO与详情VO字段名分叉,前端列表表格复用详情字段名(totalPremium/startDate/policyHolderName) 读列表落空。后端把列表接口补齐成与详情同款双名,前端多数无需改动刷新即显示。 已合并dev-v3+部署测试服双实例+6/6实测新字段齐全。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
3.1 KiB
3.1 KiB
【行为修复·管理后台】保险订单列表「投保人 / 保障期间 / 总保费」三列不再为空
端：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"
}]
}
}
验收
保险订单列表「投保人」显示投保主体公司名（如「内蒙古呼籁国际旅行社有限公司」），「总保费」显示金额，「保障期间」显示起止日期。出单中的单「保单号」为空/占位属正常，出单后回填。