feat: 产品v2 4月13日完整更新汇总 - 新增接口+bug修复+模块搬迁

changelogs/2026-04/2026-04-13_product-v2_full_update.md

@@ -0,0 +1,138 @@
+# 产品v2 - 4月13日完整更新汇总
+
+**日期**: 2026-04-13
+**服务**: product-service-v2
+**类型**: 新增接口 + bug修复 + 模块搬迁
+**PR**: #431, #433, #442, #446-#452
+
+---
+
+## 一、新增接口
+
+### 1. 计算行程总里程
+`GET /admin/product/item/{productId}/calculate-mileage`
+
+根据行程途经点坐标调用高德驾车路线规划API自动计算总驾驶里程。
+
+**返回**: `BigDecimal` 总里程(km)，1位小数
+
+---
+
+### 2. 计算建议售价
+`GET /admin/product/item/{productId}/suggest-price`
+
+根据备品成本+额外成本计算建议售价。有激活的公式组时走FormulaEngine计算。
+
+**返回示例**:
+```json
+{
+  "adultSuggestPrice": 220.0,
+  "childSuggestPrice": 70.0,
+  "formulaApplied": false,
+  "adultCost": {
+    "suppliesCost": 70.0,
+    "extraCost": 150.0,
+    "totalCost": 220.0,
+    "suppliesItems": [
+      {"name": "防晒霜SPF50+", "unitPrice": 30.0, "quantity": 1, "subtotal": 30.0}
+    ],
+    "extraItems": [
+      {"name": "骑马延时", "unitPrice": 150.0, "quantity": 1, "subtotal": 150.0}
+    ]
+  },
+  "childCost": { ... }
+}
+```
+
+---
+
+### 3. 报价公式管理（从v1搬迁）
+`/admin/product/formula/**`
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/formula/group/list` | GET | 公式组列表 |
+| `/formula/group/{groupId}` | GET | 公式组详情 |
+| `/formula/group` | POST | 创建公式组 |
+| `/formula/group/{groupId}` | PUT | 更新公式组 |
+| `/formula/group/{groupId}/activate` | PUT | 激活公式组 |
+| `/formula/group/{groupId}` | DELETE | 删除公式组 |
+| `/formula/group/{groupId}/steps` | GET | 步骤列表 |
+| `/formula/step/{formulaId}` | GET | 步骤详情 |
+| `/formula/step` | POST | 创建步骤 |
+| `/formula/step/{formulaId}` | PUT | 更新步骤 |
+| `/formula/step/{formulaId}/toggle` | PUT | 启用/禁用 |
+| `/formula/step/{formulaId}` | DELETE | 删除步骤 |
+| `/formula/step/{formulaId}/versions` | GET | 版本历史 |
+| `/formula/step/{formulaId}/rollback/{versionNum}` | PUT | 回滚版本 |
+| `/formula/test` | POST | 测试执行 |
+| `/formula/var/list` | GET | 变量列表 |
+| `/formula/var` | POST | 创建变量 |
+| `/formula/var/{varId}` | PUT | 更新变量 |
+| `/formula/var/{varId}` | DELETE | 删除变量 |
+
+---
+
+### 4. 温馨提示管理（从v1搬迁）
+`/admin/product/warm-tips/**`
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/warm-tips/list` | GET | 全部列表 |
+| `/warm-tips/enabled` | GET | 启用列表（下拉用） |
+| `/warm-tips/{tipsId}` | GET | 详情 |
+| `/warm-tips` | POST | 创建 |
+| `/warm-tips/{tipsId}` | PUT | 修改 |
+| `/warm-tips/{tipsId}` | DELETE | 删除 |
+| `/warm-tips/{tipsId}/toggle?enabled=true/false` | PUT | 启用/禁用 |
+
+---
+
+### 5. 预订条款管理（从v1搬迁）
+`/admin/product/booking-terms/**`
+
+接口结构同温馨提示，字段名 `tipsId` → `termsId`，`tipsName` → `termsName`
+
+---
+
+## 二、Bug修复
+
+### 1. 产品详情 routeInfo 返回 null（已修）
+Step3保存的总里程/线路描述能存入DB但详情接口返回null。原因：SQL返回扁平字段，VO期望嵌套对象。
+
+### 2. 详情返回JSON字段格式（已修）
+- `photoUrls`: 之前返回 `"[\"url\"]"`（字符串），现在返回 `["url"]`（数组）
+- `customFields`: 同上，字符串→对象
+- `images`（节点）: 同上
+- `extraData`（节点）: 同上
+
+### 3. 详情返回审计字段（已修）
+行程天/节点/住宿/路线点不再返回 `createTime`/`updateTime`/`createdBy`/`updatedBy`/`deletedAt`
+
+### 4. 行程保存事务失效（已修）
+调用行程保存接口报500。原因：自调用@Transactional不生效。
+
+---
+
+## 三、全接口验证结果
+
+| 接口 | 状态 |
+|------|------|
+| 产品线列表/下拉 | ✅ 200 |
+| 产品分页列表 | ✅ 200 (7条) |
+| 产品详情(4个产品) | ✅ 200, photoUrls=list, coverImg=Y, 审计字段=clean |
+| Step1 基础信息保存 | ✅ 200 |
+| Step2 行程保存 | ✅ 200 |
+| Step3 路线与备品保存 | ✅ 200 |
+| Step4 价格日历批量设置 | ✅ 200 |
+| Step4 班期创建/修改/删除 | ✅ 200 |
+| Step5 补充信息保存 | ✅ 200 |
+| 里程计算 | ✅ 200 |
+| 建议售价 | ✅ 200 |
+| 报价计算 | ✅ 200 |
+| 上架预检(4个) | ✅ 全部PASS |
+| 费用推导预览 | ✅ 200 |
+| 操作记录 | ✅ 200 |
+| 温馨提示CRUD | ✅ 200 |
+| 预订条款CRUD | ✅ 200 |
+| 报价公式组/步骤/变量 | ✅ 200 |