yaosutu 17648b8961 changelog(mp): 04-23 下午批次 7 篇 — 合同强类型 VO / 退款 ratio / balance 统一 / 头像 / groupBatchId / 小童保留 / 行前清单拆分

- #1314 mp-contract: Map → MpContractVO / MpContractDetailVO 强类型化
- #1313 mp-refund preview refundRatio 恒 0 bug 修复
- #1306 mp-order balanceAmount 计算口径统一(FULL 也返回, 公式含 paid)
- #1309 mp-order guide/photographer avatarUrl 快照补齐(新订单生效)
- #1300 mp-order detail 新增 groupBatchId(GROUP 才有值)
- #1298 mp-group order youngChildCount 保留不再强制清零
- #1289 mp-pre-trip checklist 6→7 项 + DEPARTURE_INFO + WARNING 状态

2026-04-23 16:43:36 +08:00

1.5 KiB

原始文件 Blame 文件历史

MP 订单详情 · 新增 groupBatchId（团期 ID）

变更日期: 2026-04-23
PR: #1300
影响面: 小程序端 · 订单详情（仅小蒙马 GROUP 订单有值）
兼容性: 完全向后兼容（纯新增字段，旧前端不读即可忽略）

变化一句话

MP 订单详情返回体 MpOrderDetailVO 新增 groupBatchId 字段，仅小蒙马 GROUP 订单有值，前端可据此跳转到对应团期详情页。

接口

GET /mp/order/{orderId}（以及走 BFF 的同类接口）

新增字段

字段	类型	说明
`groupBatchId`	Long	团期 ID。仅 GROUP（小蒙马）订单有值；CORE（自驾/自助游）、CUSTOM（定制）等订单为 null

返回示例

{
  "code": 200,
  "data": {
    "orderId": 1900001,
    "orderNo": "XMM20260423001",
    "groupCode": "0001",
    "groupBatchId": 2045401225939079169,
    "productId": 1893012345678901234,
    "productName": "...",
    "...": "..."
  },
  "success": true
}

前端接入场景（参考）

「我的订单 → 订单详情 → 团期入口」点击后用 groupBatchId 跳团期详情页；非 GROUP 订单为 null 时隐藏入口即可。

不影响范围

其它订单字段（orderNo / groupCode / productId / productName / ...）零变化
管理端订单详情 DTO 不涉及
下单/支付/退款链路 零影响

1.5 KiB 原始文件 Blame 文件历史 Unescape Escape