99 lines
3.8 KiB
Markdown
99 lines
3.8 KiB
Markdown
# 个人利率定价流程发起 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` 中的"利率定价流程发起"需求
|