diff --git a/changelogs-v2/2026-06/15_保险订单详情与试算金额改String序列化-与列表对齐-管理后台.md b/changelogs-v2/2026-06/15_保险订单详情与试算金额改String序列化-与列表对齐-管理后台.md new file mode 100644 index 0000000..46a61ee --- /dev/null +++ b/changelogs-v2/2026-06/15_保险订单详情与试算金额改String序列化-与列表对齐-管理后台.md @@ -0,0 +1,24 @@ +# 【字段类型对齐·管理后台】保险订单「详情」与「保费试算」金额字段改 String 序列化,与列表对齐 + +> 端:hl-ui(保险订单详情 / 投保试算)| 服务:hl-order-service-v3 insurance | PR #3842 已合并 dev-v3 + 部署测试服 + 实测 | 2026-06-15 + +## ⚠️ 关键说明(前端需对齐解析类型) + +平台铁律:金额 JSON 出参一律用 **String**(避免大数/精度问题)。本次把保险几处遗漏的金额字段补齐为 String,**与列表口径一致**: + +| 端点 | 字段 | 旧 | 新 | +|---|---|---|---| +| 详情 `GET /v3/admin/insurance/orders/{id}` | `totalPremium` / `premium` | JSON 数字 `10.80` | JSON 字符串 `"10.80"` | +| 投保试算 `InsuranceTrialPriceRespVO` | `premium` | JSON 数字 | JSON 字符串 | + +> 列表 `GET /v3/admin/insurance/list` 的 `totalPremium`/`premium` 在上一版 (#3831) 已是 String。本次修复前,**列表返字符串、详情返数字**,前端复用同名字段会遇到类型不一致;现已统一。 + +## 1. 前端需要做的 + +- 详情页 / 试算结果里读 `totalPremium`、`premium` 时按**字符串**处理(与列表一致)。若之前对详情按 number 解析/做运算,请改成先 `Number(x)` 再算(或直接展示字符串)。 +- 其余字段、路径、结构**不变**。 + +## 验证(测试服实测,过网关 9443 + 真 admin token) + +- 列表 `/v3/admin/insurance/list`:`totalPremium`=`"10.80"`、`premium`=`"10.80"`(String)✅ +- 详情 `/v3/admin/insurance/orders/{id}`:`totalPremium`=`"10.80"`、`premium`=`"10.80"`(String)✅ 两端一致