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.8 KiB

原始文件 Blame 文件历史

MP 订单详情 · 领队/摄影师头像 avatarUrl 之前为 null — 已修复

变更日期: 2026-04-23
PR: #1309
影响面: 小程序端 · 订单详情「领队」「摄影师」弹窗 / 卡片的头像展示
兼容性: 字段结构零变化，原本 null 的字段现在会填充有效 URL

变化一句话

MP 订单详情相关接口中的员工头像 avatarUrl 字段之前恒为 null，现在会返回有效的头像 OSS URL。

涉及接口

下列接口返回体中的 avatarUrl 字段：

接口	返回体中的位置
`GET /mp/order/{orderId}/guide`	`guide.avatarUrl`
`GET /mp/order/{orderId}/photographer`	`photographer.avatarUrl`

头像生成规则（前端可了解优先级）

优先取员工档案 coverMaterialId 对应的物料库封面（OSS URL）
若无，fallback 取员工相册 photoUrls 的第一张
都没有 → avatarUrl 为 null（前端走默认占位图即可）

生效范围（⚠️ 重要）

订单类型	是否生效
新下单的小蒙马（GROUP）订单	✅ 立即生效
历史已下单的 GROUP 订单	❌ 下单时已固化的员工快照未补头像，avatarUrl 仍为 null（如需回填可后台批量补修，本次未做）
CORE（核心/自驾/自助游）订单	N/A（本来就不含领队/摄影师）

不影响范围

领队/摄影师接口的其它字段（staffName / staffPhone / staffRole / remark 等）零变化
下单请求体、订单详情主体零变化
管理端员工档案（/admin/staff/**）零变化
订单班期员工列表接口（/mp/order/{orderId}/staff-list 等）同步生效

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

MP 订单详情 · 领队/摄影师头像 avatarUrl 之前为 null — 已修复

变化一句话

涉及接口

头像生成规则（前端可了解优先级）

生效范围（⚠️ 重要）

不影响范围

相关

1.8 KiB

原始文件 Blame 文件历史