wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态
hl-api-changelog/changelogs/2026-03/2026-03-17_1244_87da085_feat.md

8.8 KiB
原始文件 Blame 文件历史

接口变更记录 — 2026-03-17 12:44

提交 87da085 · 作者 wx · 时间 2026-03-17 12:44:59 +0800

feat: 产品统一保存接口 + 资源价格日历字段增强 + Knife4j分组名修复

变更总览

  • 产品服务
    • Product (+1)

产品服务

Product

🆕 POST /admin/product/item/save — 保存产品（统一创建/更新）

请求体 ProductSaveRequest

字段 类型 说明
productId Long 产品ID（传入则更新，不传则创建）
name String 产品名称
subtitle String 副标题
productType String 产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团（创建时必填，更新时忽略）
tripDays Integer 行程天数
departureCity String 出发城市
destinationCity String 目的地城市
seasons List<String> 适用季节列表，如 [\
tags List<String> 产品标签列表，如 [\
isBooking Boolean 是否预约产品
adultCount Integer 成人人数
childCount Integer 儿童人数
youngChildCount Integer 小童人数
babyCount Integer 婴儿人数
minAdultPerOrder Integer 每单最少成人数(不填默认1)
maxAdultPerOrder Integer 每单最大成人数(不填则不限制)
maxChildPerOrder Integer 每单最大儿童数(不填则不限制)
coverImageUrl String 封面图URL
carouselImages List<String> 轮播图列表
carouselVideoUrl String 轮播视频URL
folderId String 所属文件夹ID
lineId String 产品线ID
creatorAvatarUrl String 定制师头像URL
creatorIntro String 创作者寄语
groupChatQrUrl String 群聊二维码URL
chatMessages List<ChatMessageVO> 群聊消息列表
showReview Boolean 是否显示评价
showChatGroup Boolean 是否显示群聊入口
showTripTime Boolean 是否显示行程时间
showTripDistance Boolean 是否显示行程距离
bookingNotice String 预定须知
cancelPolicy String 退改政策
warmTips String 温馨提示
customizerId String 定制师ID
sortOrder Integer 排序序号
teamExperienceYears Integer 团队经验年数
lineSubtitle String 产品线副标题
mchId String 商户号：shanhe/wenlu
groupRoomId String 企微群聊ID(用于会话存档展示群消息)

响应 Result<ProductVO>

📦 其他数据对象变更

以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应

保险服务

✏️ PolicyShareVO

  • ✏️ pdfBase64: 说明 "merged PDF as base64" → "合并后的PDF（Base64编码）"
  • ✏️ personName: 说明 "insured person name" → "被保人姓名"
  • ✏️ policyCount: 说明 "number of policies included" → "包含的保单数量"
  • ✏️ failedCount: 说明 "number of policies that failed to download (skipped)" → "下载失败的保单数量（已跳过）"

✏️ SharePolicyRequest

  • ✏️ orderId: 说明 "travel order ID" → "旅游订单ID"
  • ✏️ insuredName: 说明 "insured person name" → "被保人姓名"
  • ✏️ insuredIdCardNo: 说明 "insured person ID card number" → "被保人证件号码"

资源服务

✏️ PriceCalendarDayVO

  • ✏️ status: 类型 Integer → String, 说明 "状态：0=不可租 1=可租" → "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）"

✏️ PriceCalendarSetRequest

  • ✏️ status: 类型 Integer → String, 说明 "状态：0=不可租 1=可租" → "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）"

✏️ PriceCalendarStatusRequest

  • ✏️ status: 类型 Integer → String, 说明 "状态：0=不可租 1=可租" → "目标状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）"

📋 实体变更

✏️ ActivityPriceCalendar

  • ✏️ status: 类型 Integer → String

✏️ CostPriceCalendar

  • ✏️ status: 类型 Integer → String

✏️ RoomPriceCalendar

  • ✏️ status: 类型 Integer → String

✏️ ScenicPriceCalendar

  • ✏️ status: 类型 Integer → String

✏️ ServicePriceCalendar

  • ✏️ status: 类型 Integer → String

✏️ StaffPriceCalendar

  • ✏️ status: 类型 Integer → String

✏️ VehiclePriceCalendar

  • ✏️ status: 类型 Integer → String
📁 全部变更文件 (点击展开) 
M	hl-insurance-service/src/main/java/com/hulalv/insurance/config/Knife4jConfig.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/dto/SharePolicyRequest.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/service/BaoyouApiClient.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/service/InsuranceProductSyncService.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/vo/PolicyShareVO.java
M	hl-product-service/src/main/java/com/hulalv/product/config/Knife4jConfig.java
M	hl-product-service/src/main/java/com/hulalv/product/controller/ProductController.java
A	hl-product-service/src/main/java/com/hulalv/product/dto/ProductSaveRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/service/ProductService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/activity/constant/ActivityConstants.java
M	hl-resource-service/src/main/java/com/hulalv/resource/activity/dto/PriceCalendarSetRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/activity/dto/PriceCalendarStatusRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/activity/entity/ActivityPriceCalendar.java
M	hl-resource-service/src/main/java/com/hulalv/resource/activity/vo/PriceCalendarDayVO.java
M	hl-resource-service/src/main/java/com/hulalv/resource/cost/constant/CostConstants.java
M	hl-resource-service/src/main/java/com/hulalv/resource/cost/entity/CostPriceCalendar.java
M	hl-resource-service/src/main/java/com/hulalv/resource/cost/vo/PriceCalendarDayVO.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/constant/HotelConstants.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/dto/PriceCalendarSetRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/dto/PriceCalendarStatusRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/entity/RoomPriceCalendar.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/vo/PriceCalendarDayVO.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/constant/ScenicConstants.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/dto/PriceCalendarSetRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/dto/PriceCalendarStatusRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/entity/ScenicPriceCalendar.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/service/ScenicPriceCalendarService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/vo/PriceCalendarDayVO.java
M	hl-resource-service/src/main/java/com/hulalv/resource/service/constant/ServiceConstants.java
M	hl-resource-service/src/main/java/com/hulalv/resource/service/dto/PriceCalendarSetRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/service/dto/PriceCalendarStatusRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/service/entity/ServicePriceCalendar.java
M	hl-resource-service/src/main/java/com/hulalv/resource/service/vo/PriceCalendarDayVO.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/constant/StaffConstants.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/dto/PriceCalendarSetRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/dto/PriceCalendarStatusRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/entity/StaffPriceCalendar.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/vo/PriceCalendarDayVO.java
M	hl-resource-service/src/main/java/com/hulalv/resource/vehicle/constant/VehicleConstants.java
M	hl-resource-service/src/main/java/com/hulalv/resource/vehicle/dto/PriceCalendarSetRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/vehicle/dto/PriceCalendarStatusRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/vehicle/entity/VehiclePriceCalendar.java
M	hl-resource-service/src/main/java/com/hulalv/resource/vehicle/vo/PriceCalendarDayVO.java
A	scripts/api-changelog-sync.py
A	scripts/sync-api-docs.py