# 个人利率定价流程发起 Capability Spec

## ADDED Requirements

### Requirement: 个人客户利率定价流程发起

系统 SHALL 提供个人客户专用的利率定价流程发起接口 (`POST /loanPricing/workflow/create/personal`)，该接口只接受个人客户相关的字段。

#### Scenario: 成功发起个人客户利率定价流程

- **WHEN** 业务人员通过个人客户发起接口提交包含必填字段(custIsn、guarType、applyAmt)的完整申请
- **THEN** 系统自动生成业务方流水号(serialNum)并保存记录，custType 固定为"个人"，返回成功响应

#### Scenario: 字段验证-必填字段

- **WHEN** 提交的个人客户申请缺少必填字段(custIsn、guarType、applyAmt)
- **THEN** 系统返回参数验证失败的错误信息

#### Scenario: 字段验证-担保方式枚举值

- **WHEN** 提交的个人客户申请中 guarType 不是"信用"、"保证"、"抵押"、"质押"之一
- **THEN** 系统返回参数验证失败的错误信息

#### Scenario: 记录个人特有字段

- **WHEN** 个人客户申请中包含 bizProof（是否有经营佐证）或 loanLoop（循环功能）字段
- **THEN** 系统正确保存这些字段的值

#### Scenario: 自动设置客户类型

- **WHEN** 通过个人客户发起接口创建流程
- **THEN** 系统自动将 custType 设置为"个人"，无需客户端传入

#### Scenario: 自动生成业务方流水号

- **WHEN** 发起个人客户利率定价流程时
- **THEN** 系统使用时间戳自动生成唯一的业务方流水号

#### Scenario: 记录创建和更新信息

- **WHEN** 个人客户利率定价流程创建成功
- **THEN** 系统自动记录创建者、创建时间、更新者、更新时间

### Requirement: 个人客户发起接口字段定义

个人客户发起接口 SHALL 接受以下字段：

#### Scenario: 基本信息字段

- **WHEN** 客户端提交个人客户发起请求
- **THEN** 系统接受以下基本信息字段：
    - `custIsn`（必填）：客户内码
    - `custName`：客户名称
    - `idType`：证件类型
    - `idNum`：证件号码

#### Scenario: 贷款信息字段

- **WHEN** 客户端提交个人客户发起请求
- **THEN** 系统接受以下贷款信息字段：
    - `guarType`（必填）：担保方式，可选值"信用"、"保证"、"抵押"、"质押"
    - `applyAmt`（必填）：申请金额，单位：元

#### Scenario: 个人特有字段

- **WHEN** 客户端提交个人客户发起请求
- **THEN** 系统接受以下个人特有字段：
    - `bizProof`：是否有经营佐证（个人经营性贷款提供的经营佐证包括：借款人或其配偶为法定代表人、实际经营者、股东的企业（个体工商户）营业执照或企查查、企信宝查档资料）
    - `loanLoop`：贷款合同是否开通循环功能

#### Scenario: 抵质押信息字段

- **WHEN** 客户端提交个人客户发起请求
- **THEN** 系统接受以下抵质押信息字段：
    - `collType`：抵质押类型
    - `collThirdParty`：抵质押物是否三方所有

## MODIFIED Requirements

### Requirement: 利率定价流程发起接口弃用策略

原有的统一发起接口 (`POST /loanPricing/workflow/create`) SHALL 标记为 Deprecated，系统 SHALL
继续支持该接口以保证向后兼容，同时引导使用新的个人或企业专用接口。

#### Scenario: 原有接口向后兼容

- **WHEN** 客户端继续使用原有发起接口
- **THEN** 系统继续处理请求并返回正确结果，但建议迁移到新接口

#### Scenario: 原有接口标记为已弃用

- **WHEN** 开发人员查看 API 文档
- **THEN** 原有接口标记为 Deprecated，引导使用新的个人或企业专用接口

## Cross-References

- 相关 Capability: `corporate-loan-pricing-creation`（企业客户利率定价流程发起）
- 修改自 Capability: `loan-pricing-workflow` 中的"利率定价流程发起"需求