hl-api-changelog/changelogs/2026-04/2026-04-16_product-v2_quote-fix-and-tier-desc.md

82 行
2.2 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 报价逻辑修复 + 档位描述字段
- **日期**: 2026-04-16
- **服务**: hl-product-service-v2
- **PR**: #638, #661
- **类型**: fix + feat
## 1. 报价逻辑修复(⚠️ 重要)
### 问题
报价接口把价格日历的每日价格逐天累加,导致总价 = 单价 × 人数 × 行程天数(错误)。
### 修复
取**出发日期当天的一口价** × 人数(和旧版一致)。
### 响应变更
`POST /admin/product/item/{id}/quote``POST /mp/product/{id}/quote`
**新增字段**
| 字段 | 类型 | 说明 |
|------|------|------|
| `adultUnitPrice` | BigDecimal | 成人单价(出发日一口价) |
| `childUnitPrice` | BigDecimal | 儿童单价(出发日一口价) |
**删除字段**
| 字段 | 说明 |
|------|------|
| `dailyDetails` | 不再返回每日明细(一口价不需要) |
**响应示例**
```json
{
"adultUnitPrice": 4999.0,
"childUnitPrice": 3499.0,
"totalAdultPrice": 9998.0,
"totalChildPrice": 3499.0,
"grandTotal": 13497.0
}
```
计算公式:`totalAdultPrice = adultUnitPrice × adultCount`
## 2. 档位描述字段
产品的 `tiers` JSON结构新增 `tierDescription` 字段。
**旧结构**
```json
[{"tierSeq": 1, "tierName": "轻奢"}, {"tierSeq": 2, "tierName": "高端"}]
```
**新结构**
```json
[
{"tierSeq": 1, "tierName": "轻奢", "tierDescription": "精选三星酒店,舒适出行"},
{"tierSeq": 2, "tierName": "高端", "tierDescription": "五星酒店+专车接送,尊享体验"}
]
```
后端纯JSON存取,无需改代码。前端在Step1基础信息的规格列表中,每个档位加一个描述输入框即可。
## 3. routeSummary 线路概览摘要
新增字段 `routeSummary`,保存行程(Step2)时自动生成。
格式:`{首天集合地}起止·全程约{总里程}公里·日均不超{日均最大里程取整百}公里`
示例:`海拉尔起止·全程约1200公里·日均不超400公里`
- 管理端详情:`routeInfo.routeSummary`
- 小程序详情:`routeSummary`
- `routeDescription`(线路描述)不再自动覆盖,完全由用户手动填写
## 4. guaranteeTemplateId 修复
Step5补充信息保存接口现在正确支持 `guaranteeTemplateId` 字段,详情也正确返回。