hl-api-changelog/2026-03/17_1012/hl-product-service.md

产品服务 API 文档

服务: hl-product-service 接口总数: 106

目录

• 产品文件夹管理 (4 个接口)
• 产品管理 (10 个接口)
• 产品线管理 (6 个接口)
• 定价与费用管理 (20 个接口)
• 定价公式管理 (19 个接口)
• 家庭分组管理 (4 个接口)
• 小程序-产品 (3 个接口)
• 报价计算 (2 个接口)
• 拼团批次管理 (12 个接口)
• 行政区划搜索 (1 个接口)
• 行程管理 (25 个接口)

---

产品文件夹管理

POST /admin/product/folder

创建文件夹

创建产品文件夹，用于组织管理产品。支持多级目录结构。 文件夹归属于创建人，普通管理员只能看到自己的文件夹。

请求体 创建文件夹请求

字段	类型	必填	说明
name	string	是	文件夹名称
parentId	string		父文件夹ID，为空则为根文件夹
sortOrder	int		排序序号

响应 统一响应结果«产品文件夹VO»

字段	类型	必填	说明
code	int		状态码
data	产品文件夹VO		响应数据
children	产品文件夹VO[]		子文件夹列表
children	产品文件夹VO[]		子文件夹列表
createTime	string		创建时间
folderId	string		文件夹ID
name	string		文件夹名称
ownerId	string		拥有者ID
ownerName	string		拥有者姓名
parentId	string		父文件夹ID
productCount	int		文件夹内产品数量
sortOrder	int		排序序号
updateTime	string		更新时间
createTime	string		创建时间
folderId	string		文件夹ID
name	string		文件夹名称
ownerId	string		拥有者ID
ownerName	string		拥有者姓名
parentId	string		父文件夹ID
productCount	int		文件夹内产品数量
sortOrder	int		排序序号
updateTime	string		更新时间
message	string		响应消息

---

GET /admin/product/folder/tree

获取文件夹树

获取当前用户可见的文件夹树形结构。 普通管理员只能看到自己创建的文件夹，SUPER_ADMIN 可看到所有文件夹。 返回结构为嵌套的树形列表，包含每个文件夹的子文件夹。

响应 统一响应结果«List«产品文件夹VO»»

字段	类型	必填	说明
code	int		状态码
data	产品文件夹VO[]		响应数据
children	产品文件夹VO[]		子文件夹列表
children	产品文件夹VO[]		子文件夹列表
createTime	string		创建时间
folderId	string		文件夹ID
name	string		文件夹名称
ownerId	string		拥有者ID
ownerName	string		拥有者姓名
parentId	string		父文件夹ID
productCount	int		文件夹内产品数量
sortOrder	int		排序序号
updateTime	string		更新时间
createTime	string		创建时间
folderId	string		文件夹ID
name	string		文件夹名称
ownerId	string		拥有者ID
ownerName	string		拥有者姓名
parentId	string		父文件夹ID
productCount	int		文件夹内产品数量
sortOrder	int		排序序号
updateTime	string		更新时间
message	string		响应消息

---

PUT /admin/product/folder/{folderId}

更新文件夹

更新文件夹名称等信息。 权限说明：普通管理员只能更新自己创建的文件夹，SUPER_ADMIN 可更新任何文件夹。

路径参数

参数	类型	必填	说明
folderId	integer		文件夹ID

请求体 更新文件夹请求

字段	类型	必填	说明
name	string		文件夹名称
sortOrder	int		排序序号

响应 统一响应结果«产品文件夹VO»

字段	类型	必填	说明
code	int		状态码
data	产品文件夹VO		响应数据
children	产品文件夹VO[]		子文件夹列表
children	产品文件夹VO[]		子文件夹列表
createTime	string		创建时间
folderId	string		文件夹ID
name	string		文件夹名称
ownerId	string		拥有者ID
ownerName	string		拥有者姓名
parentId	string		父文件夹ID
productCount	int		文件夹内产品数量
sortOrder	int		排序序号
updateTime	string		更新时间
createTime	string		创建时间
folderId	string		文件夹ID
name	string		文件夹名称
ownerId	string		拥有者ID
ownerName	string		拥有者姓名
parentId	string		父文件夹ID
productCount	int		文件夹内产品数量
sortOrder	int		排序序号
updateTime	string		更新时间
message	string		响应消息

---

DELETE /admin/product/folder/{folderId}

删除文件夹

删除文件夹。如果文件夹下有产品，产品会自动移到根目录（folderId 置空）。 普通管理员只能删除自己的文件夹，SUPER_ADMIN 可删除任何文件夹。

路径参数

参数	类型	必填	说明
folderId	integer		文件夹ID

响应 统一响应结果«Void»

---

产品管理

POST /admin/product/item

创建产品（草稿）

创建一个新产品，初始状态为 DRAFT（草稿）。

产品类型说明：

• CORE：核心产品，标准旅游产品，支持上架/下架审批流程
• GROUP：小蒙马拼团，需配合团期批次管理，按人头计价
• CUSTOM：定制产品，由定制师为客户量身定制，按单计价
• ROUTE：线路产品，预设线路模板，按单计价

注意事项：

• 创建后需依次完善行程、定价、价格日历等信息
• CUSTOM/ROUTE 产品的价格日历存储的是整单总价，不按人头乘算
• GROUP 产品需额外创建团期批次才能报名

关联字典：

• product_type（产品类型）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马
• product_category（产品分类）：family=亲子游, honeymoon=蜜月游, photography=旅拍, experience=体验, driving=自驾
  • 完整字典值: family=亲子游, honeymoon=蜜月旅行, photography=摄影之旅, experience=深度体验, driving=自驾越野

请求体 创建产品请求

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

响应 统一响应结果«产品详情VO»

字段	类型	必填	说明
code	int		状态码
data	产品详情VO		响应数据
adultCount	int		成人人数
babyCount	int		婴儿人数
benefitsDescription	权益分组[]		权益说明（静态，所有产品相同）
items	权益项[]		权益项列表
title	string		分组标题，如：儿童权益 (1.2m以下)
bookingNotice	string		预定须知
cancelPolicy	string		退改政策
carouselImages	string[]		轮播图列表
carouselVideoUrl	string		轮播视频URL
chatMessages	群聊消息VO[]		群聊消息列表
avatar	string		用户头像URL（type=user时有效）
text	string		消息内容
type	string		消息类型: user/creator
childCount	int		儿童人数
costItems	产品成本项VO[]		成本项列表
category	string		成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
id	string		成本项ID
sortOrder	int		排序序号
title	string		成本项标题
type	string		成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
creatorAvatarUrl	string		定制师头像URL
creatorIntro	string		创作者寄语
customFees	产品自定义费用项VO[]		自定义费用项列表
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string		费用项名称
feeUnit	string		费用单位
id	string		费用项ID
sortOrder	int		排序序号
customizerId	string		定制师ID
departureCity	string		出发城市
destinationCities	string[]		途经城市列表（从行程节点资源去重提取）
destinationCity	string		目的地城市
families	家庭分组VO[]		家庭分组列表（定制产品）
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyId	string		家庭ID
familyName	string		家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数
folderId	string		所属文件夹ID
groupChatQrUrl	string		群聊二维码URL
groupRoomId	string		企微群聊ID(用于会话存档展示群消息)
isBooking	boolean		是否预约产品
itineraryDays	行程天VO[]		行程天列表
dayId	string		行程天ID
dayNumber	int		天数编号
dayTitle	string		天标题
hotels	每日酒店VO[]		当日酒店列表
nodes	行程节点VO[]		行程节点列表
restaurants	用餐选项VO[]		当日用餐列表
routeSummary	string		路线概览
lineId	string		产品线ID
lineName	string		产品线名称
lineSubtitle	string		产品线副标题
maxAdultPerOrder	int		每单最大成人数(null=不限)
maxChildPerOrder	int		每单最大儿童数(null=不限)
mchId	string		商户号
minAdultPerOrder	int		每单最少成人数(null=默认1)
name	string		产品名称
paymentMode	string		支付模式：FULL=全款 DEPOSIT=定金+尾款
pricing	产品定价配置VO		定价配置
adultExtraBed	number		成人加床费
babyPrice	number		婴儿价
balanceDueDays	int		尾款支付截止天数（出发前N天）
childDiscountPercent	number		儿童折扣百分比
childNoBed	number		儿童不占床价
childWithBed	number		儿童占床价
companionPrice	number		陪同人员价格
customTotalPrice	number		定制产品总价（CUSTOM模式下使用）
depositAmount	number		定金金额
depositRatio	int		定金比例（百分比）
extraCostPerPerson	number		每人额外成本
insuranceFee	number		保险费用
markupPercent	number		加价百分比（PERCENT模式下使用）
maxGroupSize	int		最大成团人数
mealBudget	number		餐费预算
minGroupSize	int		最小成团人数
paymentType	string		支付方式：FULL=全款 DEPOSIT=定金+尾款
pricingId	string		定价配置ID
pricingMode	string		定价模式：AUTO=自动计算 MANUAL=手动定价 CUSTOM=定制定价
productId	string		产品ID
profitAmount	number		利润金额（FIXED模式下使用）
profitMode	string		利润模式：FIXED=固定金额 PERCENT=百分比
singleRoomDiff	number		单房差
vehicleModelIds	string[]		车型ID列表
vehicleWarning	string		车辆绑定警告信息（为空表示绑定成功）
productId	string		产品ID
productNo	string		产品编号
productType	string		产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团
publishedAt	string		发布时间
routeMapUrl	string		路径图URL（后端自动生成）
seasons	string[]		适用季节列表
showChatGroup	boolean		是否显示群聊入口
showReview	boolean		是否显示评价
showTripDistance	boolean		是否显示行程距离
showTripTime	boolean		是否显示行程时间
sortOrder	int		排序序号
staffConfigs	产品人员配置VO[]		人员配置列表（定制产品）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
staffType	string		人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
staffTypeName	string		人员类型名称
startPrice	number		起步价：未来一年价格日历中最低成人售价
status	string		产品状态：DRAFT/PENDING_REVIEW/REVIEWED/REJECTED/PUBLISHED/UNPUBLISHED/COMPLETED
subtitle	string		副标题
suppliesList	产品物资VO[]		物资列表
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string		物资ID
suppliesName	string		物资名称
tags	string[]		产品标签列表
teamExperienceYears	int		团队经验年数
tripDays	int		行程天数
tripNights	int		行程晚数
updateBy	string		更新人ID
updateTime	string		更新时间
warmTips	string		温馨提示
youngChildCount	int		小童人数
message	string		响应消息

---

GET /admin/product/item/list

产品列表

分页查询产品列表，支持多维度筛选和排序。

权限说明：

• 普通管理员只能看到自己创建的产品
• SUPER_ADMIN 可看到所有产品

筛选条件：关键词（名称/副标题模糊匹配）、产品类型、状态、文件夹、产品线、季节、行程天数。 支持多状态筛选（statuses 字段，逗号分隔）。

关联字典：

• product_type（产品类型，筛选条件）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马
• product_status（产品状态，筛选条件+返回字段）：DRAFT=草稿, PENDING_REVIEW=待审核, REVIEWED=已审核, REJECTED=已驳回, PUBLISHED=已上架, UNPUBLISHED=已下架, COMPLETED=已完成, ORDERED=已下单
  • 完整字典值: DRAFT=草稿, PENDING_REVIEW=待审核, REVIEWED=已审核, REJECTED=已驳回, PUBLISHED=已上架, UNPUBLISHED=已下架, COMPLETED=已完成

查询参数

参数	类型	必填	说明	示例
folderId	string		文件夹ID	1893012345678901234
keyword	string		搜索关键词	丽江
lineId	string		产品线ID	1893012345678901234
page	integer(int32)		页码	1
pageSize	integer(int32)		每页条数	20
productType	string		产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团	CORE
season	string		季节筛选	spring
sortBy	string		排序字段：name/tripDays/createTime/updateTime	createTime
sortDir	string		排序方向：asc/desc	desc
status	string		产品状态：DRAFT/PENDING_REVIEW/REVIEWED/REJECTED/PUBLISHED/UNPUBLISHED/COMPLETED	PUBLISHED
statuses	string		多状态筛选（逗号分隔）	PUBLISHED,COMPLETED
tripDays	integer(int32)		行程天数	5

响应 统一响应结果«分页结果«产品列表VO»»

字段	类型	必填	说明
code	int		状态码
data	分页结果«产品列表VO»		响应数据
page	int		当前页码
pageSize	int		每页条数
records	产品列表VO[]		数据列表
adultCount	int		成人数（私人定制/路书）
approvalNo	string		审批编号
babyCount	int		幼童数（私人定制/路书）
childCount	int		儿童数（私人定制/路书）
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
departureCity	string		出发城市
destinationCity	string		目的地城市
folderId	string		所属文件夹ID
groupRoomId	string		企微群聊ID(用于会话存档展示群消息)
isBooking	boolean		是否预约产品
lineId	string		产品线ID
lineName	string		产品线名称
maxAdultPerOrder	int		每单最大成人数(null=不限)
maxChildPerOrder	int		每单最大儿童数(null=不限)
mchId	string		商户号
minAdultPerOrder	int		每单最少成人数(null=默认1)
name	string		产品名称
pendingStatus	string		待审批目标状态
productId	string		产品ID
productNo	string		产品编号
productType	string		产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团
seasons	string[]		适用季节列表
sortOrder	int		排序序号
status	string		产品状态：DRAFT/PENDING_REVIEW/REVIEWED/REJECTED/PUBLISHED/UNPUBLISHED/COMPLETED
subtitle	string		副标题
tripDays	int		行程天数
tripNights	int		行程晚数
updateTime	string		更新时间
youngChildCount	int		小童数（私人定制/路书）
total	int		总记录数
message	string		响应消息

---

GET /admin/product/item/{productId}

获取产品详情

获取产品完整信息，包括基本信息、行程天列表、定价配置、费用项等。 返回数据包含关联的行程节点资源详情，适用于产品编辑页面。 不过滤产品状态，所有状态的产品都可查看。

关联字典：

• product_type（产品类型）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马
• product_status（产品状态）：DRAFT=草稿, PENDING_REVIEW=待审核, REVIEWED=已审核, REJECTED=已驳回, PUBLISHED=已上架, UNPUBLISHED=已下架, COMPLETED=已完成, ORDERED=已下单
  • 完整字典值: DRAFT=草稿, PENDING_REVIEW=待审核, REVIEWED=已审核, REJECTED=已驳回, PUBLISHED=已上架, UNPUBLISHED=已下架, COMPLETED=已完成
• product_category（产品分类）：family=亲子游, honeymoon=蜜月游, photography=旅拍, experience=体验, driving=自驾
  • 完整字典值: family=亲子游, honeymoon=蜜月旅行, photography=摄影之旅, experience=深度体验, driving=自驾越野

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«产品详情VO»

字段	类型	必填	说明
code	int		状态码
data	产品详情VO		响应数据
adultCount	int		成人人数
babyCount	int		婴儿人数
benefitsDescription	权益分组[]		权益说明（静态，所有产品相同）
items	权益项[]		权益项列表
title	string		分组标题，如：儿童权益 (1.2m以下)
bookingNotice	string		预定须知
cancelPolicy	string		退改政策
carouselImages	string[]		轮播图列表
carouselVideoUrl	string		轮播视频URL
chatMessages	群聊消息VO[]		群聊消息列表
avatar	string		用户头像URL（type=user时有效）
text	string		消息内容
type	string		消息类型: user/creator
childCount	int		儿童人数
costItems	产品成本项VO[]		成本项列表
category	string		成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
id	string		成本项ID
sortOrder	int		排序序号
title	string		成本项标题
type	string		成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
creatorAvatarUrl	string		定制师头像URL
creatorIntro	string		创作者寄语
customFees	产品自定义费用项VO[]		自定义费用项列表
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string		费用项名称
feeUnit	string		费用单位
id	string		费用项ID
sortOrder	int		排序序号
customizerId	string		定制师ID
departureCity	string		出发城市
destinationCities	string[]		途经城市列表（从行程节点资源去重提取）
destinationCity	string		目的地城市
families	家庭分组VO[]		家庭分组列表（定制产品）
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyId	string		家庭ID
familyName	string		家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数
folderId	string		所属文件夹ID
groupChatQrUrl	string		群聊二维码URL
groupRoomId	string		企微群聊ID(用于会话存档展示群消息)
isBooking	boolean		是否预约产品
itineraryDays	行程天VO[]		行程天列表
dayId	string		行程天ID
dayNumber	int		天数编号
dayTitle	string		天标题
hotels	每日酒店VO[]		当日酒店列表
nodes	行程节点VO[]		行程节点列表
restaurants	用餐选项VO[]		当日用餐列表
routeSummary	string		路线概览
lineId	string		产品线ID
lineName	string		产品线名称
lineSubtitle	string		产品线副标题
maxAdultPerOrder	int		每单最大成人数(null=不限)
maxChildPerOrder	int		每单最大儿童数(null=不限)
mchId	string		商户号
minAdultPerOrder	int		每单最少成人数(null=默认1)
name	string		产品名称
paymentMode	string		支付模式：FULL=全款 DEPOSIT=定金+尾款
pricing	产品定价配置VO		定价配置
adultExtraBed	number		成人加床费
babyPrice	number		婴儿价
balanceDueDays	int		尾款支付截止天数（出发前N天）
childDiscountPercent	number		儿童折扣百分比
childNoBed	number		儿童不占床价
childWithBed	number		儿童占床价
companionPrice	number		陪同人员价格
customTotalPrice	number		定制产品总价（CUSTOM模式下使用）
depositAmount	number		定金金额
depositRatio	int		定金比例（百分比）
extraCostPerPerson	number		每人额外成本
insuranceFee	number		保险费用
markupPercent	number		加价百分比（PERCENT模式下使用）
maxGroupSize	int		最大成团人数
mealBudget	number		餐费预算
minGroupSize	int		最小成团人数
paymentType	string		支付方式：FULL=全款 DEPOSIT=定金+尾款
pricingId	string		定价配置ID
pricingMode	string		定价模式：AUTO=自动计算 MANUAL=手动定价 CUSTOM=定制定价
productId	string		产品ID
profitAmount	number		利润金额（FIXED模式下使用）
profitMode	string		利润模式：FIXED=固定金额 PERCENT=百分比
singleRoomDiff	number		单房差
vehicleModelIds	string[]		车型ID列表
vehicleWarning	string		车辆绑定警告信息（为空表示绑定成功）
productId	string		产品ID
productNo	string		产品编号
productType	string		产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团
publishedAt	string		发布时间
routeMapUrl	string		路径图URL（后端自动生成）
seasons	string[]		适用季节列表
showChatGroup	boolean		是否显示群聊入口
showReview	boolean		是否显示评价
showTripDistance	boolean		是否显示行程距离
showTripTime	boolean		是否显示行程时间
sortOrder	int		排序序号
staffConfigs	产品人员配置VO[]		人员配置列表（定制产品）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
staffType	string		人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
staffTypeName	string		人员类型名称
startPrice	number		起步价：未来一年价格日历中最低成人售价
status	string		产品状态：DRAFT/PENDING_REVIEW/REVIEWED/REJECTED/PUBLISHED/UNPUBLISHED/COMPLETED
subtitle	string		副标题
suppliesList	产品物资VO[]		物资列表
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string		物资ID
suppliesName	string		物资名称
tags	string[]		产品标签列表
teamExperienceYears	int		团队经验年数
tripDays	int		行程天数
tripNights	int		行程晚数
updateBy	string		更新人ID
updateTime	string		更新时间
warmTips	string		温馨提示
youngChildCount	int		小童人数
message	string		响应消息

---

PUT /admin/product/item/{productId}

更新产品

更新产品基本信息，仅传入需要修改的字段，未传字段不会被覆盖。

权限说明：

• 普通管理员只能编辑自己创建的产品
• SUPER_ADMIN 可编辑所有产品

注意：行程、定价、价格日历等通过各自独立的接口管理，不在此接口中处理。

关联字典：

• product_type（产品类型）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马
• product_category（产品分类）：family=亲子游, honeymoon=蜜月游, photography=旅拍, experience=体验, driving=自驾
  • 完整字典值: family=亲子游, honeymoon=蜜月旅行, photography=摄影之旅, experience=深度体验, driving=自驾越野

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 更新产品请求

字段	类型	必填	说明
adultCount	int		成人人数
babyCount	int		婴儿人数
bookingNotice	string		预定须知
cancelPolicy	string		退改政策
carouselImages	string[]		轮播图列表
carouselVideoUrl	string		轮播视频URL
chatMessages	群聊消息VO[]		群聊消息列表
avatar	string		用户头像URL（type=user时有效）
text	string		消息内容
type	string		消息类型: user/creator
childCount	int		儿童人数
creatorAvatarUrl	string		定制师头像URL
creatorIntro	string		创作者寄语
customizerId	string		定制师ID
departureCity	string		出发城市
destinationCity	string		目的地城市
folderId	string		所属文件夹ID
groupChatQrUrl	string		群聊二维码URL
groupRoomId	string		企微群聊ID(用于会话存档展示群消息)
isBooking	boolean		是否预约产品
lineId	string		产品线ID
lineSubtitle	string		产品线副标题
maxAdultPerOrder	int		每单最大成人数(不填则不限制)
maxChildPerOrder	int		每单最大儿童数(不填则不限制)
mchId	string		商户号：shanhe/wenlu
minAdultPerOrder	int		每单最少成人数(不填默认1)
name	string		产品名称
seasons	string[]		适用季节列表
showChatGroup	boolean		是否显示群聊入口
showReview	boolean		是否显示评价
showTripDistance	boolean		是否显示行程距离
showTripTime	boolean		是否显示行程时间
sortOrder	int		排序序号
subtitle	string		副标题
tags	string[]		产品标签列表
teamExperienceYears	int		团队经验年数
tripDays	int		行程天数
warmTips	string		温馨提示
youngChildCount	int		小童人数

响应 统一响应结果«产品详情VO»

字段	类型	必填	说明
code	int		状态码
data	产品详情VO		响应数据
adultCount	int		成人人数
babyCount	int		婴儿人数
benefitsDescription	权益分组[]		权益说明（静态，所有产品相同）
items	权益项[]		权益项列表
title	string		分组标题，如：儿童权益 (1.2m以下)
bookingNotice	string		预定须知
cancelPolicy	string		退改政策
carouselImages	string[]		轮播图列表
carouselVideoUrl	string		轮播视频URL
chatMessages	群聊消息VO[]		群聊消息列表
avatar	string		用户头像URL（type=user时有效）
text	string		消息内容
type	string		消息类型: user/creator
childCount	int		儿童人数
costItems	产品成本项VO[]		成本项列表
category	string		成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
id	string		成本项ID
sortOrder	int		排序序号
title	string		成本项标题
type	string		成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
creatorAvatarUrl	string		定制师头像URL
creatorIntro	string		创作者寄语
customFees	产品自定义费用项VO[]		自定义费用项列表
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string		费用项名称
feeUnit	string		费用单位
id	string		费用项ID
sortOrder	int		排序序号
customizerId	string		定制师ID
departureCity	string		出发城市
destinationCities	string[]		途经城市列表（从行程节点资源去重提取）
destinationCity	string		目的地城市
families	家庭分组VO[]		家庭分组列表（定制产品）
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyId	string		家庭ID
familyName	string		家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数
folderId	string		所属文件夹ID
groupChatQrUrl	string		群聊二维码URL
groupRoomId	string		企微群聊ID(用于会话存档展示群消息)
isBooking	boolean		是否预约产品
itineraryDays	行程天VO[]		行程天列表
dayId	string		行程天ID
dayNumber	int		天数编号
dayTitle	string		天标题
hotels	每日酒店VO[]		当日酒店列表
nodes	行程节点VO[]		行程节点列表
restaurants	用餐选项VO[]		当日用餐列表
routeSummary	string		路线概览
lineId	string		产品线ID
lineName	string		产品线名称
lineSubtitle	string		产品线副标题
maxAdultPerOrder	int		每单最大成人数(null=不限)
maxChildPerOrder	int		每单最大儿童数(null=不限)
mchId	string		商户号
minAdultPerOrder	int		每单最少成人数(null=默认1)
name	string		产品名称
paymentMode	string		支付模式：FULL=全款 DEPOSIT=定金+尾款
pricing	产品定价配置VO		定价配置
adultExtraBed	number		成人加床费
babyPrice	number		婴儿价
balanceDueDays	int		尾款支付截止天数（出发前N天）
childDiscountPercent	number		儿童折扣百分比
childNoBed	number		儿童不占床价
childWithBed	number		儿童占床价
companionPrice	number		陪同人员价格
customTotalPrice	number		定制产品总价（CUSTOM模式下使用）
depositAmount	number		定金金额
depositRatio	int		定金比例（百分比）
extraCostPerPerson	number		每人额外成本
insuranceFee	number		保险费用
markupPercent	number		加价百分比（PERCENT模式下使用）
maxGroupSize	int		最大成团人数
mealBudget	number		餐费预算
minGroupSize	int		最小成团人数
paymentType	string		支付方式：FULL=全款 DEPOSIT=定金+尾款
pricingId	string		定价配置ID
pricingMode	string		定价模式：AUTO=自动计算 MANUAL=手动定价 CUSTOM=定制定价
productId	string		产品ID
profitAmount	number		利润金额（FIXED模式下使用）
profitMode	string		利润模式：FIXED=固定金额 PERCENT=百分比
singleRoomDiff	number		单房差
vehicleModelIds	string[]		车型ID列表
vehicleWarning	string		车辆绑定警告信息（为空表示绑定成功）
productId	string		产品ID
productNo	string		产品编号
productType	string		产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团
publishedAt	string		发布时间
routeMapUrl	string		路径图URL（后端自动生成）
seasons	string[]		适用季节列表
showChatGroup	boolean		是否显示群聊入口
showReview	boolean		是否显示评价
showTripDistance	boolean		是否显示行程距离
showTripTime	boolean		是否显示行程时间
sortOrder	int		排序序号
staffConfigs	产品人员配置VO[]		人员配置列表（定制产品）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
staffType	string		人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
staffTypeName	string		人员类型名称
startPrice	number		起步价：未来一年价格日历中最低成人售价
status	string		产品状态：DRAFT/PENDING_REVIEW/REVIEWED/REJECTED/PUBLISHED/UNPUBLISHED/COMPLETED
subtitle	string		副标题
suppliesList	产品物资VO[]		物资列表
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string		物资ID
suppliesName	string		物资名称
tags	string[]		产品标签列表
teamExperienceYears	int		团队经验年数
tripDays	int		行程天数
tripNights	int		行程晚数
updateBy	string		更新人ID
updateTime	string		更新时间
warmTips	string		温馨提示
youngChildCount	int		小童人数
message	string		响应消息

---

DELETE /admin/product/item/{productId}

删除产品

软删除产品（设置 deleted_at 字段）。

权限说明：普通管理员只能删除自己创建的产品，SUPER_ADMIN 可删除所有产品。 限制：已上架（PUBLISHED）的产品不能直接删除，需先下架。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«Void»

---

POST /admin/product/item/{productId}/copy

复制产品

深度复制产品，包括行程天、行程节点、定价配置、住宿、餐饮、物资、人员配置等所有关联数据。

复制后的产品状态为 DRAFT，名称自动添加"(副本)"后缀。 适用场景：基于已有产品快速创建新产品。

关联字典：

• product_type（产品类型，返回字段）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马
• product_status（产品状态，复制后固定为 DRAFT）
  • 完整字典值: DRAFT=草稿, PENDING_REVIEW=待审核, REVIEWED=已审核, REJECTED=已驳回, PUBLISHED=已上架, UNPUBLISHED=已下架, COMPLETED=已完成

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«产品详情VO»

字段	类型	必填	说明
code	int		状态码
data	产品详情VO		响应数据
adultCount	int		成人人数
babyCount	int		婴儿人数
benefitsDescription	权益分组[]		权益说明（静态，所有产品相同）
items	权益项[]		权益项列表
title	string		分组标题，如：儿童权益 (1.2m以下)
bookingNotice	string		预定须知
cancelPolicy	string		退改政策
carouselImages	string[]		轮播图列表
carouselVideoUrl	string		轮播视频URL
chatMessages	群聊消息VO[]		群聊消息列表
avatar	string		用户头像URL（type=user时有效）
text	string		消息内容
type	string		消息类型: user/creator
childCount	int		儿童人数
costItems	产品成本项VO[]		成本项列表
category	string		成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
id	string		成本项ID
sortOrder	int		排序序号
title	string		成本项标题
type	string		成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
creatorAvatarUrl	string		定制师头像URL
creatorIntro	string		创作者寄语
customFees	产品自定义费用项VO[]		自定义费用项列表
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string		费用项名称
feeUnit	string		费用单位
id	string		费用项ID
sortOrder	int		排序序号
customizerId	string		定制师ID
departureCity	string		出发城市
destinationCities	string[]		途经城市列表（从行程节点资源去重提取）
destinationCity	string		目的地城市
families	家庭分组VO[]		家庭分组列表（定制产品）
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyId	string		家庭ID
familyName	string		家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数
folderId	string		所属文件夹ID
groupChatQrUrl	string		群聊二维码URL
groupRoomId	string		企微群聊ID(用于会话存档展示群消息)
isBooking	boolean		是否预约产品
itineraryDays	行程天VO[]		行程天列表
dayId	string		行程天ID
dayNumber	int		天数编号
dayTitle	string		天标题
hotels	每日酒店VO[]		当日酒店列表
nodes	行程节点VO[]		行程节点列表
restaurants	用餐选项VO[]		当日用餐列表
routeSummary	string		路线概览
lineId	string		产品线ID
lineName	string		产品线名称
lineSubtitle	string		产品线副标题
maxAdultPerOrder	int		每单最大成人数(null=不限)
maxChildPerOrder	int		每单最大儿童数(null=不限)
mchId	string		商户号
minAdultPerOrder	int		每单最少成人数(null=默认1)
name	string		产品名称
paymentMode	string		支付模式：FULL=全款 DEPOSIT=定金+尾款
pricing	产品定价配置VO		定价配置
adultExtraBed	number		成人加床费
babyPrice	number		婴儿价
balanceDueDays	int		尾款支付截止天数（出发前N天）
childDiscountPercent	number		儿童折扣百分比
childNoBed	number		儿童不占床价
childWithBed	number		儿童占床价
companionPrice	number		陪同人员价格
customTotalPrice	number		定制产品总价（CUSTOM模式下使用）
depositAmount	number		定金金额
depositRatio	int		定金比例（百分比）
extraCostPerPerson	number		每人额外成本
insuranceFee	number		保险费用
markupPercent	number		加价百分比（PERCENT模式下使用）
maxGroupSize	int		最大成团人数
mealBudget	number		餐费预算
minGroupSize	int		最小成团人数
paymentType	string		支付方式：FULL=全款 DEPOSIT=定金+尾款
pricingId	string		定价配置ID
pricingMode	string		定价模式：AUTO=自动计算 MANUAL=手动定价 CUSTOM=定制定价
productId	string		产品ID
profitAmount	number		利润金额（FIXED模式下使用）
profitMode	string		利润模式：FIXED=固定金额 PERCENT=百分比
singleRoomDiff	number		单房差
vehicleModelIds	string[]		车型ID列表
vehicleWarning	string		车辆绑定警告信息（为空表示绑定成功）
productId	string		产品ID
productNo	string		产品编号
productType	string		产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团
publishedAt	string		发布时间
routeMapUrl	string		路径图URL（后端自动生成）
seasons	string[]		适用季节列表
showChatGroup	boolean		是否显示群聊入口
showReview	boolean		是否显示评价
showTripDistance	boolean		是否显示行程距离
showTripTime	boolean		是否显示行程时间
sortOrder	int		排序序号
staffConfigs	产品人员配置VO[]		人员配置列表（定制产品）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
staffType	string		人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
staffTypeName	string		人员类型名称
startPrice	number		起步价：未来一年价格日历中最低成人售价
status	string		产品状态：DRAFT/PENDING_REVIEW/REVIEWED/REJECTED/PUBLISHED/UNPUBLISHED/COMPLETED
subtitle	string		副标题
suppliesList	产品物资VO[]		物资列表
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string		物资ID
suppliesName	string		物资名称
tags	string[]		产品标签列表
teamExperienceYears	int		团队经验年数
tripDays	int		行程天数
tripNights	int		行程晚数
updateBy	string		更新人ID
updateTime	string		更新时间
warmTips	string		温馨提示
youngChildCount	int		小童人数
message	string		响应消息

---

POST /admin/product/item/{productId}/generate-route-map

手动生成路径图

根据产品行程节点的经纬度信息，调用地图API生成行程路径图。

通常在行程编辑完成后手动触发，生成结果为 OSS 图片 URL。 如果行程节点没有经纬度信息，则无法生成路径图。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«string»

字段	类型	必填	说明
code	int		状态码
data	string		响应数据
message	string		响应消息

---

PUT /admin/product/item/{productId}/move

移动产品到文件夹

将产品移动到指定文件夹，或移出文件夹（folderId 传空字符串或 null）。 文件夹用于组织管理产品，不影响产品的业务逻辑。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 产品移动请求

字段	类型	必填	说明
folderId	string		目标文件夹ID，为空则移动到根目录

响应 统一响应结果«Void»

---

POST /admin/product/item/{productId}/share-link

生成定制产品分享链接

为 CUSTOM（定制）产品生成小程序分享链接，用于定制师发送给客户查看方案。

限制：仅 CUSTOM 类型且状态为 COMPLETED 的产品可生成。 权限：普通管理员只能为自己创建的产品生成链接，SUPER_ADMIN 不受限制。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«分享链接响应»

字段	类型	必填	说明
code	int		状态码
data	分享链接响应		响应数据
expireTime	object		链接过期时间(Unix时间戳)
productId	long		产品ID
productName	string		产品名称
urlLink	string		微信URL Link
message	string		响应消息

---

PUT /admin/product/item/{productId}/status

产品状态变更（上架/下架/完成）

根据产品类型，状态流转规则不同：

核心产品(CORE) / 小蒙马(GROUP)：支持上架/下架，需企微审批

• DRAFT → PENDING_REVIEW → REVIEWED → PUBLISHED（上架）
• PUBLISHED → UNPUBLISHED（下架）
• UNPUBLISHED → PUBLISHED（重新上架）
• REJECTED → DRAFT（驳回后重新编辑）

定制产品(CUSTOM)：仅支持完成，无上架/下架概念

• DRAFT → COMPLETED（定制师完成设计）
• COMPLETED → ORDERED（客户下单，系统自动变更）
• ORDERED → COMPLETED（订单取消/退款后回退）

关联字典：

• product_type（产品类型，影响状态流转规则）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马
• product_status（产品状态，请求+返回字段）：DRAFT=草稿, PENDING_REVIEW=待审核, REVIEWED=已审核, REJECTED=已驳回, PUBLISHED=已上架, UNPUBLISHED=已下架, COMPLETED=已完成, ORDERED=已下单
  • 完整字典值: DRAFT=草稿, PENDING_REVIEW=待审核, REVIEWED=已审核, REJECTED=已驳回, PUBLISHED=已上架, UNPUBLISHED=已下架, COMPLETED=已完成

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 产品状态变更请求

字段	类型	必填	说明
reason	string		状态变更原因（驳回时必填；上架/下架审批时可填）
status	string	是	目标状态。核心/小蒙马：DRAFT/PENDING_REVIEW/REVIEWED/REJECTED/PUBLISHED/UNPUBLISHED；定制产品：COMPLETED

响应 统一响应结果«Void»

---

产品线管理

POST /admin/product/line

创建产品线

创建产品线，用于对产品进行业务分类（如：亲子游、蜜月游、探险游等）。 产品线在小程序端可作为筛选条件，帮助用户快速找到感兴趣的产品类别。

请求体 创建产品线请求

字段	类型	必填	说明
coverImageUrl	string		封面图URL
description	string		产品线描述
name	string	是	产品线名称
sortOrder	int		排序序号

响应 统一响应结果«产品线VO»

字段	类型	必填	说明
code	int		状态码
data	产品线VO		响应数据
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
description	string		产品线描述
lineId	string		产品线ID
name	string		产品线名称
productCount	int		关联产品数量
sortOrder	int		排序序号
status	string		状态：ACTIVE=启用 INACTIVE=停用
updateTime	string		更新时间
message	string		响应消息

---

GET /admin/product/line/active

所有启用的产品线

获取所有启用状态的产品线，不分页。 适用于产品编辑时的产品线下拉选择，以及小程序端的筛选项。

响应 统一响应结果«List«产品线VO»»

字段	类型	必填	说明
code	int		状态码
data	产品线VO[]		响应数据
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
description	string		产品线描述
lineId	string		产品线ID
name	string		产品线名称
productCount	int		关联产品数量
sortOrder	int		排序序号
status	string		状态：ACTIVE=启用 INACTIVE=停用
updateTime	string		更新时间
message	string		响应消息

---

GET /admin/product/line/list

产品线列表（分页）

分页查询产品线列表，支持按名称关键词筛选。

查询参数

参数	类型	必填	说明	示例
keyword	string		搜索关键词	丽江
page	integer(int32)		页码	1
pageSize	integer(int32)		每页条数	20
status	string		产品线状态：ACTIVE=启用 INACTIVE=停用	ACTIVE

响应 统一响应结果«分页结果«产品线VO»»

字段	类型	必填	说明
code	int		状态码
data	分页结果«产品线VO»		响应数据
page	int		当前页码
pageSize	int		每页条数
records	产品线VO[]		数据列表
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
description	string		产品线描述
lineId	string		产品线ID
name	string		产品线名称
productCount	int		关联产品数量
sortOrder	int		排序序号
status	string		状态：ACTIVE=启用 INACTIVE=停用
updateTime	string		更新时间
total	int		总记录数
message	string		响应消息

---

GET /admin/product/line/{lineId}

产品线详情

获取指定产品线的完整信息。

路径参数

参数	类型	必填	说明
lineId	integer		产品线ID

响应 统一响应结果«产品线VO»

字段	类型	必填	说明
code	int		状态码
data	产品线VO		响应数据
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
description	string		产品线描述
lineId	string		产品线ID
name	string		产品线名称
productCount	int		关联产品数量
sortOrder	int		排序序号
status	string		状态：ACTIVE=启用 INACTIVE=停用
updateTime	string		更新时间
message	string		响应消息

---

PUT /admin/product/line/{lineId}

更新产品线

更新产品线名称、描述、状态等信息。

路径参数

参数	类型	必填	说明
lineId	integer		产品线ID

请求体 更新产品线请求

字段	类型	必填	说明
coverImageUrl	string		封面图URL
description	string		产品线描述
name	string		产品线名称
sortOrder	int		排序序号
status	string		产品线状态：ACTIVE=启用 INACTIVE=停用

响应 统一响应结果«产品线VO»

字段	类型	必填	说明
code	int		状态码
data	产品线VO		响应数据
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
description	string		产品线描述
lineId	string		产品线ID
name	string		产品线名称
productCount	int		关联产品数量
sortOrder	int		排序序号
status	string		状态：ACTIVE=启用 INACTIVE=停用
updateTime	string		更新时间
message	string		响应消息

---

DELETE /admin/product/line/{lineId}

删除产品线

删除产品线（软删除）。已关联产品的产品线仍可删除，但关联产品的产品线字段不会被清空。

路径参数

参数	类型	必填	说明
lineId	integer		产品线ID

响应 统一响应结果«Void»

---

定价与费用管理

POST /admin/product/item/{productId}/cost-item

添加费用项

添加产品的费用包含/不包含说明项。

用于在产品详情页展示"费用包含"和"费用不包含"信息。 仅用于前端展示，不参与报价计算。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 成本项请求

字段	类型	必填	说明
category	string	是	成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
sortOrder	int		排序序号
title	string	是	成本项标题
type	string	是	成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用

响应 统一响应结果«产品成本项VO»

字段	类型	必填	说明
code	int		状态码
data	产品成本项VO		响应数据
category	string		成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
id	string		成本项ID
sortOrder	int		排序序号
title	string		成本项标题
type	string		成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用
message	string		响应消息

---

PUT /admin/product/item/{productId}/cost-item/{itemId}

更新费用项

更新费用包含/不包含说明项的内容。仅用于前端展示，不参与报价计算。

路径参数

参数	类型	必填	说明
itemId	integer		费用项ID
productId	integer		产品ID

请求体 成本项请求

字段	类型	必填	说明
category	string	是	成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
sortOrder	int		排序序号
title	string	是	成本项标题
type	string	是	成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用

响应 统一响应结果«产品成本项VO»

字段	类型	必填	说明
code	int		状态码
data	产品成本项VO		响应数据
category	string		成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
id	string		成本项ID
sortOrder	int		排序序号
title	string		成本项标题
type	string		成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用
message	string		响应消息

---

DELETE /admin/product/item/{productId}/cost-item/{itemId}

删除费用项

删除费用包含/不包含说明项。

路径参数

参数	类型	必填	说明
itemId	integer		费用项ID
productId	integer		产品ID

响应 统一响应结果«Void»

---

GET /admin/product/item/{productId}/cost-items

获取费用项列表

获取产品的所有费用包含/不包含说明项列表。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«List«产品成本项VO»»

字段	类型	必填	说明
code	int		状态码
data	产品成本项VO[]		响应数据
category	string		成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
id	string		成本项ID
sortOrder	int		排序序号
title	string		成本项标题
type	string		成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用
message	string		响应消息

---

POST /admin/product/item/{productId}/custom-fee

添加自定义费用

添加产品级别的自定义费用项，直接设置金额，参与成本自动计算。

与额外成本关联不同，自定义费用不关联资源服务的费用项，而是直接指定费用名称和金额。 适用于临时性或一次性的费用。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 自定义费用项请求

字段	类型	必填	说明
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string	是	费用项名称
feeUnit	string		费用单位
sortOrder	int		排序序号

响应 统一响应结果«产品自定义费用项VO»

字段	类型	必填	说明
code	int		状态码
data	产品自定义费用项VO		响应数据
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string		费用项名称
feeUnit	string		费用单位
id	string		费用项ID
sortOrder	int		排序序号
message	string		响应消息

---

PUT /admin/product/item/{productId}/custom-fee/{feeId}

更新自定义费用

更新自定义费用项的名称、金额等信息。修改后会影响成本自动计算结果。

路径参数

参数	类型	必填	说明
feeId	integer		自定义费用ID
productId	integer		产品ID

请求体 自定义费用项请求

字段	类型	必填	说明
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string	是	费用项名称
feeUnit	string		费用单位
sortOrder	int		排序序号

响应 统一响应结果«产品自定义费用项VO»

字段	类型	必填	说明
code	int		状态码
data	产品自定义费用项VO		响应数据
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string		费用项名称
feeUnit	string		费用单位
id	string		费用项ID
sortOrder	int		排序序号
message	string		响应消息

---

DELETE /admin/product/item/{productId}/custom-fee/{feeId}

删除自定义费用

删除自定义费用项。删除后该费用不再计入成本自动计算。

路径参数

参数	类型	必填	说明
feeId	integer		自定义费用ID
productId	integer		产品ID

响应 统一响应结果«Void»

---

GET /admin/product/item/{productId}/custom-fees

获取自定义费用列表

获取产品的所有自定义费用项列表。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«List«产品自定义费用项VO»»

字段	类型	必填	说明
code	int		状态码
data	产品自定义费用项VO[]		响应数据
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string		费用项名称
feeUnit	string		费用单位
id	string		费用项ID
sortOrder	int		排序序号
message	string		响应消息

---

POST /admin/product/item/{productId}/extra-cost

添加额外成本关联

关联资源服务中的费用项（cost_item）到产品，参与成本自动计算。

额外成本是指不包含在行程节点中、但需要计入总成本的费用。 例如：导游服务费、保险费、通讯费等固定运营开支。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 额外成本请求

字段	类型	必填	说明
costItemId	long	是	额外成本项ID（关联费用项资源）
daily	boolean		是否按天计算：true=按天计算(乘以天数) false=整个行程一次
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
quantity	int		数量
sortOrder	int		排序序号

响应 统一响应结果«产品额外成本VO»

字段	类型	必填	说明
code	int		状态码
data	产品额外成本VO		响应数据
applyRole	string		适用角色
categoryCode	string		费用类别编码
costItemId	string		费用项ID
costItemName	string		费用项名称
daily	boolean		是否按天计算：true=按天计算(乘以天数) false=整个行程一次
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
unit	string		单位
unitPrice	number		单价
message	string		响应消息

---

PUT /admin/product/item/{productId}/extra-cost/{ecId}

更新额外成本关联

更新额外成本关联的费用项、数量等信息。修改后会影响成本自动计算结果。

路径参数

参数	类型	必填	说明
ecId	integer		额外成本ID
productId	integer		产品ID

请求体 额外成本请求

字段	类型	必填	说明
costItemId	long	是	额外成本项ID（关联费用项资源）
daily	boolean		是否按天计算：true=按天计算(乘以天数) false=整个行程一次
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
quantity	int		数量
sortOrder	int		排序序号

响应 统一响应结果«产品额外成本VO»

字段	类型	必填	说明
code	int		状态码
data	产品额外成本VO		响应数据
applyRole	string		适用角色
categoryCode	string		费用类别编码
costItemId	string		费用项ID
costItemName	string		费用项名称
daily	boolean		是否按天计算：true=按天计算(乘以天数) false=整个行程一次
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
unit	string		单位
unitPrice	number		单价
message	string		响应消息

---

DELETE /admin/product/item/{productId}/extra-cost/{ecId}

删除额外成本关联

删除额外成本关联记录。删除后该费用项不再计入成本自动计算。

路径参数

参数	类型	必填	说明
ecId	integer		额外成本ID
productId	integer		产品ID

响应 统一响应结果«Void»

---

GET /admin/product/item/{productId}/extra-costs

获取额外成本关联列表

获取产品关联的所有额外成本项列表，包含费用项名称、金额等信息。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«List«产品额外成本VO»»

字段	类型	必填	说明
code	int		状态码
data	产品额外成本VO[]		响应数据
applyRole	string		适用角色
categoryCode	string		费用类别编码
costItemId	string		费用项ID
costItemName	string		费用项名称
daily	boolean		是否按天计算：true=按天计算(乘以天数) false=整个行程一次
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
unit	string		单位
unitPrice	number		单价
message	string		响应消息

---

GET /admin/product/item/{productId}/price-calendar

获取月度价格日历

获取指定月份的价格日历数据列表。

每条数据包含：日期、成人售价/成本价、儿童售价/成本价、库存、状态（OPEN/CLOSED）等。 CORE/GROUP 产品：价格为单人价格，按人头 × 价格计算总价。 CUSTOM/ROUTE 产品：价格为整单总价，不乘以人头数。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

查询参数

参数	类型	必填	说明	示例
month	integer(int32)		月份
year	integer(int32)		年份

响应 统一响应结果«List«产品价格日历VO»»

字段	类型	必填	说明
code	int		状态码
data	产品价格日历VO[]		响应数据
adultCostPrice	number		成人成本价
adultProfit	number		成人利润
adultSellPrice	number		成人售价
childCostPrice	number		儿童成本价
childProfit	number		儿童利润
childSellPrice	number		儿童售价
costAutoCalc	boolean		是否自动计算成本
date	string		日期
id	string		价格日历ID
profitRate	number		利润率（百分比）
remark	string		备注
sold	int		已售数量
status	string		状态：OPEN=开放 CLOSED=关闭
stock	int		库存数量
message	string		响应消息

---

POST /admin/product/item/{productId}/price-calendar

设置单日价格

设置或更新指定日期的价格和库存。如果该日期已有记录则更新，否则新建。

可设置成人售价/成本价、儿童售价/成本价、库存数量、状态（OPEN/CLOSED）。 状态为 CLOSED 的日期不会出现在小程序端的可选日期中。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 价格日历请求

字段	类型	必填	说明
adultCostPrice	number		成人成本价
adultCount	int		成人人数（GROUP产品自动测算用）
adultSellPrice	number		成人售价
childCostPrice	number		儿童成本价
childSellPrice	number		儿童售价
costAutoCalc	boolean		是否自动计算成本（true时重新测算会自动更新此日期的价格）
date	string	是	日期
remark	string		备注
status	string		状态：OPEN=开放预订 CLOSED=关闭（不可预订）
stock	int		库存数量（CORE/GROUP按人头扣减，CUSTOM/ROUTE按单扣减）

响应 统一响应结果«产品价格日历VO»

字段	类型	必填	说明
code	int		状态码
data	产品价格日历VO		响应数据
adultCostPrice	number		成人成本价
adultProfit	number		成人利润
adultSellPrice	number		成人售价
childCostPrice	number		儿童成本价
childProfit	number		儿童利润
childSellPrice	number		儿童售价
costAutoCalc	boolean		是否自动计算成本
date	string		日期
id	string		价格日历ID
profitRate	number		利润率（百分比）
remark	string		备注
sold	int		已售数量
status	string		状态：OPEN=开放 CLOSED=关闭
stock	int		库存数量
message	string		响应消息

---

POST /admin/product/item/{productId}/price-calendar/auto-calc

自动计算成本并同步到价格日历

根据出发日期和人数，自动计算成本并将结果写入价格日历。

与测算预览不同，此接口会实际更新价格日历数据。 计算逻辑：查询各资源的价格日历 → 汇总成本 → 应用公式和利润规则 → 写入结果。

关联字典：

• vehicle_type（车型）：车辆费用成本计算
  • 完整字典值: SUV=越野车, SEDAN=5座轿车, MPV=7座商务车, MINIBUS=9-15座小巴, BUS=大巴

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 报价请求

字段	类型	必填	说明
adultCount	int	是	成人人数
babyCount	int		婴儿人数（按固定 babyPrice 计算）
childCount	int		儿童人数（占床，按儿童价计算）
childNeedBed	boolean		儿童是否加床（true 时额外加收 childWithBed 费用）
departureDate	string	是	出发日期
youngChildCount	int		小童人数（不占床，按儿童价 × childDiscountPercent 折扣比例计算）

响应 统一响应结果«报价结果VO»

字段	类型	必填	说明
code	int		状态码
data	报价结果VO		响应数据
customFeeCost	number		自定义费用合计（定制产品）
dayCosts	每日成本明细[]		每日成本明细列表
activityCost	number		活动成本
dayCostTotal	number		当日成本合计
dayNumber	int		天数编号
diningCost	number		餐饮成本
extraCost	number		额外成本
hotelCost	number		酒店成本
scenicCost	number		景区成本
serviceCost	number		服务成本
staffCost	number		人员成本
vehicleCost	number		车辆成本
extraCostItems	额外成本明细项[]		额外成本明细列表
costItemName	string		成本项名称
daily	boolean		是否按天计算
days	int		天数（按天计算时）
quantity	int		数量
subtotal	number		小计金额
unitPrice	number		单价
extraCostPerPerson	number		每人额外成本
extraCostTotal	number		额外成本合计
familyCosts	家庭成本明细[]		家庭分组成本明细（定制产品，有分组时返回）
activityCost	number		活动成本
adultCount	int		成人数
babyCost	number		婴儿固定成本
babyCount	int		幼童数
childCount	int		儿童数
costPerPerson	number		人均成本（家庭成本/付费人头）
customFeeCost	number		自定义费用成本
extraCost	number		额外成本
familyId	string		家庭ID
familyName	string		家庭名称
headcount	int		人头数
hotelCost	number		酒店成本
insuranceCost	number		保险成本
payingHeadcount	int		付费人头数（不含幼童）
personCosts	每人成本明细[]		每人分项成本列表
scenicCost	number		景区成本
sellPricePerPerson	number		人均售价（家庭售价/付费人头）
serviceCost	number		服务成本
staffCost	number		人员成本
suppliesCost	number		物资成本
totalCost	number		家庭成本合计
totalProfit	number		家庭利润合计
totalSellPrice	number		家庭售价合计
vehicleCost	number		车辆成本
youngChildCount	int		小童数
grandTotalCost	number		总成本合计
grandTotalProfit	number		总利润合计
grandTotalSellPrice	number		总售价合计
insuranceFee	number		保险费用
profitRate	number		利润率（百分比）
staffCost	number		人员成本
suppliesCost	number		物资成本
totalAdultCost	number		成人总成本
totalAdultProfit	number		成人总利润
totalAdultSellPrice	number		成人总售价
totalBabyCost	number		婴儿总成本
totalBabySellPrice	number		婴儿总售价
totalChildCost	number		儿童总成本
totalChildSellPrice	number		儿童总售价
totalYoungChildCost	number		小童总成本
totalYoungChildSellPrice	number		小童总售价
warnings	string[]		警告信息列表
message	string		响应消息

---

POST /admin/product/item/{productId}/price-calendar/batch

批量设置价格

批量设置日期范围内的价格和库存，支持按星期筛选。

指定 startDate 和 endDate 日期范围，可选 selectedWeekdays 过滤星期几。 示例：设置5月1日-5月31日的工作日（周一到周五=[1,2,3,4,5]）价格。 selectedWeekdays 为空时，范围内所有日期都会被设置。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 批量设置价格日历请求

字段	类型	必填	说明
adultCostPrice	number		成人成本价
adultSellPrice	number		成人售价
childCostPrice	number		儿童成本价
childSellPrice	number		儿童售价
costAutoCalc	boolean		是否自动计算成本
endDate	string	是	结束日期
remark	string		备注
selectedWeekdays	int[]		选中的星期(1=周一...7=周日)，为空或包含全部则不过滤
startDate	string	是	开始日期
status	string		状态：OPEN=开放 CLOSED=关闭
stock	int		库存数量

响应 统一响应结果«List«产品价格日历VO»»

字段	类型	必填	说明
code	int		状态码
data	产品价格日历VO[]		响应数据
adultCostPrice	number		成人成本价
adultProfit	number		成人利润
adultSellPrice	number		成人售价
childCostPrice	number		儿童成本价
childProfit	number		儿童利润
childSellPrice	number		儿童售价
costAutoCalc	boolean		是否自动计算成本
date	string		日期
id	string		价格日历ID
profitRate	number		利润率（百分比）
remark	string		备注
sold	int		已售数量
status	string		状态：OPEN=开放 CLOSED=关闭
stock	int		库存数量
message	string		响应消息

---

POST /admin/product/item/{productId}/price-calendar/calc-preview

测算预览（不写入数据库）

根据行程中的资源价格日历，自动计算指定日期的成本价和售价，仅预览不保存。

用于在设置价格日历前预览自动计算的结果。 计算逻辑：汇总当天所有行程节点关联资源的价格 → 应用公式引擎 → 加上利润。 GROUP 产品需要传 adultCount 参数（影响均摊计算）。

关联字典：

• vehicle_type（车型）：车辆费用成本测算
  • 完整字典值: SUV=越野车, SEDAN=5座轿车, MPV=7座商务车, MINIBUS=9-15座小巴, BUS=大巴

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 成本预览请求

字段	类型	必填	说明
adultCount	int		成人人数（GROUP产品用）
date	string	是	日期

响应 统一响应结果«成本预览VO»

字段	类型	必填	说明
code	int		状态码
data	成本预览VO		响应数据
adultCostPrice	number		成人成本价
adultSellPrice	number		成人售价
childCostPrice	number		儿童成本价
childSellPrice	number		儿童售价
warnings	string[]		警告信息列表
message	string		响应消息

---

POST /admin/product/item/{productId}/price-calendar/recalculate

重新测算所有自动测算日期的价格

重新计算价格日历中所有 costAutoCalc=true 的日期的成本价和售价。

适用场景：资源价格调整后，批量刷新所有自动计算的价格日历。 返回更新的日期数量和详情。手动设置的价格（costAutoCalc=false）不受影响。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«Map«string,object»»

字段	类型	必填	说明
code	int		状态码
data	object		响应数据
message	string		响应消息

---

GET /admin/product/item/{productId}/pricing

获取定价规则

获取产品的定价配置，包括定价模式、利润设置、儿童/婴儿价格、支付方式等。 如果产品尚未设置定价规则，返回 null。

关联字典：

• vehicle_type（车型）：费用配置中车辆相关成本显示
  • 完整字典值: SUV=越野车, SEDAN=5座轿车, MPV=7座商务车, MINIBUS=9-15座小巴, BUS=大巴

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«产品定价配置VO»

字段	类型	必填	说明
code	int		状态码
data	产品定价配置VO		响应数据
adultExtraBed	number		成人加床费
babyPrice	number		婴儿价
balanceDueDays	int		尾款支付截止天数（出发前N天）
childDiscountPercent	number		儿童折扣百分比
childNoBed	number		儿童不占床价
childWithBed	number		儿童占床价
companionPrice	number		陪同人员价格
customTotalPrice	number		定制产品总价（CUSTOM模式下使用）
depositAmount	number		定金金额
depositRatio	int		定金比例（百分比）
extraCostPerPerson	number		每人额外成本
insuranceFee	number		保险费用
markupPercent	number		加价百分比（PERCENT模式下使用）
maxGroupSize	int		最大成团人数
mealBudget	number		餐费预算
minGroupSize	int		最小成团人数
paymentType	string		支付方式：FULL=全款 DEPOSIT=定金+尾款
pricingId	string		定价配置ID
pricingMode	string		定价模式：AUTO=自动计算 MANUAL=手动定价 CUSTOM=定制定价
productId	string		产品ID
profitAmount	number		利润金额（FIXED模式下使用）
profitMode	string		利润模式：FIXED=固定金额 PERCENT=百分比
singleRoomDiff	number		单房差
vehicleModelIds	string[]		车型ID列表
vehicleWarning	string		车辆绑定警告信息（为空表示绑定成功）
message	string		响应消息

---

POST /admin/product/item/{productId}/pricing

保存定价规则

保存或更新产品的定价配置（一个产品仅一条定价记录，重复调用为覆盖更新）。

定价模式：

• AUTO：自动计算，通过公式引擎根据行程资源价格自动测算成本和售价
• MANUAL：手动定价，直接在价格日历中手动设置每日价格
• CUSTOM：定制定价，设置整单总价（customTotalPrice），不按人头

利润模式（AUTO 模式下生效）：

• FIXED：固定金额加价，售价 = 成本 + profitAmount
• PERCENT：百分比加价，售价 = 成本 × (1 + markupPercent/100)

支付方式：FULL=全款支付，DEPOSIT=定金+尾款（需设置 depositRatio 或 depositAmount）

关联字典：

• vehicle_type（车型）：费用配置中车辆相关成本计算
  • 完整字典值: SUV=越野车, SEDAN=5座轿车, MPV=7座商务车, MINIBUS=9-15座小巴, BUS=大巴

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 定价配置请求

字段	类型	必填	说明
adultExtraBed	number		成人加床费
babyPrice	number		婴儿固定价格（不随日期变化）
balanceDueDays	int		尾款支付截止天数（出发前N天必须支付尾款，超时可能取消订单）
childDiscountPercent	number		小童折扣百分比（小童价=儿童价×此百分比/100，如70表示打7折）
childNoBed	number		儿童不占床价（暂未使用，预留字段）
childWithBed	number		儿童加床费（childNeedBed=true时额外加收的费用）
companionPrice	number		陪同人员价格
customTotalPrice	number		定制产品总价（CUSTOM定价模式下使用，代表整单总价）
depositAmount	number		定金金额（固定金额，与depositRatio二选一）
depositRatio	int		定金比例（百分比，如30代表30%。与depositAmount二选一，优先使用比例）
extraCostPerPerson	number		每人额外成本
insuranceFee	number		保险费用
markupPercent	number		加价百分比（PERCENT模式下使用）
maxGroupSize	int		最大成团人数（CORE/GROUP产品用）
mealBudget	number		餐费预算
minGroupSize	int		最小成团人数（CORE/GROUP产品用，影响均摊成本计算）
paymentType	string		支付方式：FULL=全款支付 DEPOSIT=定金+尾款分期支付
pricingMode	string		定价模式：AUTO=根据行程资源价格自动计算 MANUAL=手动在价格日历设置每日价格 CUSTOM=定制产品整单定价
profitAmount	number		利润金额（FIXED模式下使用）
profitMode	string		利润模式（AUTO模式下生效）：FIXED=在成本基础上加固定金额 PERCENT=在成本基础上按百分比加价
singleRoomDiff	number		单房差
vehicleModelIds	long[]		车型ID列表

响应 统一响应结果«产品定价配置VO»

字段	类型	必填	说明
code	int		状态码
data	产品定价配置VO		响应数据
adultExtraBed	number		成人加床费
babyPrice	number		婴儿价
balanceDueDays	int		尾款支付截止天数（出发前N天）
childDiscountPercent	number		儿童折扣百分比
childNoBed	number		儿童不占床价
childWithBed	number		儿童占床价
companionPrice	number		陪同人员价格
customTotalPrice	number		定制产品总价（CUSTOM模式下使用）
depositAmount	number		定金金额
depositRatio	int		定金比例（百分比）
extraCostPerPerson	number		每人额外成本
insuranceFee	number		保险费用
markupPercent	number		加价百分比（PERCENT模式下使用）
maxGroupSize	int		最大成团人数
mealBudget	number		餐费预算
minGroupSize	int		最小成团人数
paymentType	string		支付方式：FULL=全款 DEPOSIT=定金+尾款
pricingId	string		定价配置ID
pricingMode	string		定价模式：AUTO=自动计算 MANUAL=手动定价 CUSTOM=定制定价
productId	string		产品ID
profitAmount	number		利润金额（FIXED模式下使用）
profitMode	string		利润模式：FIXED=固定金额 PERCENT=百分比
singleRoomDiff	number		单房差
vehicleModelIds	string[]		车型ID列表
vehicleWarning	string		车辆绑定警告信息（为空表示绑定成功）
message	string		响应消息

---

定价公式管理

POST /admin/product/formula/group

创建公式组

创建一个新的定价公式组。创建后默认为未激活状态。

公式组编码（groupCode）在同一产品类型下必须唯一。 建议命名规范：{产品类型}_PRICING_V{版本号}，如 CORE_PRICING_V2。

关联字典：

• product_type（产品类型，公式组所属类型）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

请求体 公式组请求

字段	类型	必填	说明
description	string		描述
groupCode	string	是	公式组编码
groupName	string	是	公式组名称
productType	string	是	适用产品类型：CORE/ROUTE/CUSTOM/GROUP

响应 统一响应结果«公式组VO»

字段	类型	必填	说明
code	int		状态码
data	公式组VO		响应数据
createTime	string		创建时间
description	string		描述
groupCode	string		公式组编码
groupId	string		公式组ID
groupName	string		公式组名称
isActive	boolean		是否激活
productType	string		适用产品类型
stepCount	int		步骤数量
version	int		版本号
message	string		响应消息

---

GET /admin/product/formula/group/list

公式组列表

获取定价公式组列表，可按产品类型筛选。

公式引擎说明：定价公式用于自动计算产品的成本价和售价。 每种产品类型可以有多个公式组，但同一时间只能有一个激活的公式组。 公式组包含多个步骤，按顺序执行，每步计算一个中间变量或最终结果。

关联字典：

• product_type（产品类型，筛选条件）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

查询参数

参数	类型	必填	说明	示例
productType	string		productType

响应 统一响应结果«List«公式组VO»»

字段	类型	必填	说明
code	int		状态码
data	公式组VO[]		响应数据
createTime	string		创建时间
description	string		描述
groupCode	string		公式组编码
groupId	string		公式组ID
groupName	string		公式组名称
isActive	boolean		是否激活
productType	string		适用产品类型
stepCount	int		步骤数量
version	int		版本号
message	string		响应消息

---

GET /admin/product/formula/group/{groupId}

公式组详情

获取公式组完整信息。

关联字典：

• product_type（产品类型）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

路径参数

参数	类型	必填	说明
groupId	integer	是	groupId

响应 统一响应结果«公式组VO»

字段	类型	必填	说明
code	int		状态码
data	公式组VO		响应数据
createTime	string		创建时间
description	string		描述
groupCode	string		公式组编码
groupId	string		公式组ID
groupName	string		公式组名称
isActive	boolean		是否激活
productType	string		适用产品类型
stepCount	int		步骤数量
version	int		版本号
message	string		响应消息

---

PUT /admin/product/formula/group/{groupId}

更新公式组

更新公式组信息。

关联字典：

• product_type（产品类型）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

路径参数

参数	类型	必填	说明
groupId	integer	是	groupId

请求体 公式组请求

字段	类型	必填	说明
description	string		描述
groupCode	string	是	公式组编码
groupName	string	是	公式组名称
productType	string	是	适用产品类型：CORE/ROUTE/CUSTOM/GROUP

响应 统一响应结果«公式组VO»

字段	类型	必填	说明
code	int		状态码
data	公式组VO		响应数据
createTime	string		创建时间
description	string		描述
groupCode	string		公式组编码
groupId	string		公式组ID
groupName	string		公式组名称
isActive	boolean		是否激活
productType	string		适用产品类型
stepCount	int		步骤数量
version	int		版本号
message	string		响应消息

---

DELETE /admin/product/formula/group/{groupId}

删除公式组

删除公式组及其下所有步骤。 限制：已激活的公式组不能删除，需先激活其他公式组。

路径参数

参数	类型	必填	说明
groupId	integer	是	groupId

响应 统一响应结果«Void»

---

PUT /admin/product/formula/group/{groupId}/activate

激活公式组

激活指定公式组，同时自动停用同产品类型下的其他公式组。

同一产品类型下只能有一个激活的公式组，激活操作具有排他性。 激活后，该产品类型的自动成本计算将使用此公式组。

关联字典：

• product_type（产品类型，同类型排他激活）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

路径参数

参数	类型	必填	说明
groupId	integer	是	groupId

响应 统一响应结果«Void»

---

GET /admin/product/formula/group/{groupId}/steps

公式步骤列表

获取公式组下所有步骤，按执行顺序（executionOrder）升序排列。 步骤按顺序依次执行，前一步的输出变量可作为后续步骤的输入。

路径参数

参数	类型	必填	说明
groupId	integer	是	groupId

响应 统一响应结果«List«公式步骤VO»»

字段	类型	必填	说明
code	int		状态码
data	公式步骤VO[]		响应数据
createTime	string		创建时间
description	string		描述
executionOrder	int		执行顺序
expression	string		表达式
formulaId	string		公式ID
groupId	string		公式组ID
inputVars	string		输入变量(逗号分隔)
isEnabled	boolean		是否启用
outputVar	string		输出变量名
stepCode	string		步骤编码
stepName	string		步骤名称
updateTime	string		更新时间
message	string		响应消息

---

POST /admin/product/formula/step

创建公式步骤

在公式组中创建一个计算步骤。

表达式语法：使用 Aviator 表达式引擎，支持数学运算、条件判断、内置函数等。 示例：baseCost = adultCount * adultUnitCost + childCount * childUnitCost

输入变量：可引用公式变量表中定义的变量，或前置步骤的输出变量。 输出变量：每个步骤必须指定一个输出变量名，供后续步骤引用。

请求体 公式步骤请求

字段	类型	必填	说明
changeNote	string		变更说明
description	string		描述
executionOrder	int		执行顺序
expression	string	是	Aviator表达式（支持数学运算、条件判断、内置函数；可引用前置步骤的输出变量和公式变量表中的变量）
groupId	long	是	公式组ID
inputVars	string		输入变量(逗号分隔)
outputVar	string	是	输出变量名
stepCode	string	是	步骤编码
stepName	string	是	步骤名称

响应 统一响应结果«公式步骤VO»

字段	类型	必填	说明
code	int		状态码
data	公式步骤VO		响应数据
createTime	string		创建时间
description	string		描述
executionOrder	int		执行顺序
expression	string		表达式
formulaId	string		公式ID
groupId	string		公式组ID
inputVars	string		输入变量(逗号分隔)
isEnabled	boolean		是否启用
outputVar	string		输出变量名
stepCode	string		步骤编码
stepName	string		步骤名称
updateTime	string		更新时间
message	string		响应消息

---

GET /admin/product/formula/step/{formulaId}

公式步骤详情

获取单个公式步骤的完整信息，包含表达式、输入/输出变量、执行顺序等。

路径参数

参数	类型	必填	说明
formulaId	integer	是	formulaId

响应 统一响应结果«公式步骤VO»

字段	类型	必填	说明
code	int		状态码
data	公式步骤VO		响应数据
createTime	string		创建时间
description	string		描述
executionOrder	int		执行顺序
expression	string		表达式
formulaId	string		公式ID
groupId	string		公式组ID
inputVars	string		输入变量(逗号分隔)
isEnabled	boolean		是否启用
outputVar	string		输出变量名
stepCode	string		步骤编码
stepName	string		步骤名称
updateTime	string		更新时间
message	string		响应消息

---

PUT /admin/product/formula/step/{formulaId}

更新公式步骤

更新公式步骤的表达式、输入/输出变量等。 每次更新会自动保存一个版本快照，可通过版本历史接口查看和回滚。

路径参数

参数	类型	必填	说明
formulaId	integer	是	formulaId

请求体 公式步骤请求

字段	类型	必填	说明
changeNote	string		变更说明
description	string		描述
executionOrder	int		执行顺序
expression	string	是	Aviator表达式（支持数学运算、条件判断、内置函数；可引用前置步骤的输出变量和公式变量表中的变量）
groupId	long	是	公式组ID
inputVars	string		输入变量(逗号分隔)
outputVar	string	是	输出变量名
stepCode	string	是	步骤编码
stepName	string	是	步骤名称

响应 统一响应结果«公式步骤VO»

字段	类型	必填	说明
code	int		状态码
data	公式步骤VO		响应数据
createTime	string		创建时间
description	string		描述
executionOrder	int		执行顺序
expression	string		表达式
formulaId	string		公式ID
groupId	string		公式组ID
inputVars	string		输入变量(逗号分隔)
isEnabled	boolean		是否启用
outputVar	string		输出变量名
stepCode	string		步骤编码
stepName	string		步骤名称
updateTime	string		更新时间
message	string		响应消息

---

DELETE /admin/product/formula/step/{formulaId}

删除公式步骤

删除指定的公式步骤。删除后其他步骤的执行顺序不会自动调整。 注意：如果后续步骤引用了被删步骤的输出变量，执行时会报错。

路径参数

参数	类型	必填	说明
formulaId	integer	是	formulaId

响应 统一响应结果«Void»

---

PUT /admin/product/formula/step/{formulaId}/rollback/{versionNum}

回滚公式步骤到指定版本

将公式步骤回滚到历史版本。 回滚操作会用历史版本的表达式、变量等覆盖当前内容，并创建一个新的版本记录。

路径参数

参数	类型	必填	说明
formulaId	integer	是	formulaId
versionNum	integer	是	versionNum

响应 统一响应结果«公式步骤VO»

字段	类型	必填	说明
code	int		状态码
data	公式步骤VO		响应数据
createTime	string		创建时间
description	string		描述
executionOrder	int		执行顺序
expression	string		表达式
formulaId	string		公式ID
groupId	string		公式组ID
inputVars	string		输入变量(逗号分隔)
isEnabled	boolean		是否启用
outputVar	string		输出变量名
stepCode	string		步骤编码
stepName	string		步骤名称
updateTime	string		更新时间
message	string		响应消息

---

PUT /admin/product/formula/step/{formulaId}/toggle

启用/禁用公式步骤

切换公式步骤的启用状态。 禁用的步骤在公式执行时会被跳过，不影响其他步骤的执行。 适用场景：临时跳过某个计算步骤进行调试或测试。

路径参数

参数	类型	必填	说明
formulaId	integer	是	formulaId

响应 统一响应结果«Void»

---

GET /admin/product/formula/step/{formulaId}/versions

公式步骤版本历史

获取公式步骤的所有历史版本列表，按版本号倒序。 每次更新步骤表达式会自动创建新版本，方便追溯和回滚。

路径参数

参数	类型	必填	说明
formulaId	integer	是	formulaId

响应 统一响应结果«List«公式版本历史VO»»

字段	类型	必填	说明
code	int		状态码
data	公式版本历史VO[]		响应数据
changeNote	string		变更说明
changedBy	string		变更人ID
createTime	string		创建时间
expression	string		表达式
formulaId	string		公式ID
versionId	string		版本ID
versionNum	int		版本号
message	string		响应消息

---

POST /admin/product/formula/test

测试公式执行

使用自定义变量值测试公式组的执行结果，不影响任何业务数据。

传入公式组ID和测试变量（变量名→值的映射），返回每个步骤的执行结果。 适用于公式调试：验证表达式是否正确、计算结果是否符合预期。 如果某步骤执行出错，会在结果中标明错误信息。

请求体 公式测试请求

字段	类型	必填	说明
groupId	long	是	公式组ID
variables	object	是	测试变量(变量名→值)

响应 统一响应结果«公式测试结果VO»

字段	类型	必填	说明
code	int		状态码
data	公式测试结果VO		响应数据
errorMessage	string		错误信息
finalVariables	object		最终变量表
stepResults	步骤执行结果[]		各步骤执行结果
errorMessage	string		错误信息
executionTimeMs	long		执行耗时(毫秒)
expression	string		表达式
outputValue	object		输出值
outputVar	string		输出变量名
stepCode	string		步骤编码
stepName	string		步骤名称
success	boolean		是否成功
success	boolean		是否成功
totalTimeMs	long		总耗时(毫秒)
message	string		响应消息

---

POST /admin/product/formula/var

创建公式变量

创建公式变量定义。变量名（varName）全局唯一，建议使用驼峰命名。 可指定适用的产品类型列表（productTypes），为空则适用于所有类型。

关联字典：

• product_type（产品类型，变量适用范围）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

请求体 公式变量请求

字段	类型	必填	说明
category	string	是	变量分类：INPUT/INTERMEDIATE/OUTPUT
defaultValue	string		默认值
description	string		描述
productTypes	string[]		适用产品类型列表
varName	string	是	变量名
varType	string	是	变量类型：DECIMAL/INTEGER/BOOLEAN/STRING

响应 统一响应结果«公式变量VO»

字段	类型	必填	说明
code	int		状态码
data	公式变量VO		响应数据
category	string		变量分类：INPUT/INTERMEDIATE/OUTPUT
defaultValue	string		默认值
description	string		描述
productTypes	string[]		适用产品类型列表
varId	string		变量ID
varName	string		变量名
varType	string		变量类型：DECIMAL/INTEGER/BOOLEAN/STRING
message	string		响应消息

---

GET /admin/product/formula/var/list

公式变量列表

获取公式变量列表，可按变量分类筛选。

变量分类：

• INPUT：输入变量，从业务数据获取（如成人人数、资源单价）
• INTERMEDIATE：中间变量，由公式步骤计算得出
• OUTPUT：输出变量，最终报价结果（如总成本、售价）

查询参数

参数	类型	必填	说明	示例
category	string		category

响应 统一响应结果«List«公式变量VO»»

字段	类型	必填	说明
code	int		状态码
data	公式变量VO[]		响应数据
category	string		变量分类：INPUT/INTERMEDIATE/OUTPUT
defaultValue	string		默认值
description	string		描述
productTypes	string[]		适用产品类型列表
varId	string		变量ID
varName	string		变量名
varType	string		变量类型：DECIMAL/INTEGER/BOOLEAN/STRING
message	string		响应消息

---

PUT /admin/product/formula/var/{varId}

更新公式变量

更新公式变量定义。

关联字典：

• product_type（产品类型，变量适用范围）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

路径参数

参数	类型	必填	说明
varId	integer	是	varId

请求体 公式变量请求

字段	类型	必填	说明
category	string	是	变量分类：INPUT/INTERMEDIATE/OUTPUT
defaultValue	string		默认值
description	string		描述
productTypes	string[]		适用产品类型列表
varName	string	是	变量名
varType	string	是	变量类型：DECIMAL/INTEGER/BOOLEAN/STRING

响应 统一响应结果«公式变量VO»

字段	类型	必填	说明
code	int		状态码
data	公式变量VO		响应数据
category	string		变量分类：INPUT/INTERMEDIATE/OUTPUT
defaultValue	string		默认值
description	string		描述
productTypes	string[]		适用产品类型列表
varId	string		变量ID
varName	string		变量名
varType	string		变量类型：DECIMAL/INTEGER/BOOLEAN/STRING
message	string		响应消息

---

DELETE /admin/product/formula/var/{varId}

删除公式变量

删除公式变量定义。 注意：如果有公式步骤引用了该变量，删除后步骤执行时会报错。建议先确认无引用再删除。

路径参数

参数	类型	必填	说明
varId	integer	是	varId

响应 统一响应结果«Void»

---

家庭分组管理

GET /admin/product/item/{productId}/families

获取家庭分组列表

获取产品的家庭分组列表，按排序序号升序。

仅适用于 CUSTOM（定制）产品。 家庭分组用于将定制产品的行程按家庭单位分配，每个家庭可以有不同的人数和行程安排。 行程节点通过 familyIds 字段关联到具体的家庭分组。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«List«家庭分组VO»»

字段	类型	必填	说明
code	int		状态码
data	家庭分组VO[]		响应数据
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyId	string		家庭ID
familyName	string		家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数
message	string		响应消息

---

POST /admin/product/item/{productId}/family

添加家庭分组

为 CUSTOM 定制产品添加一个家庭分组，指定家庭名称和各类型人数。 添加后可在行程节点中关联此家庭，实现按家庭分配行程。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 家庭分组保存请求

字段	类型	必填	说明
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyName	string	是	家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数

响应 统一响应结果«家庭分组VO»

字段	类型	必填	说明
code	int		状态码
data	家庭分组VO		响应数据
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyId	string		家庭ID
familyName	string		家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数
message	string		响应消息

---

PUT /admin/product/item/{productId}/family/{familyId}

更新家庭分组

更新家庭分组的名称、各类型人数等信息。 仅适用于 CUSTOM（定制）产品。

路径参数

参数	类型	必填	说明
familyId	integer		家庭ID
productId	integer		产品ID

请求体 家庭分组保存请求

字段	类型	必填	说明
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyName	string	是	家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数

响应 统一响应结果«家庭分组VO»

字段	类型	必填	说明
code	int		状态码
data	家庭分组VO		响应数据
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyId	string		家庭ID
familyName	string		家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数
message	string		响应消息

---

DELETE /admin/product/item/{productId}/family/{familyId}

删除家庭分组

删除家庭分组。如果有行程节点通过 familyIds 关联了该分组，需要手动移除关联。 仅适用于 CUSTOM（定制）产品。

路径参数

参数	类型	必填	说明
familyId	integer		家庭ID
productId	integer		产品ID

响应 统一响应结果«Void»

---

小程序-产品

GET /mp/product/list

产品列表（C端）

小程序端产品列表接口，仅返回已上架（PUBLISHED）的产品。

支持按产品类型、季节、行程天数、目的地、产品线、支付模式、定制师等筛选。 默认按 sortOrder 排序，也可按价格或行程天数排序。

关联字典：

• product_type（产品类型，筛选条件）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

查询参数

参数	类型	必填	说明	示例
designerId	integer(int64)		定制师ID（创建者ID）筛选	1893012345678901234
destination	string		目的地筛选	丽江
keyword	string		搜索关键词（产品名称）	丽江
lineId	string		产品线ID筛选	1893012345678901234
page	integer(int32)		页码	1
pageSize	integer(int32)		每页条数	10
paymentMode	string		支付模式筛选：FULL=全款 DEPOSIT=定金+尾款 null=全部	DEPOSIT
productType	string		产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团	CORE
season	string		季节筛选	spring
sortBy	string		排序字段：price/tripDays/default(默认按sortOrder)	price
sortDir	string		排序方向：asc/desc	asc
tripDays	integer(int32)		行程天数筛选	5

响应 统一响应结果«分页结果«C端产品列表VO»»

字段	类型	必填	说明
code	int		状态码
data	分页结果«C端产品列表VO»		响应数据
page	int		当前页码
pageSize	int		每页条数
records	C端产品列表VO[]		数据列表
coverImageUrl	string		封面图URL
creatorAvatarUrl	string		定制师头像URL
departureCity	string		出发城市
destinationCity	string		目的地城市
lineName	string		产品线名称
name	string		产品名称
paymentMode	string		支付模式：FULL=全款 DEPOSIT=定金+尾款
productId	string		产品ID
productType	string		产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团
routeMapUrl	string		路径图URL
seasons	string[]		适用季节列表
startPrice	number		起步价（来自定价配置）
subtitle	string		副标题
tags	string[]		产品标签列表
tripDays	int		行程天数
tripNights	int		行程晚数
total	int		总记录数
message	string		响应消息

---

GET /mp/product/{productId}

产品详情（C端）

小程序端产品详情接口，仅返回已上架（PUBLISHED）的产品。 包含完整的行程信息、定价配置、费用说明、创作者寄语等。 未上架的产品会返回 404 错误。

关联字典：

• product_type（产品类型）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马
• product_category（产品分类）：family=亲子游, honeymoon=蜜月游, photography=旅拍, experience=体验, driving=自驾
  • 完整字典值: family=亲子游, honeymoon=蜜月旅行, photography=摄影之旅, experience=深度体验, driving=自驾越野

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«产品详情VO»

字段	类型	必填	说明
code	int		状态码
data	产品详情VO		响应数据
adultCount	int		成人人数
babyCount	int		婴儿人数
benefitsDescription	权益分组[]		权益说明（静态，所有产品相同）
items	权益项[]		权益项列表
title	string		分组标题，如：儿童权益 (1.2m以下)
bookingNotice	string		预定须知
cancelPolicy	string		退改政策
carouselImages	string[]		轮播图列表
carouselVideoUrl	string		轮播视频URL
chatMessages	群聊消息VO[]		群聊消息列表
avatar	string		用户头像URL（type=user时有效）
text	string		消息内容
type	string		消息类型: user/creator
childCount	int		儿童人数
costItems	产品成本项VO[]		成本项列表
category	string		成本项类别：HOTEL/SCENIC/VEHICLE/ACTIVITY/SERVICE/DINING/OTHER
description	string		成本项描述
id	string		成本项ID
sortOrder	int		排序序号
title	string		成本项标题
type	string		成本项类型：INCLUDED=费用包含 EXCLUDED=费用不含 SELF_PAY=自理费用
coverImageUrl	string		封面图URL
createBy	string		创建人ID
createTime	string		创建时间
creatorAvatarUrl	string		定制师头像URL
creatorIntro	string		创作者寄语
customFees	产品自定义费用项VO[]		自定义费用项列表
description	string		费用说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
feeAmount	number		费用金额
feeName	string		费用项名称
feeUnit	string		费用单位
id	string		费用项ID
sortOrder	int		排序序号
customizerId	string		定制师ID
departureCity	string		出发城市
destinationCities	string[]		途经城市列表（从行程节点资源去重提取）
destinationCity	string		目的地城市
families	家庭分组VO[]		家庭分组列表（定制产品）
adultCount	int		成人数
babyCount	int		幼童数
childCount	int		儿童数
familyId	string		家庭ID
familyName	string		家庭名称
sortOrder	int		排序序号
youngChildCount	int		小童数
folderId	string		所属文件夹ID
groupChatQrUrl	string		群聊二维码URL
groupRoomId	string		企微群聊ID(用于会话存档展示群消息)
isBooking	boolean		是否预约产品
itineraryDays	行程天VO[]		行程天列表
dayId	string		行程天ID
dayNumber	int		天数编号
dayTitle	string		天标题
hotels	每日酒店VO[]		当日酒店列表
nodes	行程节点VO[]		行程节点列表
restaurants	用餐选项VO[]		当日用餐列表
routeSummary	string		路线概览
lineId	string		产品线ID
lineName	string		产品线名称
lineSubtitle	string		产品线副标题
maxAdultPerOrder	int		每单最大成人数(null=不限)
maxChildPerOrder	int		每单最大儿童数(null=不限)
mchId	string		商户号
minAdultPerOrder	int		每单最少成人数(null=默认1)
name	string		产品名称
paymentMode	string		支付模式：FULL=全款 DEPOSIT=定金+尾款
pricing	产品定价配置VO		定价配置
adultExtraBed	number		成人加床费
babyPrice	number		婴儿价
balanceDueDays	int		尾款支付截止天数（出发前N天）
childDiscountPercent	number		儿童折扣百分比
childNoBed	number		儿童不占床价
childWithBed	number		儿童占床价
companionPrice	number		陪同人员价格
customTotalPrice	number		定制产品总价（CUSTOM模式下使用）
depositAmount	number		定金金额
depositRatio	int		定金比例（百分比）
extraCostPerPerson	number		每人额外成本
insuranceFee	number		保险费用
markupPercent	number		加价百分比（PERCENT模式下使用）
maxGroupSize	int		最大成团人数
mealBudget	number		餐费预算
minGroupSize	int		最小成团人数
paymentType	string		支付方式：FULL=全款 DEPOSIT=定金+尾款
pricingId	string		定价配置ID
pricingMode	string		定价模式：AUTO=自动计算 MANUAL=手动定价 CUSTOM=定制定价
productId	string		产品ID
profitAmount	number		利润金额（FIXED模式下使用）
profitMode	string		利润模式：FIXED=固定金额 PERCENT=百分比
singleRoomDiff	number		单房差
vehicleModelIds	string[]		车型ID列表
vehicleWarning	string		车辆绑定警告信息（为空表示绑定成功）
productId	string		产品ID
productNo	string		产品编号
productType	string		产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团
publishedAt	string		发布时间
routeMapUrl	string		路径图URL（后端自动生成）
seasons	string[]		适用季节列表
showChatGroup	boolean		是否显示群聊入口
showReview	boolean		是否显示评价
showTripDistance	boolean		是否显示行程距离
showTripTime	boolean		是否显示行程时间
sortOrder	int		排序序号
staffConfigs	产品人员配置VO[]		人员配置列表（定制产品）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
staffType	string		人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
staffTypeName	string		人员类型名称
startPrice	number		起步价：未来一年价格日历中最低成人售价
status	string		产品状态：DRAFT/PENDING_REVIEW/REVIEWED/REJECTED/PUBLISHED/UNPUBLISHED/COMPLETED
subtitle	string		副标题
suppliesList	产品物资VO[]		物资列表
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string		物资ID
suppliesName	string		物资名称
tags	string[]		产品标签列表
teamExperienceYears	int		团队经验年数
tripDays	int		行程天数
tripNights	int		行程晚数
updateBy	string		更新人ID
updateTime	string		更新时间
warmTips	string		温馨提示
youngChildCount	int		小童人数
message	string		响应消息

---

POST /mp/product/{productId}/quote

报价计算（C端）

小程序端报价计算接口，根据用户选择的日期和人数计算总价。 内部会校验产品是否存在且已上架。 详细计算逻辑参见管理后台的报价计算接口说明。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 报价请求

字段	类型	必填	说明
adultCount	int	是	成人人数
babyCount	int		婴儿人数（按固定 babyPrice 计算）
childCount	int		儿童人数（占床，按儿童价计算）
childNeedBed	boolean		儿童是否加床（true 时额外加收 childWithBed 费用）
departureDate	string	是	出发日期
youngChildCount	int		小童人数（不占床，按儿童价 × childDiscountPercent 折扣比例计算）

响应 统一响应结果«报价结果VO»

字段	类型	必填	说明
code	int		状态码
data	报价结果VO		响应数据
customFeeCost	number		自定义费用合计（定制产品）
dayCosts	每日成本明细[]		每日成本明细列表
activityCost	number		活动成本
dayCostTotal	number		当日成本合计
dayNumber	int		天数编号
diningCost	number		餐饮成本
extraCost	number		额外成本
hotelCost	number		酒店成本
scenicCost	number		景区成本
serviceCost	number		服务成本
staffCost	number		人员成本
vehicleCost	number		车辆成本
extraCostItems	额外成本明细项[]		额外成本明细列表
costItemName	string		成本项名称
daily	boolean		是否按天计算
days	int		天数（按天计算时）
quantity	int		数量
subtotal	number		小计金额
unitPrice	number		单价
extraCostPerPerson	number		每人额外成本
extraCostTotal	number		额外成本合计
familyCosts	家庭成本明细[]		家庭分组成本明细（定制产品，有分组时返回）
activityCost	number		活动成本
adultCount	int		成人数
babyCost	number		婴儿固定成本
babyCount	int		幼童数
childCount	int		儿童数
costPerPerson	number		人均成本（家庭成本/付费人头）
customFeeCost	number		自定义费用成本
extraCost	number		额外成本
familyId	string		家庭ID
familyName	string		家庭名称
headcount	int		人头数
hotelCost	number		酒店成本
insuranceCost	number		保险成本
payingHeadcount	int		付费人头数（不含幼童）
personCosts	每人成本明细[]		每人分项成本列表
scenicCost	number		景区成本
sellPricePerPerson	number		人均售价（家庭售价/付费人头）
serviceCost	number		服务成本
staffCost	number		人员成本
suppliesCost	number		物资成本
totalCost	number		家庭成本合计
totalProfit	number		家庭利润合计
totalSellPrice	number		家庭售价合计
vehicleCost	number		车辆成本
youngChildCount	int		小童数
grandTotalCost	number		总成本合计
grandTotalProfit	number		总利润合计
grandTotalSellPrice	number		总售价合计
insuranceFee	number		保险费用
profitRate	number		利润率（百分比）
staffCost	number		人员成本
suppliesCost	number		物资成本
totalAdultCost	number		成人总成本
totalAdultProfit	number		成人总利润
totalAdultSellPrice	number		成人总售价
totalBabyCost	number		婴儿总成本
totalBabySellPrice	number		婴儿总售价
totalChildCost	number		儿童总成本
totalChildSellPrice	number		儿童总售价
totalYoungChildCost	number		小童总成本
totalYoungChildSellPrice	number		小童总售价
warnings	string[]		警告信息列表
message	string		响应消息

---

报价计算

GET /admin/product/item/{productId}/group-quote

GROUP产品报价（按套餐组合）

为 GROUP（小蒙马拼团）产品按团期批次和套餐组合计算报价。

GROUP 产品的价格由批次下的套餐组合（combo）决定，不同组合有不同的成人/儿童人数搭配和价格。 传入 batchId 指定团期批次，adultCount 用于匹配合适的套餐组合。

与普通报价的区别：普通报价从价格日历取单价，GROUP 报价从套餐组合取打包价。

关联字典：

• product_type（产品类型，仅限GROUP）：GROUP=小蒙马拼团
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

路径参数

参数	类型	必填	说明
productId	integer		产品ID

查询参数

参数	类型	必填	说明	示例
adultCount	integer(int32)		成人人数
batchId	integer(int64)		团期ID

响应 统一响应结果«GROUP产品报价结果»

字段	类型	必填	说明
code	int		状态码
data	GROUP产品报价结果		响应数据
adultCostPrice	number		成人成本价(单房差+每人费用)
adultSellPrice	number		成人售价
childCostPrice	number		儿童成本价(每人费用，不含酒店)
childSellPrice	number		儿童售价
code	int		返回码: 0=成功, 1=非GROUP产品, 2=错误
dayCosts	每日成本明细[]		每日成本明细
activityCost	number		活动成本
dayCostTotal	number		当日成本合计
dayNumber	int		天数编号
diningCost	number		餐饮成本
extraCost	number		额外成本
hotelCost	number		酒店成本
scenicCost	number		景区成本
serviceCost	number		服务成本
staffCost	number		人员成本
vehicleCost	number		车辆成本
extraCostItems	额外成本明细项[]		额外成本明细列表
costItemName	string		成本项名称
daily	boolean		是否按天计算
days	int		天数（按天计算时）
quantity	int		数量
subtotal	number		小计金额
unitPrice	number		单价
extraCostPerPerson	number		额外成本（人均）
extraCostTotal	number		额外成本总额（团队）
hotelCostTotal	number		酒店总成本
message	string		错误信息(code!=0时)
perPersonCost	number		每人成本(不含酒店)
profitMode	string		利润模式
singleRoomSupplement	number		单房差(酒店总成本/2)
warnings	string[]		警告信息
message	string		响应消息

---

POST /admin/product/item/{productId}/quote

计算报价

根据出发日期和人数组合，计算产品的完整报价。

计算流程：

1. 从价格日历获取指定日期的单价
2. 按人数类型分别计算：成人 × 成人价、儿童 × 儿童价
3. 小童按儿童价 × 折扣比例（childDiscountPercent）计算
4. 婴儿使用固定价格（babyPrice）
5. 儿童加床（childNeedBed=true）额外加收 childWithBed 费用

CUSTOM/ROUTE 产品：价格日历存的是整单总价，不按人头乘算。 GROUP 产品：建议使用 group-quote 接口，支持套餐组合报价。

关联字典：

• product_type（产品类型，影响计算逻辑）：CORE=核心产品, GROUP=小蒙马拼团, CUSTOM=定制产品, ROUTE=线路产品
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 报价请求

字段	类型	必填	说明
adultCount	int	是	成人人数
babyCount	int		婴儿人数（按固定 babyPrice 计算）
childCount	int		儿童人数（占床，按儿童价计算）
childNeedBed	boolean		儿童是否加床（true 时额外加收 childWithBed 费用）
departureDate	string	是	出发日期
youngChildCount	int		小童人数（不占床，按儿童价 × childDiscountPercent 折扣比例计算）

响应 统一响应结果«报价结果VO»

字段	类型	必填	说明
code	int		状态码
data	报价结果VO		响应数据
customFeeCost	number		自定义费用合计（定制产品）
dayCosts	每日成本明细[]		每日成本明细列表
activityCost	number		活动成本
dayCostTotal	number		当日成本合计
dayNumber	int		天数编号
diningCost	number		餐饮成本
extraCost	number		额外成本
hotelCost	number		酒店成本
scenicCost	number		景区成本
serviceCost	number		服务成本
staffCost	number		人员成本
vehicleCost	number		车辆成本
extraCostItems	额外成本明细项[]		额外成本明细列表
costItemName	string		成本项名称
daily	boolean		是否按天计算
days	int		天数（按天计算时）
quantity	int		数量
subtotal	number		小计金额
unitPrice	number		单价
extraCostPerPerson	number		每人额外成本
extraCostTotal	number		额外成本合计
familyCosts	家庭成本明细[]		家庭分组成本明细（定制产品，有分组时返回）
activityCost	number		活动成本
adultCount	int		成人数
babyCost	number		婴儿固定成本
babyCount	int		幼童数
childCount	int		儿童数
costPerPerson	number		人均成本（家庭成本/付费人头）
customFeeCost	number		自定义费用成本
extraCost	number		额外成本
familyId	string		家庭ID
familyName	string		家庭名称
headcount	int		人头数
hotelCost	number		酒店成本
insuranceCost	number		保险成本
payingHeadcount	int		付费人头数（不含幼童）
personCosts	每人成本明细[]		每人分项成本列表
scenicCost	number		景区成本
sellPricePerPerson	number		人均售价（家庭售价/付费人头）
serviceCost	number		服务成本
staffCost	number		人员成本
suppliesCost	number		物资成本
totalCost	number		家庭成本合计
totalProfit	number		家庭利润合计
totalSellPrice	number		家庭售价合计
vehicleCost	number		车辆成本
youngChildCount	int		小童数
grandTotalCost	number		总成本合计
grandTotalProfit	number		总利润合计
grandTotalSellPrice	number		总售价合计
insuranceFee	number		保险费用
profitRate	number		利润率（百分比）
staffCost	number		人员成本
suppliesCost	number		物资成本
totalAdultCost	number		成人总成本
totalAdultProfit	number		成人总利润
totalAdultSellPrice	number		成人总售价
totalBabyCost	number		婴儿总成本
totalBabySellPrice	number		婴儿总售价
totalChildCost	number		儿童总成本
totalChildSellPrice	number		儿童总售价
totalYoungChildCost	number		小童总成本
totalYoungChildSellPrice	number		小童总售价
warnings	string[]		警告信息列表
message	string		响应消息

---

拼团批次管理

POST /admin/product/item/{productId}/batch

创建主批次

为 GROUP（小蒙马拼团）产品创建一个团期主批次。

仅适用于 GROUP 产品类型。 每个批次有独立的出发日期、报名截止日期、人数上限。 创建后状态为 PENDING（待开放），需手动开启报名。

批次状态流转：PENDING → ENROLLING（报名中）→ CONFIRMED（已成团）→ CLOSED（已关闭） 任意报名状态均可被解散（DISBANDED）。

关联字典：

• product_type（产品类型，仅限GROUP）：GROUP=小蒙马拼团
  • 完整字典值: CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马
• batch_status（批次状态）：PENDING=待开放, ENROLLING=报名中, CONFIRMED=已成团, FULL=已满员, CLOSED=已关闭, DISBANDED=已解散, IN_PROGRESS=进行中, FINISHED=已结束
  • 完整字典值: PENDING=待开放, ENROLLING=报名中, CONFIRMED=已成团, FULL=已满员, CLOSED=已截止, DISBANDED=已散团, IN_PROGRESS=出行中, FINISHED=已结束

路径参数

参数	类型	必填	说明
productId	integer	是	productId

请求体 创建拼团批次请求

字段	类型	必填	说明
batchName	string	是	批次名称
departureDate	string	是	出发日期
enrollmentDeadline	string	是	报名截止日期，必须早于出发日期
maxParticipants	int	是	最大参团人数（报名人数达到上限后自动关闭报名）
minParticipants	int		最低成团人数（0=不限制，达到此人数自动变为CONFIRMED状态）
remark	string		备注说明
sortOrder	int		排序序号（越小越靠前）

响应 统一响应结果«团批次VO»

字段	类型	必填	说明
code	int		状态码
data	团批次VO		响应数据
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
subBatches	团批次VO[]		子批次列表(树形)
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
subBatches	团批次VO[]		子批次列表(树形)
updateTime	string		更新时间
updateTime	string		更新时间
message	string		响应消息

---

GET /admin/product/item/{productId}/batch/list

批次列表(树形)

获取产品所有批次，以树形结构返回（主批次包含子批次列表）。 按出发日期升序排列，包含每个批次的报名人数和剩余名额。

关联字典：

• batch_status（批次状态，返回字段）：PENDING=待开放, ENROLLING=报名中, CONFIRMED=已成团, FULL=已满员, CLOSED=已关闭, DISBANDED=已解散, IN_PROGRESS=进行中, FINISHED=已结束
  • 完整字典值: PENDING=待开放, ENROLLING=报名中, CONFIRMED=已成团, FULL=已满员, CLOSED=已截止, DISBANDED=已散团, IN_PROGRESS=出行中, FINISHED=已结束

路径参数

参数	类型	必填	说明
productId	integer	是	productId

响应 统一响应结果«List«团批次VO»»

字段	类型	必填	说明
code	int		状态码
data	团批次VO[]		响应数据
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
subBatches	团批次VO[]		子批次列表(树形)
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
subBatches	团批次VO[]		子批次列表(树形)
updateTime	string		更新时间
updateTime	string		更新时间
message	string		响应消息

---

GET /admin/product/item/{productId}/batch/{batchId}

批次详情

获取单个批次的完整信息，包括批次基本信息、服务人员配置、套餐组合等。

关联字典：

• batch_status（批次状态）：PENDING=待开放, ENROLLING=报名中, CONFIRMED=已成团, FULL=已满员, CLOSED=已关闭, DISBANDED=已解散, IN_PROGRESS=进行中, FINISHED=已结束
  • 完整字典值: PENDING=待开放, ENROLLING=报名中, CONFIRMED=已成团, FULL=已满员, CLOSED=已截止, DISBANDED=已散团, IN_PROGRESS=出行中, FINISHED=已结束
• staff_type（人员类型，服务人员配置）：GUIDE=领队, DRIVER=司机, PHOTOGRAPHER=摄影师, ASSISTANT=助理, OTHER=其他
  • 完整字典值: GUIDE=导游, GUIDE_ASSISTANT=导游助理, PHOTOGRAPHER=摄影师, LEADER=领队, OTHER=其他

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId

响应 统一响应结果«团批次详情VO»

字段	类型	必填	说明
code	int		状态码
data	团批次详情VO		响应数据
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
staff	团批次服务人员VO[]		服务人员列表
batchId	string		批次ID
createTime	string		创建时间
id	string		记录ID
productId	string		产品ID
remark	string		备注
sortOrder	int		排序
staffId	string		服务人员ID
staffName	string		姓名
staffPhone	string		手机号
staffRole	string		角色: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
subBatches	团批次VO[]		子批次列表(树形)
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
subBatches	团批次VO[]		子批次列表(树形)
updateTime	string		更新时间
updateTime	string		更新时间
message	string		响应消息

---

PUT /admin/product/item/{productId}/batch/{batchId}

更新批次

更新批次基本信息。仅传入需要修改的字段。 已有报名人员的批次修改人数上限时，不能低于已报名人数。

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId

请求体 更新拼团批次请求

字段	类型	必填	说明
batchName	string		批次名称
departureDate	string		出发日期
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大参团人数（不能低于已报名人数）
minParticipants	int		最低成团人数（0=不限制）
remark	string		备注说明
sortOrder	int		排序序号

响应 统一响应结果«团批次VO»

字段	类型	必填	说明
code	int		状态码
data	团批次VO		响应数据
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
subBatches	团批次VO[]		子批次列表(树形)
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
subBatches	团批次VO[]		子批次列表(树形)
updateTime	string		更新时间
updateTime	string		更新时间
message	string		响应消息

---

DELETE /admin/product/item/{productId}/batch/{batchId}

删除批次

删除批次（软删除）。 限制：已有报名人员的批次不能直接删除，需先解散批次。

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId

响应 统一响应结果«Void»

---

PUT /admin/product/item/{productId}/batch/{batchId}/close

关闭报名(ENROLLING/CONFIRMED->CLOSED)

关闭批次报名，不再接受新的报名。 已报名的订单不受影响，仅阻止新增报名。 适用于报名截止日期到达或手动提前关闭的场景。

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId

响应 统一响应结果«Void»

---

POST /admin/product/item/{productId}/batch/{batchId}/disband

解散批次

解散批次并处理已报名的订单。

重要：解散操作会触发以下流程：

1. 批次状态变更为 DISBANDED
2. 通过 MQ 消息通知订单服务，自动取消该批次下的所有未完成订单
3. 已支付订单会触发退款流程

必须填写解散原因（如：报名人数不足、行程调整等）。

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId

请求体 解散批次请求

字段	类型	必填	说明
reason	string	是	解散原因（如：报名人数不足、行程调整等）

响应 统一响应结果«Void»

---

PUT /admin/product/item/{productId}/batch/{batchId}/open

开启报名(PENDING->ENROLLING)

将批次从 PENDING 状态变更为 ENROLLING（报名中）。 开启后用户可在小程序端看到该团期并报名。 前提条件：产品必须已上架（PUBLISHED）。

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId

响应 统一响应结果«Void»

---

GET /admin/product/item/{productId}/batch/{batchId}/staff

服务人员列表

关联字典：

• staff_type（人员类型）：GUIDE=领队, DRIVER=司机, PHOTOGRAPHER=摄影师, ASSISTANT=助理, OTHER=其他
  • 完整字典值: GUIDE=导游, GUIDE_ASSISTANT=导游助理, PHOTOGRAPHER=摄影师, LEADER=领队, OTHER=其他

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId

响应 统一响应结果«List«团批次服务人员VO»»

字段	类型	必填	说明
code	int		状态码
data	团批次服务人员VO[]		响应数据
batchId	string		批次ID
createTime	string		创建时间
id	string		记录ID
productId	string		产品ID
remark	string		备注
sortOrder	int		排序
staffId	string		服务人员ID
staffName	string		姓名
staffPhone	string		手机号
staffRole	string		角色: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
message	string		响应消息

---

POST /admin/product/item/{productId}/batch/{batchId}/staff

保存服务人员(全量替换)

保存批次的服务人员配置，采用全量替换模式（先删后增）。

每次提交完整的人员列表，替换掉该批次原有的所有人员配置。 人员来源于资源服务的人员库，通过 staffId 关联。 角色类型：LEADER(领队)/PHOTOGRAPHER(摄影师)/DRIVER(司机)/OTHER(其他)

关联字典：

• staff_type（人员类型）：GUIDE=领队, DRIVER=司机, PHOTOGRAPHER=摄影师, ASSISTANT=助理, OTHER=其他
  • 完整字典值: GUIDE=导游, GUIDE_ASSISTANT=导游助理, PHOTOGRAPHER=摄影师, LEADER=领队, OTHER=其他

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId

请求体 批次服务人员分配请求[]

响应 统一响应结果«List«团批次服务人员VO»»

字段	类型	必填	说明
code	int		状态码
data	团批次服务人员VO[]		响应数据
batchId	string		批次ID
createTime	string		创建时间
id	string		记录ID
productId	string		产品ID
remark	string		备注
sortOrder	int		排序
staffId	string		服务人员ID
staffName	string		姓名
staffPhone	string		手机号
staffRole	string		角色: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
message	string		响应消息

---

POST /admin/product/item/{productId}/batch/{batchId}/staff/copy-from/{sourceId}

从其他批次复制服务人员

将源批次的服务人员配置复制到当前批次（全量替换当前批次已有人员）。 适用场景：多个团期使用相同的服务人员班底。

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId
sourceId	integer	是	sourceId

响应 统一响应结果«List«团批次服务人员VO»»

字段	类型	必填	说明
code	int		状态码
data	团批次服务人员VO[]		响应数据
batchId	string		批次ID
createTime	string		创建时间
id	string		记录ID
productId	string		产品ID
remark	string		备注
sortOrder	int		排序
staffId	string		服务人员ID
staffName	string		姓名
staffPhone	string		手机号
staffRole	string		角色: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
message	string		响应消息

---

POST /admin/product/item/{productId}/batch/{batchId}/sub-batch

创建子批次(溢出)

当主批次人数满员时，创建子批次接收溢出报名。

子批次共享主批次的出发日期和行程，但有独立的人数上限和报名人数。 适用场景：某团期特别火爆，需要扩容但希望分开管理。 子批次在列表中显示为主批次的子级节点。

路径参数

参数	类型	必填	说明
batchId	integer	是	batchId
productId	integer	是	productId

请求体 创建拼团批次请求

字段	类型	必填	说明
batchName	string	是	批次名称
departureDate	string	是	出发日期
enrollmentDeadline	string	是	报名截止日期，必须早于出发日期
maxParticipants	int	是	最大参团人数（报名人数达到上限后自动关闭报名）
minParticipants	int		最低成团人数（0=不限制，达到此人数自动变为CONFIRMED状态）
remark	string		备注说明
sortOrder	int		排序序号（越小越靠前）

响应 统一响应结果«团批次VO»

字段	类型	必填	说明
code	int		状态码
data	团批次VO		响应数据
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
subBatches	团批次VO[]		子批次列表(树形)
batchId	string		批次ID
batchLabel	string		批次标签(简称)
batchName	string		批次名称
batchNo	string		批次编号
batchStatus	string		批次状态: PENDING/ENROLLING/CONFIRMED/FULL/CLOSED/IN_PROGRESS/FINISHED/DISBANDED
createBy	string		创建人ID
createTime	string		创建时间
departureDate	string		出发日期
endDate	string		结束日期
enrolledCount	int		已报名人数
enrollmentDeadline	string		报名截止日期
maxParticipants	int		最大人数
minParticipants	int		最少成团人数
parentBatchId	string		父批次ID(子批次时有值)
productId	string		产品ID
remainingSlots	int		剩余名额
remark	string		备注
sortOrder	int		排序
subBatches	团批次VO[]		子批次列表(树形)
updateTime	string		更新时间
updateTime	string		更新时间
message	string		响应消息

---

行政区划搜索

GET /admin/product/district/search

搜索行政区划（城市/区县）

通过高德地图 API 搜索行政区划，用于产品的出发城市和目的地城市选择。 输入关键词（如"丽江"、"昆明"），返回匹配的城市/区县列表，包含行政区划编码。

关联字典：

• cities（城市）：搜索结果可用于产品行程中的城市预览
  • 完整字典值: hailar=海拉尔, manzhouli=满洲里, eergu=额尔古纳, genhe=根河, yakeshi=牙克石, zhalantun=扎兰屯, aershan=阿尔山, shiwei=室韦, enhe=恩和, heishantou=黑山头, chenbaerhu=陈巴尔虎旗, xinbaerhuzuo=新巴尔虎左旗, xinbaerhuyou=新巴尔虎右旗, ewenke=鄂温克旗, moerdaoga=莫尔道嘎
• city（城市筛选）：搜索结果可用于资源面板城市筛选
  • 完整字典值: hailar=海拉尔, manzhouli=满洲里, eergu=额尔古纳, genhe=根河, aershan=阿尔山, shiwei=室韦, enhe=恩和, heishantou=黑山头

查询参数

参数	类型	必填	说明	示例
keywords	string		搜索关键词

响应 统一响应结果«List«行政区划搜索结果»»

字段	类型	必填	说明
code	int		状态码
data	行政区划搜索结果[]		响应数据
adcode	string		行政区编码
level	string		级别: city/district
levelName	string		级别中文名
name	string		行政区名称
message	string		响应消息

---

行程管理

PUT /admin/product/dining/{id}

更新餐饮推荐

更新餐饮推荐的餐厅、用餐类型（早/午/晚）、描述等信息。

路径参数

参数	类型	必填	说明
id	integer		餐饮推荐ID

请求体 用餐选项请求

字段	类型	必填	说明
coverUrl	string		餐食封面图URL
mealTypes	string		餐次：早餐/午餐/晚餐
priceInfo	string		价格信息
quantity	int		数量
restaurantId	string		餐厅ID（GROUP产品可不传）
restaurantName	string		餐厅/餐食名称
sortOrder	int		排序序号
unitPrice	number		餐食单价(元，GROUP产品用于成本计算)

响应 统一响应结果«用餐选项VO»

字段	类型	必填	说明
code	int		状态码
data	用餐选项VO		响应数据
coverUrl	string		餐食封面图URL
dayNumber	int		天数编号
id	string		记录ID
mealTypes	string		餐次：早餐/午餐/晚餐
priceInfo	string		价格信息
quantity	int		数量
restaurantId	string		餐厅ID
restaurantName	string		餐厅/餐食名称
sortOrder	int		排序序号
unitPrice	number		餐食单价(元)
message	string		响应消息

---

DELETE /admin/product/dining/{id}

删除餐饮推荐

删除指定的餐饮推荐记录。

路径参数

参数	类型	必填	说明
id	integer		餐饮推荐ID

响应 统一响应结果«Void»

---

PUT /admin/product/hotel/{id}

更新每日住宿

更新住宿记录的酒店、房型、数量等信息。

路径参数

参数	类型	必填	说明
id	integer		住宿记录ID

请求体 每日酒店配置请求

字段	类型	必填	说明
coverUrl	string		封面图URL
familyIds	string[]		所属家庭ID列表（定制产品，不传=所有家庭共享）
familyRoomConfig	object		家庭房间分配（定制产品）：{familyId: roomCount}，如 {"123": 2, "456": 1}
hotelId	string	是	酒店ID
hotelName	string		酒店名称
isDefault	boolean		是否默认酒店
roomCount	int		房间数量
roomTypeId	string		关联房型ID（定制产品必填，核心产品为空）
roomTypeName	string		房型名称
sortOrder	int		排序序号

响应 统一响应结果«每日酒店VO»

字段	类型	必填	说明
code	int		状态码
data	每日酒店VO		响应数据
coverUrl	string		封面图URL
dayNumber	int		天数编号
familyIds	string[]		所属家庭ID列表（NULL=所有家庭共享）
familyRoomConfig	object		家庭房间分配：{familyId: roomCount}
hotelId	string		酒店ID
hotelName	string		酒店名称
id	string		记录ID
isDefault	boolean		是否默认酒店
roomCount	int		房间数量
roomTypeId	string		房型ID
roomTypeName	string		房型名称
sortOrder	int		排序序号
message	string		响应消息

---

DELETE /admin/product/hotel/{id}

删除每日住宿

删除指定住宿记录。删除后该天的住宿成本会从报价中移除。

路径参数

参数	类型	必填	说明
id	integer		住宿记录ID

响应 统一响应结果«Void»

---

PUT /admin/product/item/{productId}/day/{dayNumber}

更新行程天

更新指定天的行程信息，如当天主题、概述等。 行程天在创建产品时根据 tripDays 自动生成，不支持单独增删，只能更新。 dayNumber 从 1 开始，对应第几天的行程。

路径参数

参数	类型	必填	说明
dayNumber	integer		天数编号
productId	integer		产品ID

请求体 行程天请求

字段	类型	必填	说明
dayTitle	string		天标题
routeSummary	string		路线概览

响应 统一响应结果«行程天VO»

字段	类型	必填	说明
code	int		状态码
data	行程天VO		响应数据
dayId	string		行程天ID
dayNumber	int		天数编号
dayTitle	string		天标题
hotels	每日酒店VO[]		当日酒店列表
coverUrl	string		封面图URL
dayNumber	int		天数编号
familyIds	string[]		所属家庭ID列表（NULL=所有家庭共享）
familyRoomConfig	object		家庭房间分配：{familyId: roomCount}
hotelId	string		酒店ID
hotelName	string		酒店名称
id	string		记录ID
isDefault	boolean		是否默认酒店
roomCount	int		房间数量
roomTypeId	string		房型ID
roomTypeName	string		房型名称
sortOrder	int		排序序号
nodes	行程节点VO[]		行程节点列表
costPrice	number		资源成本价（来自资源价格日历）
dayId	string		所属行程天ID
description	string		节点描述
distanceKm	number		距离（公里）
durationMinutes	int		时长（分钟）
emojiIcon	string		表情图标
extraData	string		扩展数据（JSON格式）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
images	string[]		节点图片列表
latitude	number		纬度
longitude	number		经度
nodeId	string		节点ID
nodeName	string		节点名称
nodeType	string		节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE
quantity	int		数量
resourceDetail	资源详情		绑定资源的详细信息（含图片、地址等）
resourceId	string		关联资源ID
resourceName	string		关联资源名称
resourceType	string		关联资源类型：SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE
sortOrder	int		排序序号
startTime	string		开始时间
restaurants	用餐选项VO[]		当日用餐列表
coverUrl	string		餐食封面图URL
dayNumber	int		天数编号
id	string		记录ID
mealTypes	string		餐次：早餐/午餐/晚餐
priceInfo	string		价格信息
quantity	int		数量
restaurantId	string		餐厅ID
restaurantName	string		餐厅/餐食名称
sortOrder	int		排序序号
unitPrice	number		餐食单价(元)
routeSummary	string		路线概览
message	string		响应消息

---

GET /admin/product/item/{productId}/day/{dayNumber}/dining

获取某天的餐厅推荐列表

获取指定天的所有餐饮推荐，包含餐厅名称、用餐类型、描述等信息。

路径参数

参数	类型	必填	说明
dayNumber	integer		天数编号
productId	integer		产品ID

响应 统一响应结果«List«用餐选项VO»»

字段	类型	必填	说明
code	int		状态码
data	用餐选项VO[]		响应数据
coverUrl	string		餐食封面图URL
dayNumber	int		天数编号
id	string		记录ID
mealTypes	string		餐次：早餐/午餐/晚餐
priceInfo	string		价格信息
quantity	int		数量
restaurantId	string		餐厅ID
restaurantName	string		餐厅/餐食名称
sortOrder	int		排序序号
unitPrice	number		餐食单价(元)
message	string		响应消息

---

POST /admin/product/item/{productId}/day/{dayNumber}/dining

添加每日餐厅推荐

为指定天添加餐饮推荐，关联资源服务中的餐厅。 用于展示当天的用餐安排，可按早/午/晚分类。

路径参数

参数	类型	必填	说明
dayNumber	integer		天数编号
productId	integer		产品ID

请求体 用餐选项请求

字段	类型	必填	说明
coverUrl	string		餐食封面图URL
mealTypes	string		餐次：早餐/午餐/晚餐
priceInfo	string		价格信息
quantity	int		数量
restaurantId	string		餐厅ID（GROUP产品可不传）
restaurantName	string		餐厅/餐食名称
sortOrder	int		排序序号
unitPrice	number		餐食单价(元，GROUP产品用于成本计算)

响应 统一响应结果«用餐选项VO»

字段	类型	必填	说明
code	int		状态码
data	用餐选项VO		响应数据
coverUrl	string		餐食封面图URL
dayNumber	int		天数编号
id	string		记录ID
mealTypes	string		餐次：早餐/午餐/晚餐
priceInfo	string		价格信息
quantity	int		数量
restaurantId	string		餐厅ID
restaurantName	string		餐厅/餐食名称
sortOrder	int		排序序号
unitPrice	number		餐食单价(元)
message	string		响应消息

---

POST /admin/product/item/{productId}/day/{dayNumber}/hotel

添加每日住宿

为指定天添加住宿安排，关联资源服务中的酒店和房型。 每天可以有多个住宿选项（如不同档次），参与成本自动计算。 住宿费用会体现在价格日历的成本计算中。

路径参数

参数	类型	必填	说明
dayNumber	integer		天数编号
productId	integer		产品ID

请求体 每日酒店配置请求

字段	类型	必填	说明
coverUrl	string		封面图URL
familyIds	string[]		所属家庭ID列表（定制产品，不传=所有家庭共享）
familyRoomConfig	object		家庭房间分配（定制产品）：{familyId: roomCount}，如 {"123": 2, "456": 1}
hotelId	string	是	酒店ID
hotelName	string		酒店名称
isDefault	boolean		是否默认酒店
roomCount	int		房间数量
roomTypeId	string		关联房型ID（定制产品必填，核心产品为空）
roomTypeName	string		房型名称
sortOrder	int		排序序号

响应 统一响应结果«每日酒店VO»

字段	类型	必填	说明
code	int		状态码
data	每日酒店VO		响应数据
coverUrl	string		封面图URL
dayNumber	int		天数编号
familyIds	string[]		所属家庭ID列表（NULL=所有家庭共享）
familyRoomConfig	object		家庭房间分配：{familyId: roomCount}
hotelId	string		酒店ID
hotelName	string		酒店名称
id	string		记录ID
isDefault	boolean		是否默认酒店
roomCount	int		房间数量
roomTypeId	string		房型ID
roomTypeName	string		房型名称
sortOrder	int		排序序号
message	string		响应消息

---

GET /admin/product/item/{productId}/day/{dayNumber}/hotels

获取某天的住宿列表

获取指定天的所有住宿安排，包含酒店名称、房型、数量等信息。

路径参数

参数	类型	必填	说明
dayNumber	integer		天数编号
productId	integer		产品ID

响应 统一响应结果«List«每日酒店VO»»

字段	类型	必填	说明
code	int		状态码
data	每日酒店VO[]		响应数据
coverUrl	string		封面图URL
dayNumber	int		天数编号
familyIds	string[]		所属家庭ID列表（NULL=所有家庭共享）
familyRoomConfig	object		家庭房间分配：{familyId: roomCount}
hotelId	string		酒店ID
hotelName	string		酒店名称
id	string		记录ID
isDefault	boolean		是否默认酒店
roomCount	int		房间数量
roomTypeId	string		房型ID
roomTypeName	string		房型名称
sortOrder	int		排序序号
message	string		响应消息

---

POST /admin/product/item/{productId}/day/{dayNumber}/node

添加行程节点

在指定天添加一个行程节点。节点是行程的最小单元，可关联资源服务中的景区、酒店、活动等。

节点类型：TRANSPORT(交通)/SCENIC(景区)/DINING(餐饮)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)

CUSTOM 定制产品特有：可通过 familyIds 指定节点所属的家庭分组，实现按家庭分配行程。 新建节点自动追加到当天最后位置，可通过排序接口调整顺序。

关联字典：

• city（城市，资源面板筛选用）：用于在添加节点时按城市筛选可选资源
  • 完整字典值: hailar=海拉尔, manzhouli=满洲里, eergu=额尔古纳, genhe=根河, aershan=阿尔山, shiwei=室韦, enhe=恩和, heishantou=黑山头

路径参数

参数	类型	必填	说明
dayNumber	integer		天数编号
productId	integer		产品ID

请求体 创建行程节点请求

字段	类型	必填	说明
description	string		节点描述
distanceKm	number		距离（公里）
durationMinutes	int		时长（分钟）
emojiIcon	string		表情图标
extraData	string		扩展数据（JSON格式）
familyIds	string[]		所属家庭ID列表（仅CUSTOM定制产品使用，实现按家庭分配行程节点）
images	string[]		节点图片列表
latitude	number		纬度
longitude	number		经度
nodeName	string	是	节点名称
nodeType	string	是	节点类型：TRANSPORT(交通)/SCENIC(景区)/DINING(餐饮)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)
quantity	int		数量
resourceId	string		关联资源ID（来自资源服务，关联后节点名称和图片可自动同步）
resourceType	string		关联资源类型（关联后可从资源服务获取价格参与成本计算）：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE
startTime	string		开始时间

响应 统一响应结果«行程节点VO»

字段	类型	必填	说明
code	int		状态码
data	行程节点VO		响应数据
costPrice	number		资源成本价（来自资源价格日历）
dayId	string		所属行程天ID
description	string		节点描述
distanceKm	number		距离（公里）
durationMinutes	int		时长（分钟）
emojiIcon	string		表情图标
extraData	string		扩展数据（JSON格式）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
images	string[]		节点图片列表
latitude	number		纬度
longitude	number		经度
nodeId	string		节点ID
nodeName	string		节点名称
nodeType	string		节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE
quantity	int		数量
resourceDetail	资源详情		绑定资源的详细信息（含图片、地址等）
address	string		地址
city	string		所在城市
cover	string		封面图URL
description	string		简介/描述
featureIntro	string		图文详情（featureIntro JSON）
images	string[]		图片URL列表（轮播图）
latitude	number		纬度
longitude	number		经度
name	string		资源名称
rating	number		评分
resourceId	string		资源ID
resourceType	string		资源类型: SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY
subtitle	string		副标题
tags	string[]		标签列表
resourceId	string		关联资源ID
resourceName	string		关联资源名称
resourceType	string		关联资源类型：SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE
sortOrder	int		排序序号
startTime	string		开始时间
message	string		响应消息

---

GET /admin/product/item/{productId}/day/{dayNumber}/nodes

获取某天的节点列表

获取指定天的所有行程节点，按排序顺序返回。 每个节点包含类型、名称、时间、关联资源信息、图片等完整数据。

关联字典：

• city（城市）：资源面板城市筛选
  • 完整字典值: hailar=海拉尔, manzhouli=满洲里, eergu=额尔古纳, genhe=根河, aershan=阿尔山, shiwei=室韦, enhe=恩和, heishantou=黑山头
• cities（城市ID映射）：城市名称预览
  • 完整字典值: hailar=海拉尔, manzhouli=满洲里, eergu=额尔古纳, genhe=根河, yakeshi=牙克石, zhalantun=扎兰屯, aershan=阿尔山, shiwei=室韦, enhe=恩和, heishantou=黑山头, chenbaerhu=陈巴尔虎旗, xinbaerhuzuo=新巴尔虎左旗, xinbaerhuyou=新巴尔虎右旗, ewenke=鄂温克旗, moerdaoga=莫尔道嘎

路径参数

参数	类型	必填	说明
dayNumber	integer		天数编号
productId	integer		产品ID

响应 统一响应结果«List«行程节点VO»»

字段	类型	必填	说明
code	int		状态码
data	行程节点VO[]		响应数据
costPrice	number		资源成本价（来自资源价格日历）
dayId	string		所属行程天ID
description	string		节点描述
distanceKm	number		距离（公里）
durationMinutes	int		时长（分钟）
emojiIcon	string		表情图标
extraData	string		扩展数据（JSON格式）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
images	string[]		节点图片列表
latitude	number		纬度
longitude	number		经度
nodeId	string		节点ID
nodeName	string		节点名称
nodeType	string		节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE
quantity	int		数量
resourceDetail	资源详情		绑定资源的详细信息（含图片、地址等）
address	string		地址
city	string		所在城市
cover	string		封面图URL
description	string		简介/描述
featureIntro	string		图文详情（featureIntro JSON）
images	string[]		图片URL列表（轮播图）
latitude	number		纬度
longitude	number		经度
name	string		资源名称
rating	number		评分
resourceId	string		资源ID
resourceType	string		资源类型: SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY
subtitle	string		副标题
tags	string[]		标签列表
resourceId	string		关联资源ID
resourceName	string		关联资源名称
resourceType	string		关联资源类型：SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE
sortOrder	int		排序序号
startTime	string		开始时间
message	string		响应消息

---

PUT /admin/product/item/{productId}/day/{dayNumber}/nodes/sort

行程节点拖拽排序

重新排列指定天的所有行程节点顺序。前端拖拽排序后，将新的节点ID顺序全量提交。 nodeIds 列表中的顺序即为新的排序顺序（从上到下）。

路径参数

参数	类型	必填	说明
dayNumber	integer		天数编号
productId	integer		产品ID

请求体 节点排序请求

字段	类型	必填	说明
nodeIds	string[]	是	节点ID有序列表，按期望排序顺序排列

响应 统一响应结果«Void»

---

GET /admin/product/item/{productId}/days

获取行程天列表

获取产品所有行程天的信息，按 dayNumber 升序排列。 每一天包含当天主题、概述等信息，不包含节点详情（节点通过单独接口获取）。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«List«行程天VO»»

字段	类型	必填	说明
code	int		状态码
data	行程天VO[]		响应数据
dayId	string		行程天ID
dayNumber	int		天数编号
dayTitle	string		天标题
hotels	每日酒店VO[]		当日酒店列表
coverUrl	string		封面图URL
dayNumber	int		天数编号
familyIds	string[]		所属家庭ID列表（NULL=所有家庭共享）
familyRoomConfig	object		家庭房间分配：{familyId: roomCount}
hotelId	string		酒店ID
hotelName	string		酒店名称
id	string		记录ID
isDefault	boolean		是否默认酒店
roomCount	int		房间数量
roomTypeId	string		房型ID
roomTypeName	string		房型名称
sortOrder	int		排序序号
nodes	行程节点VO[]		行程节点列表
costPrice	number		资源成本价（来自资源价格日历）
dayId	string		所属行程天ID
description	string		节点描述
distanceKm	number		距离（公里）
durationMinutes	int		时长（分钟）
emojiIcon	string		表情图标
extraData	string		扩展数据（JSON格式）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
images	string[]		节点图片列表
latitude	number		纬度
longitude	number		经度
nodeId	string		节点ID
nodeName	string		节点名称
nodeType	string		节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE
quantity	int		数量
resourceDetail	资源详情		绑定资源的详细信息（含图片、地址等）
resourceId	string		关联资源ID
resourceName	string		关联资源名称
resourceType	string		关联资源类型：SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE
sortOrder	int		排序序号
startTime	string		开始时间
restaurants	用餐选项VO[]		当日用餐列表
coverUrl	string		餐食封面图URL
dayNumber	int		天数编号
id	string		记录ID
mealTypes	string		餐次：早餐/午餐/晚餐
priceInfo	string		价格信息
quantity	int		数量
restaurantId	string		餐厅ID
restaurantName	string		餐厅/餐食名称
sortOrder	int		排序序号
unitPrice	number		餐食单价(元)
routeSummary	string		路线概览
message	string		响应消息

---

POST /admin/product/item/{productId}/staff-config

添加人员配置

为产品添加服务人员配置（如领队、摄影师、司机等），关联资源服务中的人员。 人员配置是产品级别的模板，GROUP 产品的实际人员在团期批次中单独分配。 人员费用参与成本自动计算。

关联字典：

• staff_type（人员类型）：GUIDE=领队, DRIVER=司机, PHOTOGRAPHER=摄影师, ASSISTANT=助理, OTHER=其他
  • 完整字典值: GUIDE=导游, GUIDE_ASSISTANT=导游助理, PHOTOGRAPHER=摄影师, LEADER=领队, OTHER=其他

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 人员配置请求

字段	类型	必填	说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
quantity	int	是	数量
sortOrder	int		排序序号
staffType	string	是	人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER

响应 统一响应结果«产品人员配置VO»

字段	类型	必填	说明
code	int		状态码
data	产品人员配置VO		响应数据
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
staffType	string		人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
staffTypeName	string		人员类型名称
message	string		响应消息

---

GET /admin/product/item/{productId}/staff-configs

获取产品人员配置列表

关联字典：

• staff_type（人员类型）：GUIDE=领队, DRIVER=司机, PHOTOGRAPHER=摄影师, ASSISTANT=助理, OTHER=其他
  • 完整字典值: GUIDE=导游, GUIDE_ASSISTANT=导游助理, PHOTOGRAPHER=摄影师, LEADER=领队, OTHER=其他

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«List«产品人员配置VO»»

字段	类型	必填	说明
code	int		状态码
data	产品人员配置VO[]		响应数据
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
staffType	string		人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
staffTypeName	string		人员类型名称
message	string		响应消息

---

GET /admin/product/item/{productId}/supplies

获取产品物资列表

获取产品关联的所有物资配品，包含物资名称、数量、单价等信息。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

响应 统一响应结果«List«产品物资VO»»

字段	类型	必填	说明
code	int		状态码
data	产品物资VO[]		响应数据
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string		物资ID
suppliesName	string		物资名称
message	string		响应消息

---

POST /admin/product/item/{productId}/supplies

添加物资配品

为产品添加物资配品（如帐篷、睡袋、登山杖等），关联资源服务中的物资。 物资配品是产品级别的，不区分具体哪一天，参与成本计算。

路径参数

参数	类型	必填	说明
productId	integer		产品ID

请求体 物资配置请求

字段	类型	必填	说明
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string	是	物资ID
suppliesName	string		物资名称

响应 统一响应结果«产品物资VO»

字段	类型	必填	说明
code	int		状态码
data	产品物资VO		响应数据
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string		物资ID
suppliesName	string		物资名称
message	string		响应消息

---

PUT /admin/product/node/{nodeId}

更新行程节点

更新行程节点信息，仅传入需要修改的字段。 可修改节点名称、时间、关联资源、图片、描述等。

关联字典：

• city（城市）：资源面板城市筛选
  • 完整字典值: hailar=海拉尔, manzhouli=满洲里, eergu=额尔古纳, genhe=根河, aershan=阿尔山, shiwei=室韦, enhe=恩和, heishantou=黑山头
• cities（城市ID映射）：城市名称预览
  • 完整字典值: hailar=海拉尔, manzhouli=满洲里, eergu=额尔古纳, genhe=根河, yakeshi=牙克石, zhalantun=扎兰屯, aershan=阿尔山, shiwei=室韦, enhe=恩和, heishantou=黑山头, chenbaerhu=陈巴尔虎旗, xinbaerhuzuo=新巴尔虎左旗, xinbaerhuyou=新巴尔虎右旗, ewenke=鄂温克旗, moerdaoga=莫尔道嘎

路径参数

参数	类型	必填	说明
nodeId	integer		行程节点ID

请求体 更新行程节点请求

字段	类型	必填	说明
description	string		节点描述
distanceKm	number		距离（公里）
durationMinutes	int		时长（分钟）
emojiIcon	string		表情图标
extraData	string		扩展数据（JSON格式）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
images	string[]		节点图片列表
latitude	number		纬度
longitude	number		经度
nodeName	string		节点名称
nodeType	string		节点类型：TRANSPORT(交通)/SCENIC(景区)/DINING(餐饮)/ACTIVITY(活动)/PHOTOGRAPHY(摄影)/HOTEL(酒店)/FREE(自由活动)/CUSTOM(自定义)
quantity	int		数量
resourceId	string		关联资源ID
resourceType	string		关联资源类型：SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE
startTime	string		开始时间

响应 统一响应结果«行程节点VO»

字段	类型	必填	说明
code	int		状态码
data	行程节点VO		响应数据
costPrice	number		资源成本价（来自资源价格日历）
dayId	string		所属行程天ID
description	string		节点描述
distanceKm	number		距离（公里）
durationMinutes	int		时长（分钟）
emojiIcon	string		表情图标
extraData	string		扩展数据（JSON格式）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
images	string[]		节点图片列表
latitude	number		纬度
longitude	number		经度
nodeId	string		节点ID
nodeName	string		节点名称
nodeType	string		节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE
quantity	int		数量
resourceDetail	资源详情		绑定资源的详细信息（含图片、地址等）
address	string		地址
city	string		所在城市
cover	string		封面图URL
description	string		简介/描述
featureIntro	string		图文详情（featureIntro JSON）
images	string[]		图片URL列表（轮播图）
latitude	number		纬度
longitude	number		经度
name	string		资源名称
rating	number		评分
resourceId	string		资源ID
resourceType	string		资源类型: SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY
subtitle	string		副标题
tags	string[]		标签列表
resourceId	string		关联资源ID
resourceName	string		关联资源名称
resourceType	string		关联资源类型：SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE
sortOrder	int		排序序号
startTime	string		开始时间
message	string		响应消息

---

DELETE /admin/product/node/{nodeId}

删除行程节点

删除指定行程节点，同天其他节点的排序自动调整。

路径参数

参数	类型	必填	说明
nodeId	integer		行程节点ID

响应 统一响应结果«Void»

---

POST /admin/product/node/{nodeId}/copy

复制行程节点

复制指定节点到同一天的末尾位置，包括节点的所有属性（名称、资源关联、图片等）。 适用场景：同一天有相似的行程安排时快速复制。

路径参数

参数	类型	必填	说明
nodeId	integer		行程节点ID

响应 统一响应结果«行程节点VO»

字段	类型	必填	说明
code	int		状态码
data	行程节点VO		响应数据
costPrice	number		资源成本价（来自资源价格日历）
dayId	string		所属行程天ID
description	string		节点描述
distanceKm	number		距离（公里）
durationMinutes	int		时长（分钟）
emojiIcon	string		表情图标
extraData	string		扩展数据（JSON格式）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
images	string[]		节点图片列表
latitude	number		纬度
longitude	number		经度
nodeId	string		节点ID
nodeName	string		节点名称
nodeType	string		节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE
quantity	int		数量
resourceDetail	资源详情		绑定资源的详细信息（含图片、地址等）
address	string		地址
city	string		所在城市
cover	string		封面图URL
description	string		简介/描述
featureIntro	string		图文详情（featureIntro JSON）
images	string[]		图片URL列表（轮播图）
latitude	number		纬度
longitude	number		经度
name	string		资源名称
rating	number		评分
resourceId	string		资源ID
resourceType	string		资源类型: SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY
subtitle	string		副标题
tags	string[]		标签列表
resourceId	string		关联资源ID
resourceName	string		关联资源名称
resourceType	string		关联资源类型：SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE
sortOrder	int		排序序号
startTime	string		开始时间
message	string		响应消息

---

PUT /admin/product/node/{nodeId}/move

移动行程节点到其他天

将节点从当前天移动到目标天的末尾位置。 移动后原天和目标天的节点排序自动调整。

路径参数

参数	类型	必填	说明
nodeId	integer		行程节点ID

请求体 节点移动请求

字段	类型	必填	说明
targetDayNumber	int	是	目标天数编号

响应 统一响应结果«行程节点VO»

字段	类型	必填	说明
code	int		状态码
data	行程节点VO		响应数据
costPrice	number		资源成本价（来自资源价格日历）
dayId	string		所属行程天ID
description	string		节点描述
distanceKm	number		距离（公里）
durationMinutes	int		时长（分钟）
emojiIcon	string		表情图标
extraData	string		扩展数据（JSON格式）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
images	string[]		节点图片列表
latitude	number		纬度
longitude	number		经度
nodeId	string		节点ID
nodeName	string		节点名称
nodeType	string		节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE
quantity	int		数量
resourceDetail	资源详情		绑定资源的详细信息（含图片、地址等）
address	string		地址
city	string		所在城市
cover	string		封面图URL
description	string		简介/描述
featureIntro	string		图文详情（featureIntro JSON）
images	string[]		图片URL列表（轮播图）
latitude	number		纬度
longitude	number		经度
name	string		资源名称
rating	number		评分
resourceId	string		资源ID
resourceType	string		资源类型: SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY
subtitle	string		副标题
tags	string[]		标签列表
resourceId	string		关联资源ID
resourceName	string		关联资源名称
resourceType	string		关联资源类型：SCENIC_SPOT/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE
sortOrder	int		排序序号
startTime	string		开始时间
message	string		响应消息

---

PUT /admin/product/staff-config/{id}

更新人员配置

关联字典：

• staff_type（人员类型）：GUIDE=领队, DRIVER=司机, PHOTOGRAPHER=摄影师, ASSISTANT=助理, OTHER=其他
  • 完整字典值: GUIDE=导游, GUIDE_ASSISTANT=导游助理, PHOTOGRAPHER=摄影师, LEADER=领队, OTHER=其他

路径参数

参数	类型	必填	说明
id	integer		人员配置ID

请求体 人员配置请求

字段	类型	必填	说明
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
quantity	int	是	数量
sortOrder	int		排序序号
staffType	string	是	人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER

响应 统一响应结果«产品人员配置VO»

字段	类型	必填	说明
code	int		状态码
data	产品人员配置VO		响应数据
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
sortOrder	int		排序序号
staffType	string		人员类型：GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER
staffTypeName	string		人员类型名称
message	string		响应消息

---

DELETE /admin/product/staff-config/{id}

删除人员配置

删除指定的人员配置记录。删除后该人员费用不再计入成本。

关联字典：

• staff_type（人员类型）：GUIDE=领队, DRIVER=司机, PHOTOGRAPHER=摄影师, ASSISTANT=助理, OTHER=其他
  • 完整字典值: GUIDE=导游, GUIDE_ASSISTANT=导游助理, PHOTOGRAPHER=摄影师, LEADER=领队, OTHER=其他

路径参数

参数	类型	必填	说明
id	integer		人员配置ID

响应 统一响应结果«Void»

---

PUT /admin/product/supplies/{id}

更新物资配品

更新物资配品的关联物资、数量等信息。修改后会影响成本自动计算结果。

路径参数

参数	类型	必填	说明
id	integer		物资配品ID

请求体 物资配置请求

字段	类型	必填	说明
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string	是	物资ID
suppliesName	string		物资名称

响应 统一响应结果«产品物资VO»

字段	类型	必填	说明
code	int		状态码
data	产品物资VO		响应数据
billingType	string		计费方式：BY_PERSON=按人头 BY_COUNT=按次/按件
costPerPerson	number		每人成本
coverUrl	string		封面图URL
dayNumber	int		天数编号（scope=DAY时生效）
familyIds	string[]		所属家庭ID列表（定制产品按家庭分配）
id	string		记录ID
quantity	int		数量
scope	string		适用范围：ALL=整个行程 DAY=指定天
sortOrder	int		排序序号
suppliesId	string		物资ID
suppliesName	string		物资名称
message	string		响应消息

---

DELETE /admin/product/supplies/{id}

删除物资配品

删除指定的物资配品记录。删除后该物资费用不再计入成本。

路径参数

参数	类型	必填	说明
id	integer		物资配品ID

响应 统一响应结果«Void»

---