diff --git a/changelogs/2026-03/30_batch_staff.md b/changelogs/2026-03/30_batch_staff.md new file mode 100644 index 0000000..ad09e5f --- /dev/null +++ b/changelogs/2026-03/30_batch_staff.md @@ -0,0 +1,45 @@ +# 小程序产品详情团期返回服务人员 + +- **日期**: 2026-03-30 +- **PR**: #35 +- **服务**: hl-product-service +- **类型**: feat + +## 变更内容 + +`GET /mp/product/{productId}` 产品详情接口中,团期(batches)列表新增 `staff` 字段。 + +### 新增字段 + +| 字段路径 | 类型 | 说明 | +|---------|------|------| +| batches[].staff | Array | 服务人员列表 | +| batches[].staff[].staffName | String | 姓名 | +| batches[].staff[].staffRole | String | 角色(GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER) | +| batches[].staff[].staffPhone | String | 脱敏手机号(138****8000) | + +### 返回示例 + +```json +{ + "batches": [ + { + "batchName": "第一期", + "departureDate": "2026-04-15", + "staff": [ + {"staffName": "张导", "staffRole": "GUIDE", "staffPhone": "138****8000"}, + {"staffName": "李摄影", "staffRole": "PHOTOGRAPHER", "staffPhone": "139****9000"} + ] + } + ] +} +``` + +## 前端影响 + +- 新增字段,向后兼容 +- 无人员时 staff 为空数组 + +## 需要重启 + +- hl-product-service