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

12 KiB
原始文件 Blame 文件历史

接口变更记录 — 2026-04-02 10:39

提交 05d9b09f · 作者 wx · 时间 2026-04-02 10:39:29 +0800

fix: 全局"定金"改为"订金"——统一用字规范

变更总览

  • 订单服务
    • AdminOrder (名1)

订单服务

AdminOrder

📖 接口文档: http://192.168.100.236:8084/doc.html → 分组 「3.1 订单管理」 → 标签 「管理端订单接口」

接口名称更新

方法 路径 原名称 → 新名称
PUT /admin/order/{orderId}/deposit 修改定金金额 → 修改订金金额

📦 其他数据对象变更

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

产品服务

✏️ GroupBatchCalendarVO

  • ✏️ depositAmount: 说明 "定金金额(元/人)，根据起步价×定金比例计算" → "订金金额(元/人)，根据起步价×订金比例计算"

✏️ MpProductListVO

  • ✏️ startPrice: 说明 "起步价：全款模式=最低售价，定金模式=最低定金额" → "起步价：全款模式=最低售价，订金模式=最低订金额"
  • ✏️ startPriceLabel: 说明 "起步价标签：'起' 或 '定金起'" → "起步价标签：'起' 或 '订金起'"
  • ✏️ paymentMode: 说明 "支付模式：FULL=全款 DEPOSIT=定金+尾款" → "支付模式：FULL=全款 DEPOSIT=订金+尾款"

✏️ MpProductQueryRequest

  • ✏️ paymentMode: 说明 "支付模式筛选：FULL=全款 DEPOSIT=定金+尾款 null=全部" → "支付模式筛选：FULL=全款 DEPOSIT=订金+尾款 null=全部"

✏️ PricingRequest

  • ✏️ profitMode: 说明 "利润模式：FIXED=在成本基础上加固定金额 PERCENT=在成本基础上按百分比加价" → "利润模式：FIXED=在成本基础上加固订金额 PERCENT=在成本基础上按百分比加价"
  • ✏️ paymentType: 说明 "支付方式：FULL=全款支付 DEPOSIT=定金+尾款分期支付" → "支付方式：FULL=全款支付 DEPOSIT=订金+尾款分期支付"
  • ✏️ depositRatio: 说明 "定金比例（百分比，如30代表30%。与depositAmount二选一，优先使用比例）" → "订金比例（百分比，如30代表30%。与depositAmount二选一，优先使用比例）"
  • ✏️ depositAmount: 说明 "定金金额（固定金额，与depositRatio二选一）" → "订金金额（固订金额，与depositRatio二选一）"

✏️ ProductPricingVO

  • ✏️ profitMode: 说明 "利润模式：FIXED=固定金额 PERCENT=百分比" → "利润模式：FIXED=固订金额 PERCENT=百分比"
  • ✏️ paymentType: 说明 "支付方式：FULL=全款 DEPOSIT=定金+尾款" → "支付方式：FULL=全款 DEPOSIT=订金+尾款"
  • ✏️ depositRatio: 说明 "定金比例（百分比）" → "订金比例（百分比）"
  • ✏️ depositAmount: 说明 "定金金额" → "订金金额"

✏️ ProductVO

  • ✏️ paymentMode: 说明 "支付模式：FULL=全款 DEPOSIT=定金+尾款" → "支付模式：FULL=全款 DEPOSIT=订金+尾款"
  • ✏️ startPrice: 说明 "起步价：全款模式=最低售价，定金模式=最低定金额" → "起步价：全款模式=最低售价，订金模式=最低订金额"
  • ✏️ startPriceLabel: 说明 "起步价标签：'起' 或 '定金起'" → "起步价标签：'起' 或 '订金起'"

公共模块

✏️ OrderPayInfoDTO

  • ✏️ depositAmount: 说明 "定金金额" → "订金金额"
  • ✏️ paymentMode: 说明 "支付模式: FULL=全款, DEPOSIT=定金+尾款" → "支付模式: FULL=全款, DEPOSIT=订金+尾款"
  • ✏️ isBooking: 说明 "是否预定产品: true=预定(定金可不填出行人), false=非预定(支付前必须填出行人)" → "是否预定产品: true=预定(订金可不填出行人), false=非预定(支付前必须填出行人)"

✏️ PaymentResultDTO

  • ✏️ payType: 说明 "支付类型: FULL=全款, DEPOSIT=定金, BALANCE=尾款" → "支付类型: FULL=全款, DEPOSIT=订金, BALANCE=尾款"

小程序聚合服务

✏️ MpCustomProductDetailVO

  • ✏️ paymentMode: 说明 "支付模式：FULL=全款 DEPOSIT=定金+尾款" → "支付模式：FULL=全款 DEPOSIT=订金+尾款"
  • ✏️ profitMode: 说明 "利润模式：FIXED=固定金额 PERCENT=百分比" → "利润模式：FIXED=固订金额 PERCENT=百分比"
  • ✏️ paymentType: 说明 "支付方式：FULL=全款 DEPOSIT=定金+尾款" → "支付方式：FULL=全款 DEPOSIT=订金+尾款"
  • ✏️ depositRatio: 说明 "定金比例（百分比）" → "订金比例（百分比）"
  • ✏️ depositAmount: 说明 "定金金额" → "订金金额"

✏️ MpCustomProductListVO

  • ✏️ paymentMode: 说明 "支付模式：FULL=全款 DEPOSIT=定金+尾款" → "支付模式：FULL=全款 DEPOSIT=订金+尾款"

✏️ MpOrderDetailVO

  • ✏️ depositRatio: 说明 "定金比例" → "订金比例"
  • ✏️ depositAmount: 说明 "定金金额" → "订金金额"
  • ✏️ payMethodLabel: 说明 "支付方式标签（如：微信支付、定金微信+尾款线下）" → "支付方式标签（如：微信支付、订金微信+尾款线下）"

✏️ MpOrderListItemVO

  • ✏️ depositAmount: 说明 "定金金额" → "订金金额"

✏️ MpProductQuoteVO

  • ✏️ paymentMode: 说明 "支付方式: FULL(全额支付) / DEPOSIT(定金+尾款)" → "支付方式: FULL(全额支付) / DEPOSIT(订金+尾款)"
  • ✏️ depositPayment: 说明 "定金支付信息（仅paymentMode=DEPOSIT时有值）" → "订金支付信息（仅paymentMode=DEPOSIT时有值）"
  • ✏️ depositRatio: 说明 "定金比例(%)" → "订金比例(%)"
  • ✏️ depositAmount: 说明 "定金金额（首次需付）" → "订金金额（首次需付）"

✏️ MpRefundDetailVO

  • ✏️ refundType: 说明 "退款类型: DEPOSIT(定金)/BALANCE(尾款)/FULL(全款)" → "退款类型: DEPOSIT(订金)/BALANCE(尾款)/FULL(全款)"

订单服务

✏️ AdminUpdateOrderRequest

  • ✏️ depositAmount: 说明 "定金金额" → "订金金额"

✏️ MpOrderListVO

  • ✏️ depositAmount: 说明 "定金金额" → "订金金额"
  • ✏️ balanceAmount: 说明 "尾款金额（DEPOSIT模式：总售价-定金-优惠）" → "尾款金额（DEPOSIT模式：总售价-订金-优惠）"

✏️ OrderDetailVO

  • ✏️ paymentModeLabel: 说明 "支付模式中文标签（DEPOSIT=定金+尾款, FULL=全款）" → "支付模式中文标签（DEPOSIT=订金+尾款, FULL=全款）"
  • ✏️ depositRatio: 说明 "定金比例" → "订金比例"
  • ✏️ depositAmount: 说明 "定金金额" → "订金金额"
  • ✏️ balanceAmount: 说明 "尾款金额（总售价-定金）" → "尾款金额（总售价-订金）"
  • ✏️ payMethodLabel: 说明 "支付方式标签（如：微信支付、定金微信+尾款线下）" → "支付方式标签（如：微信支付、订金微信+尾款线下）"

✏️ OrderListVO

  • ✏️ depositAmount: 说明 "定金金额" → "订金金额"
  • ✏️ balanceAmount: 说明 "尾款金额（DEPOSIT模式：总售价-定金-优惠）" → "尾款金额（DEPOSIT模式：总售价-订金-优惠）"

✏️ UpdateDepositRequest

  • ✏️ amount: 说明 "定金金额" → "订金金额"

✏️ UpdateOrderStatusRequest

  • ✏️ status: 说明 "目标状态。可选值：PENDING_PAY(待支付)/DEPOSIT_PAID(已付定金)/PAID(已全额支付)/" → "目标状态。可选值：PENDING_PAY(待支付)/DEPOSIT_PAID(已付订金)/PAID(已全额支付)/"
📁 全部变更文件 (点击展开) 
M	hl-common/hl-common-core/src/main/java/com/hulalv/common/dto/OrderPayInfoDTO.java
M	hl-common/hl-common-core/src/main/java/com/hulalv/common/dto/PaymentResultDTO.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpCustomizeController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpOrderController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpProductController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/vo/MpCustomProductDetailVO.java
M	hl-mp-service/src/main/java/com/hulalv/mp/vo/MpCustomProductListVO.java
M	hl-mp-service/src/main/java/com/hulalv/mp/vo/MpOrderDetailVO.java
M	hl-mp-service/src/main/java/com/hulalv/mp/vo/MpOrderListItemVO.java
M	hl-mp-service/src/main/java/com/hulalv/mp/vo/MpProductQuoteVO.java
M	hl-mp-service/src/main/java/com/hulalv/mp/vo/MpRefundDetailVO.java
M	hl-mp-service/src/test/java/com/hulalv/mp/VoCoverageTest.java
M	hl-mp-service/src/test/java/com/hulalv/mp/VoExtraDeepCoverageTest.java
M	hl-mp-service/src/test/java/com/hulalv/mp/controller/MpProductControllerBranchTest.java
M	hl-mp-service/src/test/java/com/hulalv/mp/service/ProductAggregationServiceTest.java
M	hl-order-service/src/main/java/com/hulalv/order/constant/OrderConstants.java
M	hl-order-service/src/main/java/com/hulalv/order/controller/AdminOrderController.java
M	hl-order-service/src/main/java/com/hulalv/order/controller/InternalMpOrderController.java
M	hl-order-service/src/main/java/com/hulalv/order/controller/InternalPaymentOrderController.java
M	hl-order-service/src/main/java/com/hulalv/order/controller/InternalRefundController.java
M	hl-order-service/src/main/java/com/hulalv/order/controller/MpOrderController.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/AdminUpdateOrderRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/UpdateDepositRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/UpdateOrderStatusRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/entity/OrderInfo.java
M	hl-order-service/src/main/java/com/hulalv/order/job/DepartureReminderJob.java
M	hl-order-service/src/main/java/com/hulalv/order/service/NotificationEventHelper.java
M	hl-order-service/src/main/java/com/hulalv/order/service/OrderItineraryEditService.java
M	hl-order-service/src/main/java/com/hulalv/order/service/OrderService.java
M	hl-order-service/src/main/java/com/hulalv/order/service/OrderTodoService.java
M	hl-order-service/src/main/java/com/hulalv/order/service/RefundApplicationService.java
M	hl-order-service/src/main/java/com/hulalv/order/vo/MpOrderListVO.java
M	hl-order-service/src/main/java/com/hulalv/order/vo/OrderDetailVO.java
M	hl-order-service/src/main/java/com/hulalv/order/vo/OrderListVO.java
M	hl-order-service/src/main/java/com/hulalv/payment/service/PaymentService.java
M	hl-order-service/src/test/java/com/hulalv/order/constant/OrderConstantsTest.java
M	hl-order-service/src/test/java/com/hulalv/order/service/NotificationEventHelperTest.java
M	hl-order-service/src/test/java/com/hulalv/order/service/OrderServiceExtendedTest.java
M	hl-order-service/src/test/java/com/hulalv/order/service/OrderServiceTest.java
M	hl-order-service/src/test/java/com/hulalv/order/service/RefundApplicationServiceTest.java
M	hl-order-service/src/test/java/com/hulalv/payment/service/PaymentServiceTest.java
M	hl-product-service/src/main/java/com/hulalv/product/controller/MpProductController.java
M	hl-product-service/src/main/java/com/hulalv/product/controller/PricingController.java
M	hl-product-service/src/main/java/com/hulalv/product/dto/MpProductQueryRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/dto/PricingRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/service/GroupTourBatchService.java
M	hl-product-service/src/main/java/com/hulalv/product/service/ProductPricingService.java
M	hl-product-service/src/main/java/com/hulalv/product/service/ProductService.java
M	hl-product-service/src/main/java/com/hulalv/product/service/ProductStatusService.java
M	hl-product-service/src/main/java/com/hulalv/product/vo/GroupBatchCalendarVO.java
M	hl-product-service/src/main/java/com/hulalv/product/vo/MpProductListVO.java
M	hl-product-service/src/main/java/com/hulalv/product/vo/ProductPricingVO.java
M	hl-product-service/src/main/java/com/hulalv/product/vo/ProductVO.java
M	hl-product-service/src/test/java/com/hulalv/product/service/MpProductServiceTest.java