# Proposal: 拆分个人和企业利率定价发起接口

## 概述

将现有的统一利率定价发起接口 (`POST /loanPricing/workflow/create`) 拆分为两个独立的接口：

- 个人客户发起接口 (`POST /loanPricing/workflow/create/personal`)
- 企业客户发起接口 (`POST /loanPricing/workflow/create/corporate`)

## 背景

当前系统中，`LoanPricingWorkflow` 实体包含了个人和企业客户的所有字段。当发起流程时，根据客户类型（custType）的不同，需要填写的字段存在差异：

- **个人客户**：需要填写个人特有字段（如是否有经营佐证、循环功能等）
- **企业客户**：需要填写企业特有字段（如贸易和建筑业企业标识、省农担担保贷款、绿色贷款、科技型企业、贷款期限等）

将接口拆分可以带来以下好处：

1. **接口契约更清晰**：每个接口只包含对应客户类型的字段
2. **验证更精确**：可以在 DTO 层面进行字段验证
3. **文档更友好**：API 文档可以分别展示个人和企业的字段
4. **维护性更好**：字段变更不会影响另一类型的客户

## 影响范围

### 后端变更

- 创建新的 DTO 类：`PersonalLoanPricingCreateDTO` 和 `CorporateLoanPricingCreateDTO`
- 在 `LoanPricingWorkflowController` 中添加两个新接口
- 修改 `ILoanPricingWorkflowService` 接口，添加两个新的创建方法
- 实现 `LoanPricingWorkflowServiceImpl` 中的新方法
- 保留原有接口以保持向后兼容（可选，建议标记为 Deprecated）

### 前端变更

> **注：本次变更仅涉及后端，前端暂不修改**

### 数据库变更

需要向 `loan_pricing_workflow` 表添加以下字段：

| 字段名                   | 类型           | 说明                     | 适用客户  |
|-----------------------|--------------|------------------------|-------|
| id_num                | varchar(100) | 证件号码                   | 个人、企业 |
| loan_loop             | varchar(10)  | 循环功能                   | 个人    |
| is_trade_construction | varchar(10)  | 贸易和建筑业企业标识（抵质押类上调20BP） | 企业    |
| is_green_loan         | varchar(10)  | 绿色贷款（最多下降5BP）          | 企业    |
| is_tech_ent           | varchar(10)  | 科技型企业（最多下降5BP）         | 企业    |
| loan_term             | varchar(50)  | 贷款期限                   | 企业    |

**迁移脚本位置**: `sql/add_missing_fields.sql`

同时需要更新 `LoanPricingWorkflow` Entity 类，添加对应的属性和字段映射注解。

## 设计方案

详见 `design.md`

## 风险和考虑

1. **向后兼容性**：原有接口 `POST /loanPricing/workflow/create` 继续保留
    - 原有接口不做标记为 Deprecated 的处理
    - 新旧接口共存，供前端自由选择使用

2. **数据迁移**：需要执行数据库迁移脚本添加新字段，但不涉及现有数据的迁移

3. **测试覆盖**：需要为新接口编写测试用例

## 依赖关系

- **数据库迁移必须最先执行**：所有后端开发依赖于新字段添加完成
- 依赖现有的 `LoanPricingWorkflow` 实体
- 依赖现有的 `ILoanPricingWorkflowService` 服务层

## 验收标准

1. **数据库变更**：所有新字段成功添加到数据库表，且可以正确存储和检索数据
2. **Entity 类更新**：`LoanPricingWorkflow` 实体类包含所有新增字段的属性和映射
3. **个人客户接口**：个人客户发起接口只接受个人相关的字段
4. **企业客户接口**：企业客户发起接口只接受企业相关的字段
5. **接口功能**：两个接口都能成功创建利率定价流程记录，包括新增字段的保存
6. **字段验证**：字段验证正确生效
7. **API 文档**：API 文档正确显示两个接口的差异