# 接口变更记录 — 2026-03-27 19:11

> **提交** `9a30a34` · **作者** wx · **时间** 2026-03-27 19:11:41 +0800
>
> feat: 小程序产品详情返回早鸟优惠文案(earlyBirdTexts)

## 变更总览

- **订单服务**
  - InternalEarlyBird (+1)

---

## 订单服务

### InternalEarlyBird

> 📖 **接口文档**: [http://192.168.100.236:8084/doc.html](http://192.168.100.236:8084/doc.html) → 标签 **「【内部接口】早鸟优惠（Feign调用）」**

### 🆕 `GET` /internal/mp/early-bird/by-product — 查询产品关联的生效早鸟计划

> 根据productId查询当前生效且关联该产品的早鸟计划列表，用于小程序产品详情展示

**参数**

  - `productId` (`Long`) — 查询参数

**响应** `Result<List<EarlyBirdPlanVO>>`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `planId` | `Long` | 计划ID |
| `planName` | `String` | 计划名称 |
| `startDate` | `LocalDate` | 生效开始日期 |
| `endDate` | `LocalDate` | 生效结束日期 |
| `minPeople` | `Integer` | 最低人数 |
| `discountAmount` | `BigDecimal` | 优惠金额 |
| `enabled` | `Boolean` | 是否启用 |
| `remark` | `String` | 备注 |
| `createdBy` | `Long` | 创建人ID |
| `createTime` | `LocalDateTime` | 创建时间 |
| `updateTime` | `LocalDateTime` | 更新时间 |
| `productIds` | `List<Long>` | 适用产品ID列表（空表示适用全部CORE/GROUP产品） |
| `productNames` | `List<String>` | 适用产品名称列表（空表示适用全部） |

---

## 📦 其他数据对象变更

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

### 产品服务

#### 🆕 EarlyBirdBriefVO

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `planId` | `Long` |  |
| `planName` | `String` |  |
| `startDate` | `LocalDate` |  |
| `endDate` | `LocalDate` |  |
| `minPeople` | `Integer` |  |
| `discountAmount` | `BigDecimal` |  |

#### ✏️ ProductVO

  - 🆕 `earlyBirdTexts` (`List<String>`) — 早鸟优惠文案列表，如['早鸟优惠：2人及以上立减200元/人']

<details>
<summary>📁 全部变更文件 (点击展开)</summary>

```
M	hl-order-service/src/main/java/com/hulalv/order/controller/InternalEarlyBirdController.java
M	hl-order-service/src/main/java/com/hulalv/order/service/EarlyBirdPlanService.java
A	hl-product-service/src/main/java/com/hulalv/product/feign/EarlyBirdFallbackFactory.java
A	hl-product-service/src/main/java/com/hulalv/product/feign/EarlyBirdFeignClient.java
A	hl-product-service/src/main/java/com/hulalv/product/feign/vo/EarlyBirdBriefVO.java
M	hl-product-service/src/main/java/com/hulalv/product/service/ProductService.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
M	hl-product-service/src/test/java/com/hulalv/product/service/ProductServiceTest.java
```
</details>