# 合同方案 + 产品合同配置改版 + 支付前出行人校验

## 功能说明

### 1. 合同方案管理（新增）
合同配置改为"合同方案"模式（与保险方案一致），产品只需选择一个合同方案ID。

### 2. 产品合同配置改版（破坏性变更）
产品上原来的 9 个合同字段（contractPlatform, contractTemplateCode, contractMode, signatoryMode, agencyCode, disputeResolution, supplementaryClause, transactorName, transactorPhone）已全部删除，替换为单个 `contractSchemeId` 字段。

### 3. 支付前出行人校验规则变更
- **预约产品**（isBooking=true）：定金支付不要求出行人，全款/尾款要求出行人齐全
- **非预约产品**（isBooking=false）：所有支付类型都要求出行人齐全

### 4. HTTP 200 统一化
所有接口只要请求能到达服务器，HTTP状态码一律返回200，业务错误在响应体Result中返回。

---

## 合同方案接口清单

### 查询启用的合同方案列表（下拉选择用）
- **GET** `/admin/contract/scheme/list`
- **响应**：`Result<List<ContractSchemeVO>>`

### 查询全部合同方案列表（管理页面用）
- **GET** `/admin/contract/scheme/list-all`
- **响应**：`Result<List<ContractSchemeVO>>`

### 获取合同方案详情
- **GET** `/admin/contract/scheme/{schemeId}`
- **响应**：`Result<ContractSchemeVO>`

### 创建合同方案
- **POST** `/admin/contract/scheme`
- **请求体**：`ContractSchemeRequest`
- **响应**：`Result<ContractSchemeVO>`

### 更新合同方案
- **PUT** `/admin/contract/scheme/{schemeId}`
- **请求体**：`ContractSchemeRequest`
- **响应**：`Result<ContractSchemeVO>`

### 切换方案启用/停用状态
- **PUT** `/admin/contract/scheme/{schemeId}/toggle-status`
- **响应**：`Result<ContractSchemeVO>`

### 删除合同方案
- **DELETE** `/admin/contract/scheme/{schemeId}`
- **响应**：`Result<Void>`

---

## ContractSchemeRequest 参数

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| name | String | 是 | 方案名称，如"标准国内电子签约方案" |
| description | String | 否 | 方案描述 |
| contractPlatform | String | 是 | 合同平台：`12301`（全国旅游监管平台）/ `FADADA`（法大大） |
| contractTemplateCode | String | 是 | 合同模板编码，如 `TOURAGE_STANDARD` |
| contractMode | String | 是 | 签约模式：`STANDARD`（电子签约）/ `SYNC`（线下报备） |
| signatoryMode | Integer | 是 | 签署模式：`1`=短信签署 `2`=现场签署 `3`=线下签署 |
| agencyCode | String | 是 | 旅行社编码 |
| disputeResolution | Integer | 是 | 争议解决方式：`1`=仲裁 `2`=诉讼 |
| supplementaryClause | String | 否 | 补充条款 |
| transactorName | String | 是 | 经办人姓名 |
| transactorPhone | String | 是 | 经办人电话 |
| sortOrder | Integer | 否 | 排序（越小越靠前） |

## ContractSchemeVO 响应

| 字段 | 类型 | 说明 |
|------|------|------|
| schemeId | String | 方案ID |
| name | String | 方案名称 |
| description | String | 方案描述 |
| contractPlatform | String | 合同平台：12301/FADADA |
| contractTemplateCode | String | 合同模板编码 |
| contractMode | String | 签约模式：STANDARD/SYNC |
| signatoryMode | Integer | 签署模式：1=短信 2=现场 3=线下 |
| agencyCode | String | 旅行社编码 |
| disputeResolution | Integer | 争议解决方式：1=仲裁 2=诉讼 |
| supplementaryClause | String | 补充条款 |
| transactorName | String | 经办人姓名 |
| transactorPhone | String | 经办人电话 |
| sortOrder | Integer | 排序 |
| status | String | 状态：ACTIVE/INACTIVE |
| createTime | DateTime | 创建时间 |

---

## 产品接口变更（破坏性变更）

### 产品创建/更新/保存接口

**删除的字段**（以下字段不再使用）：
- ~~contractPlatform~~
- ~~contractTemplateCode~~
- ~~contractMode~~
- ~~signatoryMode~~
- ~~agencyCode~~
- ~~disputeResolution~~
- ~~supplementaryClause~~
- ~~transactorName~~
- ~~transactorPhone~~

**新增的字段**：

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| contractSchemeId | Long | 是（创建时） | 合同方案ID，从 `/admin/contract/scheme/list` 获取 |

### 产品详情接口

**响应变更**：
- 删除 9 个合同字段
- 新增 `contractSchemeId`（String类型）

---

## 页面布局建议

### 合同方案管理页面
路径建议：系统管理 → 合同方案管理（类似保险方案管理）
- 列表页：方案名称、合同平台、签约模式、旅行社、状态、操作（编辑/启停/删除）
- 新建/编辑弹窗：ContractSchemeRequest 的所有字段

### 产品编辑页面 — 合同配置区域改版

**原来**（9个表单项）：
```
合同平台 *    [12301] [法大大]
合同模板 *    [下拉选择]
签约模式 *    [电子签约] [线下报备]
签署模式 *    [短信签署] [现场签署] [线下签署]
旅行社 *      [下拉选择]
争议解决方式 * [仲裁] [诉讼]
补充条款       [文本框]
经办人姓名 *  [文本框]
经办人电话 *  [文本框]
```

**现在**（1个下拉选择）：
```
合同方案 *    [请选择合同方案 ▼]
```
下拉数据来源：`GET /admin/contract/scheme/list`（返回启用的方案列表）

---

## 调用示例

### 创建合同方案
```json
POST /admin/contract/scheme
{
  "name": "标准国内电子签约方案",
  "contractPlatform": "12301",
  "contractTemplateCode": "TOURAGE_STANDARD",
  "contractMode": "STANDARD",
  "signatoryMode": 1,
  "agencyCode": "L-NMG-100001",
  "disputeResolution": 1,
  "transactorName": "张三",
  "transactorPhone": "13800138000",
  "sortOrder": 0
}
```

### 产品创建（使用合同方案ID）
```json
POST /admin/product
{
  "name": "冰雪3.0南线",
  "productType": "CORE",
  "insuranceSchemeId": 123456789,
  "contractSchemeId": 987654321,
  ...
}
```