# 接口变更记录 — 2026-04-13 22:55

> **提交** `0ace7c92` · **作者** wx · **时间** 2026-04-13 22:55:29 +0800
>
> feat(product-v2): 建议售价接口+详情JSON字段修复+审计字段清理

## 变更总览

- **hl-product-service-v2**
  - AdminProduct (+1)

---

## hl-product-service-v2

### AdminProduct

### 🆕 `GET` /admin/product/item/{id}/suggest-price — 计算建议售价

> 根据备品成本+额外成本计算建议售价。如有激活的公式组则通过公式引擎计算。返回成人/儿童单价及成本明细。

**参数**

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

**响应** `Result<SuggestPriceRespVO>`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `adultSuggestPrice` | `BigDecimal` | 成人建议售价(单人) |
| `childSuggestPrice` | `BigDecimal` | 儿童建议售价(单人) |
| `adultCost` | `CostBreakdown` | 成人成本明细 |
| `childCost` | `CostBreakdown` | 儿童成本明细 |
| `formulaApplied` | `Boolean` | 是否使用了公式引擎 |
| `suppliesCost` | `BigDecimal` | 备品成本(按人头) |
| `extraCost` | `BigDecimal` | 额外成本 |
| `totalCost` | `BigDecimal` | 成本合计 |
| `suppliesItems` | `List<CostItem>` | 备品明细 |
| `extraItems` | `List<CostItem>` | 额外成本明细 |
| `name` | `String` | 名称 |
| `unitPrice` | `BigDecimal` | 单价 |
| `quantity` | `Integer` | 数量 |
| `subtotal` | `BigDecimal` | 小计 |

---

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

```
M	hl-product-service-v2/src/main/java/com/hulalv/product/controller/admin/AdminProductController.java
M	hl-product-service-v2/src/main/java/com/hulalv/product/service/admin/ProductQueryService.java
A	hl-product-service-v2/src/main/java/com/hulalv/product/service/admin/SuggestPriceService.java
A	hl-product-service-v2/src/main/java/com/hulalv/product/vo/admin/SuggestPriceRespVO.java
```
</details>