From 3e4549efee6b442b61dd28e3723567f0d0c1a4ae Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 27 Apr 2026 19:26:00 +0800 Subject: [PATCH] =?UTF-8?q?docs:=2027=20=E6=97=A5=E6=96=B0=E5=A2=9E?= =?UTF-8?q?=E4=B8=A4=E6=9D=A1=E4=BF=AE=E5=A4=8D=20changelog?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - fix(admin/product): 固定订金模式产品售价必须 > 订金(双向校验) (#1497) - fix(mp/admin/order): 班期内部报价补 toddler/infant 字段, GROUP 订单 totalPrice 含小童金额 (#1498) Co-Authored-By: Claude Opus 4.7 (1M context) --- ...min-product_deposit-vs-price-validation.md | 65 ++++++++++++++ ...ernal-batch-quote_toddler-infant-fields.md | 87 +++++++++++++++++++ 2 files changed, 152 insertions(+) create mode 100644 changelogs/2026-04/27_fix_admin-product_deposit-vs-price-validation.md create mode 100644 changelogs/2026-04/27_fix_internal-batch-quote_toddler-infant-fields.md diff --git a/changelogs/2026-04/27_fix_admin-product_deposit-vs-price-validation.md b/changelogs/2026-04/27_fix_admin-product_deposit-vs-price-validation.md new file mode 100644 index 0000000..6996f8e --- /dev/null +++ b/changelogs/2026-04/27_fix_admin-product_deposit-vs-price-validation.md @@ -0,0 +1,65 @@ +# 修复:固定订金模式产品售价必须大于订金(双向校验) + +**类型**: 后端 BUG 修复 + 校验加严 +**关联**: 工单 #1497 / PR #1501 +**日期**: 2026-04-27 +**影响范围**: 管理端产品基础信息保存 + 价格日历批量设置 + 班期保存 + +--- + +## 现象 + +后台「支付类型=订金+尾款」+「订金设置=固定金额(元/人)」组合下,保存价格时未校验售价 > 订金。极端 case: 用户设定金 5000 元/人但成人价配 1000,定金比总价还高,业务彻底崩。 + +## 后端改动 + +### 1. 正向校验(保存价格时) + +**接口 1: 价格日历批量设置 `POST /admin/product/item/{id}/price-calendar/batch`** (CORE/CUSTOM) + +- 触发条件: 产品 paymentType=DEPOSIT 且 depositAmount > 0 +- 校验: adultSellPrice > depositAmount **AND** childSellPrice > depositAmount +- 不通过会返: + - `code=410105`: 成人售价（{0}元）必须大于产品订金（{1}元/人），请调整定价或修改基础信息中的订金 + - `code=410106`: 儿童售价（{0}元）必须大于产品订金（{1}元/人），请调整定价或修改基础信息中的订金 + +**接口 2: 班期保存 `POST /admin/product/item/{id}/schedule`** (GROUP) 与 **班期批量创建** + +- 同样规则套用 adultPrice / childPrice +- 错误码同上 + +### 2. 反向校验(保存基础信息时) + +**接口: Step1 基础信息保存 `POST /admin/product/item/basic`** + +- 触发条件: 用户调高 depositAmount(固定金额模式) +- 校验: 反查产品现有 product_price_calendar + group_tour_batch,任一售价 ≤ 新订金即抛错 +- 不通过会返: + - `code=410107`: 订金（{0}元/人）不能高于现有价格（{1} {2}的售价{3}元），请先调整定价 + - 占位符 {1} 是日期(如 `2026-05-17`)或班期号(如 `班期Q26050101`),{2} 是「成人」或「儿童」 + +### 3. 跳过项(不校验) + +- **比例订金模式** (`depositRatio` 有值, `depositAmount` 为空): 不校验,比例 < 100% 数学上必然 < 总价 +- **全款模式** (`paymentType=FULL`): 不校验 +- **幼童价 / 小童优惠**: 不校验,幼童价 0 是合法免费语义 + +## 前端建议 + +1. **不需要改逻辑**,后端已加硬校验 +2. UI 体验优化(可选): 在「订金设置」输入框旁加提示"订金须低于最低成人/儿童售价" +3. 接到 `code=410105/410106` 时建议提示用户「请调整价格或回基础信息修改订金」 +4. 接到 `code=410107` 时建议解析消息中的日期/班期号高亮冲突项 + +## 测试建议 + +- [x] 管理端 CORE 产品基础信息设固定订金 100,价格日历配成人价 50 → 应报错 `410105` +- [x] 同上配成人价 200 → 应通过 +- [x] 管理端 GROUP 产品班期保存 adultPrice=50,固定订金 100 → 应报错 `410105` +- [x] 已配价格日历(成人价 100),回基础信息把订金调到 200 → 应报错 `410107` 含冲突日期 +- [x] 比例订金 30% 配成人价 50 → 应通过(不受影响) +- [x] 全款模式 → 应通过(不受影响) + +## 后端单测 + +ProductPricingServiceTest 新增 8 用例 + ProductBasicServiceTest 新增 5 用例,全量 1000 用例通过。 diff --git a/changelogs/2026-04/27_fix_internal-batch-quote_toddler-infant-fields.md b/changelogs/2026-04/27_fix_internal-batch-quote_toddler-infant-fields.md new file mode 100644 index 0000000..9ef2c55 --- /dev/null +++ b/changelogs/2026-04/27_fix_internal-batch-quote_toddler-infant-fields.md @@ -0,0 +1,87 @@ +# 修复:班期内部报价补 toddler/infant 字段(订单总价含小童金额) + +**类型**: 后端 BUG 修复 +**关联**: 工单 #1498 / PR #1499 +**日期**: 2026-04-27 +**影响范围**: 小程序 GROUP(小蒙马) 订单创建后的订单详情展示 + 总价 + +--- + +## 现象 + +后端同事反馈: order-v2 调 product-v2 的班期报价接口时返回里没有小童单价/数量/小计,GROUP 订单(小蒙马)创建带小童时算价漏掉小童总价。同时入参也缺 toddlerCount,订单方根本传不过去。 + +## 修复后的行为 + +### 1. GROUP 订单总价 (`totalPrice`) + +**接口**: `POST /mp/order/create` (GROUP 类型) + +- 修复前: 带 `youngChildCount=1` 创建 GROUP 订单,totalPrice 只算成人 + 儿童,小童金额漏掉 +- 修复后: totalPrice 正确包含小童金额(由班期 toddlerDiscount 决定) + +### 2. 订单详情价格明细 (`priceBreakdown.items`) + +**接口**: `GET /mp/order/detail/{id}` 与 `GET /admin/order/detail/{id}` + +- 修复前: items 里小童单价/小计硬写 0 元(展示成"小童 0元×N=0元") +- 修复后: 小童行展示真实单价(=班期成人价×儿童折扣) 和 真实小计 + +### 3. 小童单价计算口径 + +`toddlerPrice = max(childPrice + toddlerDiscount, 0)` + +与 `ProductPricingService.calculateQuote` 同口径。toddlerDiscount 默认负数(优惠),null 时小童价=儿童价。 + +## 前端建议 + +**不需要改任何代码**。本次是后端纯修复,前端只需要观察: +1. 创建带 youngChildCount 的 GROUP 订单后,`totalPrice` 应正确 = 成人+儿童+小童(含 toddlerDiscount) +2. 订单详情里"小童"行不再永远显示 0,有班期 toddlerDiscount 时显示实际折扣价 + +## 跨服务接口变更说明 (内部, 前端无感知) + +### Feign Client 入参签名 (新增 2 个,默认 0) + +``` +GET /internal/product/batch/{batchId}/quote + ?adultCount=2 &childCount=1 &toddlerCount=0 &infantCount=0 &roomCount=1 + ↑ 新增 ↑ 新增 +``` + +### 返回 VO 新增字段 + +```json +{ + "adultPrice": 5999, "childPrice": 4299, + "toddlerPrice": 3299, // 新增 + "infantPrice": 0, // 新增 + "adultCount": 2, "childCount": 1, + "toddlerCount": 1, // 新增 + "infantCount": 0, // 新增 + "roomCount": 1, + "adultTotal": 11998, "childTotal": 4299, + "toddlerTotal": 3299, // 新增 + "infantTotal": 0, // 新增 + "grandTotal": 19596 +} +``` + +### 向后兼容 + +- 入参新字段都有默认 0,旧调用方不传不影响 +- 返回新字段对旧消费者透明(Jackson 忽略未知字段) + +## 测试建议 + +- [ ] 小程序选有 toddlerDiscount 的班期(例如 batch_id=2042826084914950145 有 toddlerDiscount=-1000),youngChildCount=1 下单 + - 期望: `totalPrice` 包含小童金额 (childPrice + toddlerDiscount)×1 + - 期望: 订单详情价格明细里小童行不为 0 +- [ ] 不带小童(youngChildCount=0)下单 → 行为与改动前一致 + +## 后端测试 + +- 单测: GroupTourBatchServiceMpTest 新增 4 用例(toddlerDiscount=null/截断为0/向后兼容/正常)+ GroupOrderStrategyTest 8 用例适配新签名,全过 +- 本地 API: product-v2 9083 直接 curl 经 X-Internal-Token 验证两路径 + - 完整传: toddlerPrice=3299 (=4299-1000) grandTotal=19596 ✓ + - 向后兼容: toddler/infant=0 grandTotal=16297 与改动前一致 ✓