客户类型字段更新

2026-02-02 15:25:38 +08:00
parent 6483a651c4
commit bc7011313f
39 changed files with 5253 additions and 719 deletions
--- a/openspec/changes/split-pricing-creation-interface/specs/personal-loan-pricing-creation/spec.md
+++ b/openspec/changes/split-pricing-creation-interface/specs/personal-loan-pricing-creation/spec.md
@@ -0,0 +1,98 @@
+# 个人利率定价流程发起 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` 中的"利率定价流程发起"需求