客户类型字段更新

openspec/changes/split-pricing-creation-interface/proposal.md

@@ -0,0 +1,83 @@
+# 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 文档正确显示两个接口的差异