loan-pricing/openspec/changes/split-pricing-creation-interface/specs/personal-loan-pricing-creation/spec.md

个人利率定价流程发起 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 中的"利率定价流程发起"需求