From 934f62f6dacbb602fb412e098db795cc096bf846 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 16 Jun 2026 00:19:47 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E4=BF=9D=E9=99=A9=E8=AF=A6?= =?UTF-8?q?=E6=83=85/=E8=AF=95=E7=AE=97=E9=87=91=E9=A2=9D=E6=94=B9String?= =?UTF-8?q?=E5=BA=8F=E5=88=97=E5=8C=96=E4=B8=8E=E5=88=97=E8=A1=A8=E5=AF=B9?= =?UTF-8?q?=E9=BD=90=20(PR=20#3842)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...与试算金额改String序列化-与列表对齐-管理后台.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 changelogs-v2/2026-06/15_保险订单详情与试算金额改String序列化-与列表对齐-管理后台.md 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）✅ 两端一致