# 接口变更记录 — 2026-03-27 10:26

> **提交** `e18405c` · **作者** wx · **时间** 2026-03-27 10:26:31 +0800
>
> feat: 产品新增研学收获模块，设计与安全保障一致

## 变更总览

- **产品服务**
  - 🆕 ProductStudyGain (+4 接口)

---

## 产品服务

### 🆕 新增: ProductStudyGain

> 📖 **接口文档**: [http://192.168.100.236:8085/doc.html](http://192.168.100.236:8085/doc.html) → 标签 **「产品研学收获管理」**

### 📌 `GET` /admin/product/{productId}/study-gain — 列表

**参数**

  - `{productId}` (`Long`) — 路径参数

**响应** `Result<List<Map<String, Object>>>`

### 📌 `POST` /admin/product/{productId}/study-gain — 添加

**参数**

  - `{productId}` (`Long`) — 路径参数

**请求体** `StudyGainRequest`

**响应** `Result<Map<String, Object>>`

### 📌 `PUT` /admin/product/{productId}/study-gain/{id} — 更新

**参数**

  - `{productId}` (`Long`) — 路径参数
  - `{id}` (`Long`) — 路径参数

**请求体** `StudyGainRequest`

**响应** `Result<Map<String, Object>>`

### 📌 `DELETE` /admin/product/{productId}/study-gain/{id} — 删除

**参数**

  - `{productId}` (`Long`) — 路径参数
  - `{id}` (`Long`) — 路径参数

**响应** `Result<Void>`

---

## 📦 其他数据对象变更

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

### 产品服务

#### ✏️ ProductVO

  - 🆕 `studyGains` (`List<Map<String, String>>`) — 研学收获列表[{icon,title,description}]

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

```
A	hl-product-service/src/main/java/com/hulalv/product/controller/ProductStudyGainController.java
A	hl-product-service/src/main/java/com/hulalv/product/entity/ProductStudyGain.java
A	hl-product-service/src/main/java/com/hulalv/product/mapper/ProductStudyGainMapper.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>