hl-api-changelog/changelogs/2026-04/2026-04-13_product-v2_full_update.md

产品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计算。

返回示例:

{
  "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