docs(changelog): 保险详情/试算金额改String序列化与列表对齐 (PR #3842)

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）✅ 两端一致