166 行
5.1 KiB
Markdown
166 行
5.1 KiB
Markdown
# 接口变更记录 — 2026-03-20（定价字段精简 + 保险校验）
|
||
|
||
> **类型** refactor + feature
|
||
>
|
||
> 定价配置精简（移除6个冗余字段）+ 保险方案天数校验 + 保险费自动回填
|
||
|
||
---
|
||
|
||
## 一、定价配置字段精简
|
||
|
||
### 1. 移除 `maxGroupSize`（最多成团人数）
|
||
|
||
**原因**：业务上只需要"成团人数"一个概念，不需要区分最少/最多。
|
||
|
||
**前端需要调整**：
|
||
- 定价规则页面：移除"最多成团"输入框，只保留"成团人数"（字段 `minGroupSize`）
|
||
- `minGroupSize` 语义变为"成团人数"，不再是"最少成团"
|
||
|
||
| 字段 | 变更 | 说明 |
|
||
|------|------|------|
|
||
| ~~`maxGroupSize`~~ | **已移除** | 请求和响应都不再有此字段 |
|
||
| `minGroupSize` | **含义变更** | 现在代表"成团人数"（原为"最少成团人数"） |
|
||
|
||
### 2. 移除4个未使用的价格体系字段
|
||
|
||
**原因**：这4个字段从未参与任何价格计算逻辑，只是存储和展示，属于冗余数据。
|
||
|
||
| 移除的字段 | 原含义 | 说明 |
|
||
|-----------|--------|------|
|
||
| ~~`singleRoomDiff`~~ | 单房差 | **已移除** |
|
||
| ~~`adultExtraBed`~~ | 成人加床 | **已移除** |
|
||
| ~~`childNoBed`~~ | 儿童不占床 | **已移除** |
|
||
| ~~`companionPrice`~~ | 陪同价 | **已移除** |
|
||
|
||
**保留的价格字段**（实际参与计算）：
|
||
|
||
| 字段 | 含义 | 说明 |
|
||
|------|------|------|
|
||
| `childWithBed` | 儿童占床价 | 保留，参与儿童价计算 |
|
||
| `childDiscountPercent` | 儿童折扣百分比 | 保留，参与儿童价计算 |
|
||
| `babyPrice` | 婴儿价 | 保留，参与婴儿价计算 |
|
||
| `insuranceFee` | 保险费 | 保留，参与成本计算 |
|
||
| `mealBudget` | 餐费预算 | 保留 |
|
||
| `extraCostPerPerson` | 每人额外成本 | 保留 |
|
||
|
||
### 受影响的接口
|
||
|
||
#### `POST` /admin/product/item/{productId}/pricing — 保存定价规则
|
||
|
||
**请求参数变更**：
|
||
|
||
| 字段 | 变更 |
|
||
|------|------|
|
||
| ~~`maxGroupSize`~~ | **已移除** |
|
||
| ~~`singleRoomDiff`~~ | **已移除** |
|
||
| ~~`adultExtraBed`~~ | **已移除** |
|
||
| ~~`childNoBed`~~ | **已移除** |
|
||
| ~~`companionPrice`~~ | **已移除** |
|
||
|
||
#### `GET` /admin/product/item/{productId}/pricing — 获取定价规则
|
||
|
||
**响应变更**：同上5个字段从响应中移除。
|
||
|
||
#### 小程序端 — 定制产品详情
|
||
|
||
`MpCustomProductDetailVO.PricingItem` 同步移除以上5个字段。
|
||
|
||
---
|
||
|
||
## 二、保险方案天数校验
|
||
|
||
### 功能说明
|
||
|
||
产品选择保险方案时，系统会校验保险方案的**适用行程天数**是否与产品**行程天数**一致。不一致时拒绝保存。
|
||
|
||
### 保险方案列表新增字段
|
||
|
||
#### `GET` /admin/insurance/scheme — 保险方案列表
|
||
|
||
响应新增字段：
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `totalDays` | Integer | 适用行程天数（根据保障段自动计算） |
|
||
|
||
### 产品保存时校验逻辑
|
||
|
||
- 创建/编辑产品时，如果设置了 `insuranceSchemeId`，系统自动调用保险服务校验
|
||
- 如果保险方案的 `totalDays` 与产品行程天数不匹配，返回错误提示：`保险方案「{方案名}」适用{N}天行程，但本产品行程为{M}天，请选择匹配的方案`
|
||
|
||
---
|
||
|
||
## 三、保险费自动回填
|
||
|
||
### 功能说明
|
||
|
||
产品选择保险方案后，系统自动计算每人保险费并回填到定价配置的 `insuranceFee` 字段。
|
||
|
||
### 新增接口：保险费预览
|
||
|
||
#### `GET` /admin/product/item/{productId}/pricing/insurance-fee-preview
|
||
|
||
**用途**：前端选择保险方案时实时预览保险费，不保存。
|
||
|
||
**请求参数**：
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|------|------|------|------|
|
||
| `schemeId` | Long | 是 | 保险方案ID |
|
||
|
||
**响应**：`Result<Map>`
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"schemeId": "1234567890",
|
||
"schemeName": "测试3日方案",
|
||
"totalDays": 3,
|
||
"tripDays": 3,
|
||
"perPersonPremium": 45.00
|
||
}
|
||
}
|
||
```
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `schemeId` | String | 保险方案ID |
|
||
| `schemeName` | String | 方案名称 |
|
||
| `totalDays` | Integer | 方案适用天数 |
|
||
| `tripDays` | Integer | 产品行程天数 |
|
||
| `perPersonPremium` | BigDecimal | 每人保险费（元） |
|
||
|
||
**错误场景**：
|
||
- 产品不存在 → 404
|
||
- 保险服务不可用 → 500（"保险服务暂不可用"）
|
||
- 天数不匹配 → 400（提示不匹配原因）
|
||
|
||
### 自动回填逻辑
|
||
|
||
产品保存（创建/编辑）时：
|
||
1. 如果设置了 `insuranceSchemeId`，自动调用保险服务获取每人保险费
|
||
2. 校验天数匹配（不匹配则报错）
|
||
3. 自动将 `perPersonPremium` 写入 `ProductPricing.insuranceFee`
|
||
4. 前端定价页面的"保险费"字段会自动更新为计算值（仍可手动修改）
|
||
|
||
---
|
||
|
||
## 数据库变更
|
||
|
||
```sql
|
||
-- 1. 移除 maxGroupSize
|
||
ALTER TABLE product_pricing DROP COLUMN max_group_size;
|
||
|
||
-- 2. 保险方案新增 totalDays
|
||
ALTER TABLE insurance_scheme ADD COLUMN total_days INT DEFAULT NULL COMMENT '适用行程天数';
|
||
|
||
-- 3. 移除4个未使用的定价字段
|
||
ALTER TABLE product_pricing DROP COLUMN single_room_diff;
|
||
ALTER TABLE product_pricing DROP COLUMN adult_extra_bed;
|
||
ALTER TABLE product_pricing DROP COLUMN child_no_bed;
|
||
ALTER TABLE product_pricing DROP COLUMN companion_price;
|
||
```
|
||
|
||
已在本地和测试环境执行完毕。
|