25 行
1.6 KiB
Markdown
25 行
1.6 KiB
Markdown
# 【字段类型对齐·管理后台】保险订单「详情」与「保费试算」金额字段改 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）✅ 两端一致
|