docs(changelog): 保险产品VO金额字段补转字符串 + 房车打回懒清理文档化 #3848

changelogs-v2/2026-06/16_3848_保险产品VO金额字段补转字符串-前端需知-后端.md

@@ -0,0 +1,30 @@
+# 【后端·含前端需知】保险产品/计划/保障 VO 金额字段补转字符串（PR #3848 / 无工单）
+
+> 端：含前端需知（保险产品配置相关接口金额字段类型）| 服务：hl-order-service-v3 | PR #3848 已合并 dev-v3 + 部署实测 | 2026-06-16
+
+## ⚠️ 关键说明
+
+承接 #3841（保险订单列表/详情 VO 的 premium/totalPremium 转字符串），本次**补齐保险 VO 包剩余 5 个金额字段**的字符串序列化，全包口径一致（与平台「金额一律 String」约定对齐，防大额精度丢失）。
+
+## 前端需知：以下金额字段 数字 → 字符串
+
+| VO / 端点 | 字段 | 含义 |
+|-----------|------|------|
+| InsuranceProductVO（`/v3/admin/insurance/products/{id}` 等） | `minPremium` / `maxPremium` | 最低/最高保费 |
+| InsuranceProductVO.PlanItem（`/products/{id}/plans`） | `basePremium` | 基础保费(元/人/天) |
+| InsuranceProductVO.RateItem | `premium` | 单人保费 |
+| InsuranceCoverageVO | `coverageAmount` | 保额 |
+
+前端如对这些字段做数值运算/严格类型比较，请按字符串处理。其余字段不变。
+
+## 另：房车打回「懒清理」决策文档化（无行为改动，前端无关）
+
+车务房务供应侧打回（rejectRequirement）的「不清理实配/不回置控单态、由重新提交时再同步」决策已在代码 javadoc 显式写明 + 核实安全（打回时无实配可清，控单态重提时统一重置）。纯文档，无接口/行为变化。
+
+## 验证（测试服 2026-06-16）
+
+```
+order-v3 双实例 8086/8186 全新重启(09:01)，业务端点 200 ✅
+order-v3 113 测试全绿（InsuranceQueryServiceTest + RequirementServiceTest），未触碰 Flyway 迁移
+序列化机制 #3841 已实测证实(premium→"10.80")，本次同一注解，行为一致
+```