changelog: 0ace7c92 - feat(product-v2): 建议售价接口+详情JSON字段修复+审计字段清理

changelogs/2026-04/2026-04-13_2255_0ace7c92_feat_product-v2.md

@@ -0,0 +1,56 @@
+# 接口变更记录 — 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>