changelog: 团期定金金额 + 研学收获容错

changelogs/2026-03/27_1100_batch_deposit_amount.md

@@ -0,0 +1,49 @@
+# 2026-03-27 团期定金金额 + 研学收获容错
+
+## 一、新增：团期/套餐返回定金金额（PR #7）
+
+小程序底部栏"订金 ¥3999/人"现在可以根据选择的团期动态显示。
+
+### 团期日历接口（已有）
+
+`GET /internal/product/{productId}/batches/calendar`
+
+每项新增 `depositAmount` 字段：
+
+```json
+{
+  "batchId": "123",
+  "departureDate": "2026-07-01",
+  "startingPrice": 12800,
+  "depositAmount": 3999
+}
+```
+
+### 套餐列表接口（已有）
+
+`GET /internal/product/batch/{batchId}/combos`
+
+每项新增 `depositAmount` 字段：
+
+```json
+{
+  "comboId": "456",
+  "comboName": "1大1小",
+  "sellPrice": 12800,
+  "depositAmount": 3999
+}
+```
+
+### 前端对接
+
+1. 用户未选团期时：用产品详情中 `pricing.depositAmount` 显示默认定金
+2. 用户选择团期后：从日历数据 `depositAmount` 更新底部栏
+3. 用户选择套餐后：从combo数据 `depositAmount` 精确显示
+
+## 二、修复：研学收获加载容错（PR #6）
+
+`loadStudyGains` 加了 try-catch，表不存在时不影响产品详情。
+
+## 部署说明
+
+重启：**hl-product-service**