8.1 KiB
8.1 KiB
接口变更记录 — 2026-03-19 11:11
提交
3f178a2· 作者 wx · 时间 2026-03-19 11:11:36 +0800feat: 小程序新增已完成定制产品查询接口（详情+列表）
变更总览
- 产品服务
- InternalMpProduct (+2)
- 小程序聚合服务
- MpCustomize (+2)
- 订单服务
- InternalCustomize (+1)
产品服务
InternalMpProduct
📖 接口文档: http://192.168.100.236:8085/doc.html → 标签 「【内部接口】小程序产品（Feign调用）」
🆕 GET /internal/mp/product/custom-completed/{productId} — 已完成的定制产品详情
根据产品ID查询已完成（COMPLETED/ORDERED）的定制产品详情。
参数
{productId}(Long) — 路径参数
响应 Result<ProductVO>
| 字段 | 类型 | 说明 |
|---|---|---|
productId |
String |
产品ID |
productNo |
String |
产品编号 |
productType |
String |
产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团 |
name |
String |
产品名称 |
subtitle |
String |
副标题 |
tripDays |
Integer |
行程天数 |
tripNights |
Integer |
行程晚数 |
departureCity |
String |
出发城市 |
destinationCity |
String |
目的地城市 |
destinationCities |
List<String> |
途经城市列表（从行程节点资源去重提取） |
seasons |
List<String> |
适用季节列表(编码) |
seasonLabels |
List<String> |
适用季节列表(中文) |
isBooking |
Boolean |
是否预约产品 |
paymentMode |
String |
支付模式：FULL=全款 DEPOSIT=定金+尾款 |
adultCount |
Integer |
成人人数 |
childCount |
Integer |
儿童人数 |
youngChildCount |
Integer |
小童人数 |
babyCount |
Integer |
婴儿人数 |
minAdultPerOrder |
Integer |
每单最少成人数(null=默认1) |
maxAdultPerOrder |
Integer |
每单最大成人数(null=不限) |
maxChildPerOrder |
Integer |
每单最大儿童数(null=不限) |
routeMapUrl |
String |
路径图URL（后端自动生成） |
status |
String |
产品状态：DRAFT/PENDING_REVIEW/REVIEWED/REJECTED/PUBLISHED/UNPUBLISHED/COMPLETED |
tags |
List<String> |
产品标签列表 |
coverImageUrl |
String |
封面图URL |
carouselImages |
List<String> |
轮播图列表 |
carouselVideoUrl |
String |
轮播视频URL |
folderId |
String |
所属文件夹ID |
lineId |
String |
产品线ID |
lineName |
String |
产品线名称 |
creatorAvatarUrl |
String |
定制师头像URL |
creatorIntro |
String |
创作者寄语 |
groupChatQrUrl |
String |
群聊二维码URL |
chatMessages |
List<ChatMessageVO> |
群聊消息列表 |
showReview |
Boolean |
是否显示评价 |
showChatGroup |
Boolean |
是否显示群聊入口 |
showTripTime |
Boolean |
是否显示行程时间 |
showTripDistance |
Boolean |
是否显示行程距离 |
bookingTermsId |
String |
预订条款ID |
bookingTermsName |
String |
预订条款名称 |
bookingTermsContent |
String |
预订条款内容 |
refundPolicyId |
String |
退款政策ID |
refundPolicyName |
String |
退款政策名称 |
warmTipsId |
String |
温馨提示ID |
warmTipsName |
String |
温馨提示名称 |
warmTipsContent |
String |
温馨提示内容 |
customizerId |
String |
定制师ID |
publishedAt |
LocalDateTime |
发布时间 |
sortOrder |
Integer |
排序序号 |
teamExperienceYears |
Integer |
团队经验年数 |
lineSubtitle |
String |
产品线副标题 |
createBy |
String |
创建人ID |
mchId |
String |
商户号 |
groupRoomId |
String |
企微群聊ID(用于会话存档展示群消息) |
updateBy |
String |
更新人ID |
createTime |
LocalDateTime |
创建时间 |
updateTime |
LocalDateTime |
更新时间 |
startPrice |
BigDecimal |
起步价：未来一年价格日历中最低成人售价 |
itineraryDays |
List<ItineraryDayVO> |
行程天列表 |
pricing |
ProductPricingVO |
定价配置 |
costItems |
List<ProductCostItemVO> |
成本项列表 |
customFees |
List<ProductCustomFeeVO> |
自定义费用项列表 |
suppliesList |
List<ProductSuppliesVO> |
物资列表 |
staffConfigs |
List<ProductStaffConfigVO> |
人员配置列表（定制产品） |
families |
List<ProductFamilyVO> |
家庭分组列表（定制产品） |
benefitsDescription |
List<BenefitGroupVO> |
权益说明（静态，所有产品相同） |
关联字典
product_type（产品类型）：CUSTOM=定制产品product_status（产品状态）：COMPLETED=已完成, ORDERED=已下单
🆕 POST /internal/mp/product/custom-completed/batch — 已完成的定制产品列表
根据产品ID列表批量查询已完成（COMPLETED/ORDERED）的定制产品。
响应 Result<List<MpProductListVO>>
| 字段 | 类型 | 说明 |
|---|---|---|
productId |
String |
产品ID |
productType |
String |
产品类型：CORE=核心产品 ROUTE=线路产品 CUSTOM=定制产品 GROUP=小蒙马拼团 |
name |
String |
产品名称 |
subtitle |
String |
副标题 |
tripDays |
Integer |
行程天数 |
tripNights |
Integer |
行程晚数 |
departureCity |
String |
出发城市 |
destinationCity |
String |
目的地城市 |
tags |
List<String> |
产品标签列表 |
seasons |
List<String> |
适用季节列表(编码) |
seasonLabels |
List<String> |
适用季节列表(中文) |
coverImageUrl |
String |
封面图URL |
lineName |
String |
产品线名称 |
startPrice |
BigDecimal |
起步价（来自定价配置） |
paymentMode |
String |
支付模式：FULL=全款 DEPOSIT=定金+尾款 |
routeMapUrl |
String |
路径图URL |
creatorAvatarUrl |
String |
定制师头像URL |
关联字典
product_type（产品类型）：CUSTOM=定制产品product_status（产品状态）：COMPLETED=已完成, ORDERED=已下单
小程序聚合服务
MpCustomize
📖 接口文档: http://192.168.100.236:8086/doc.html → 标签 「C端 - 定制需求接口」
🆕 GET /mp/custom/product/{productId} — 查询已完成的定制产品详情
根据产品ID查询已完成（COMPLETED/ORDERED）的定制产品详情。
参数
{productId}(Long) — 路径参数：定制产品ID
响应 Result<Map<String, Object>>
🆕 GET /mp/custom/products — 我的已完成定制产品列表
查询当前用户所有已完成的定制产品列表。
响应 Result<List<Map<String, Object>>>
订单服务
InternalCustomize
📖 接口文档: http://192.168.100.236:8084/doc.html → 标签 「【内部接口】小程序定制请求（Feign调用）」
🆕 GET /internal/mp/customize/completed-product-ids — 用户已完成定制需求的产品ID列表
返回用户定制需求中已关联产品的productId列表（状态QUOTED/COMPLETED）。
参数
userId(Long) — 查询参数：用户ID
响应 Result<List<Long>>
📁 全部变更文件 (点击展开)
M hl-mp-service/src/main/java/com/hulalv/mp/controller/MpCustomizeController.java
M hl-mp-service/src/main/java/com/hulalv/mp/feign/MpOrderFeignClient.java
M hl-mp-service/src/main/java/com/hulalv/mp/feign/MpOrderFeignFallbackFactory.java
M hl-mp-service/src/main/java/com/hulalv/mp/feign/MpProductFeignClient.java
M hl-mp-service/src/main/java/com/hulalv/mp/feign/MpProductFeignFallbackFactory.java
M hl-order-service/src/main/java/com/hulalv/order/customize/controller/InternalCustomizeController.java
M hl-order-service/src/main/java/com/hulalv/order/customize/service/CustomizeRequestService.java
M hl-product-service/src/main/java/com/hulalv/product/controller/InternalMpProductController.java
M hl-product-service/src/main/java/com/hulalv/product/service/ProductService.java