docs(changelog): 今日代码审查批量修复 #3841(含保险保费字段转字符串前端需知)
这个提交包含在:
父节点
c11dac542b
当前提交
a6a11e2325
@ -0,0 +1,43 @@
|
||||
# 【后端内部·含1项前端需知】今日提交代码审查批量修复(PR #3841 / 无工单)
|
||||
|
||||
> 端:基本后端内部,**1 项前端需知**(保险订单列表保费字段类型变更)| 服务:hl-order-service-v3 + hl-fleet-service | PR #3841 已合并 dev-v3 + 双实例部署实测 | 2026-06-15
|
||||
|
||||
## ⚠️ 关键说明
|
||||
|
||||
对 2026-06-15 全部后端提交做了多维代码审查,修复发现的 6 类可改进项。**绝大多数是后端内部加固**(并发守卫/破零/红线合规/测试补齐/注释订正),**唯一影响前端的是保险订单列表的保费字段从 JSON 数字改为字符串**。
|
||||
|
||||
## 1. 🔴 前端需知:保险订单列表保费字段 数字 → 字符串
|
||||
|
||||
`GET /v3/admin/insurance/list` 返回的 `premium`(保费)和 `totalPremium`(保费,与 premium 同值)两个字段,**由 JSON 数字改为 JSON 字符串**,与平台「金额一律 String」约定对齐(防大额精度丢失)。
|
||||
|
||||
| 字段 | 修复前 | 修复后 |
|
||||
|------|--------|--------|
|
||||
| `premium` | `10.80`(数字) | `"10.80"`(字符串) |
|
||||
| `totalPremium` | `10.80`(数字) | `"10.80"`(字符串) |
|
||||
|
||||
```jsonc
|
||||
// 实测响应片段(测试服 9443)
|
||||
{"premium":"10.80","totalPremium":"10.80","policyHolderName":"内蒙古呼籁国际旅行社有限公司",
|
||||
"planName":"10万计划","statusLabel":"已承保", ...}
|
||||
```
|
||||
|
||||
**前端如对这两个字段做数值运算/严格类型比较,请按字符串处理**(`parseFloat` 或先转数值)。平台其他金额字段本就是字符串,此次是补齐一致性。其余字段不变。
|
||||
|
||||
## 2. 后端内部加固(前端无需关注)
|
||||
|
||||
| 模块 | 修复 |
|
||||
|------|------|
|
||||
| order-v3 改单 | 团期改单减人改走 decrementEnrolled(带 GREATEST 破零),与 +N/−N 写端口径统一 |
|
||||
| order-v3 团期对账 | selectForReconcile 去 `.last("LIMIT")` 红线,改 selectPage 合规分页 |
|
||||
| order-v3 房车打回 | 打回补 CAS 乐观锁守卫,防与并发 dispatch 丢失更新(TOCTOU);并正确释放 claimer |
|
||||
| fleet 司机 | 补 2 个回归测试锁定 #3818 修复行为 |
|
||||
| 注释订正 | 计数口径/短链码位数/错误码列表 三处 |
|
||||
|
||||
## 验证(测试服 2026-06-15)
|
||||
|
||||
```
|
||||
order-v3 双实例 8086/8186 全新重启(23:08),/v3/internal/order/batch-stats 返 200 ✅
|
||||
fleet 双实例 8087/8187 全新重启(23:09) ✅
|
||||
保险列表 premium/totalPremium 实测返字符串 "10.80" ✅
|
||||
order-v3 171 测试 + fleet DriverServiceTest 109 测试全绿,未触碰任何 Flyway 迁移
|
||||
```
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户