归档贷款定价流程相关的 OpenSpec 变更

- 归档 add-loan-pricing-workflow:完成流程后端 API
- 归档 add-loan-pricing-frontend:完成前端列表和详情页面
- 归档 add-loan-pricing-create:完成前端创建功能
- 新增规范文件:loan-pricing-workflow 和 loan-pricing-workflow-ui
- 更新前端 API 和页面组件(新增创建流程功能)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
wkc
2026-01-20 18:20:23 +08:00
parent 4511f91e91
commit f2448ff97f
15 changed files with 656 additions and 7 deletions

View File

@@ -0,0 +1,24 @@
# Change: 添加利率定价流程管理功能
## Why
当前系统缺少利率定价流程的管理能力。业务人员需要能够发起利率定价申请、查询历史定价记录、查看定价详情。这是贷款定价系统的核心功能需求。
## What Changes
- 创建新的 Maven 模块 `ruoyi-loan-pricing` 用于利率定价相关功能
- 新增利率定价流程的发起接口
- 新增利率定价流程的列表查询接口(支持分页和多条件筛选)
- 新增根据业务方流水号查看详情的接口
- 创建数据库表存储利率定价流程数据
- 添加对应的实体类、Mapper、Service、Controller
## Impact
- **Affected specs:** 新增 `loan-pricing-workflow` 能力规格
- **Affected code:**
- **新增 `ruoyi-loan-pricing` Maven 模块** - 包含 Domain、Mapper、Service
- 修改 `pom.xml` 添加新模块依赖
- 新增 `ruoyi-admin` 模块下的 Controller
- 新增数据库表和 MyBatis XML 映射文件
- 新增前端 API 接口定义和页面组件(待后续阶段实现)

View File

@@ -0,0 +1,73 @@
## ADDED Requirements
### Requirement: 利率定价流程发起
系统 SHALL 提供利率定价流程发起接口,允许业务人员创建新的利率定价申请。
#### Scenario: 成功发起利率定价流程
- **WHEN** 业务人员提交包含必填字段(custIsn、custType、guarType、applyAmt、loanRate)的完整申请
- **THEN** 系统自动生成业务方流水号(serialNum)并保存记录,返回成功响应
#### Scenario: 自动生成业务方流水号
- **WHEN** 发起利率定价流程时
- **THEN** 系统使用时间戳自动生成唯一的业务方流水号,无需用户输入
#### Scenario: 记录创建和更新信息
- **WHEN** 利率定价流程创建成功
- **THEN** 系统自动记录创建者、创建时间、更新者、更新时间
#### Scenario: 字段验证-必填字段
- **WHEN** 提交的申请缺少必填字段(custIsn、custType、guarType、applyAmt、loanRate)
- **THEN** 系统返回参数验证失败的错误信息
#### Scenario: 字段验证-固定值字段
- **WHEN** 提交的申请中 orgCode 非 "931000" 或 runType 非 "1"
- **THEN** 系统返回参数验证失败的错误信息
#### Scenario: 字段验证-枚举值
- **WHEN** 提交的申请中 custType 不是"个人"或"企业"
- **THEN** 系统返回参数验证失败的错误信息
#### Scenario: 字段验证-担保方式
- **WHEN** 提交的申请中 guarType 不是"信用"、"保证"、"抵押"、"质押"之一
- **THEN** 系统返回参数验证失败的错误信息
### Requirement: 利率定价流程列表查询
系统 SHALL 提供利率定价流程列表查询接口,支持分页和多条件筛选。
#### Scenario: 默认按更新时间倒序排列
- **WHEN** 业务人员查询利率定价流程列表
- **THEN** 结果按更新时间(update_time)倒序排列
#### Scenario: 支持分页查询
- **WHEN** 业务人员指定页码和每页数量查询列表
- **THEN** 系统返回对应页的数据及总记录数
#### Scenario: 按创建者筛选
- **WHEN** 业务人员按创建者筛选查询
- **THEN** 系统返回该创建者创建的利率定价流程记录
#### Scenario: 按客户名称筛选
- **WHEN** 业务人员按客户名称(custName)模糊查询
- **THEN** 系统返回客户名称包含查询条件的记录
#### Scenario: 按机构号筛选
- **WHEN** 业务人员按机构号(orgCode)筛选查询
- **THEN** 系统返回该机构号的利率定价流程记录
#### Scenario: 组合条件筛选
- **WHEN** 业务人员同时指定多个筛选条件
- **THEN** 系统返回同时满足所有条件的记录
### Requirement: 利率定价流程详情查询
系统 SHALL 提供根据业务方流水号查询流程详情的接口。
#### Scenario: 根据业务方流水号查询详情
- **WHEN** 业务人员提供有效的业务方流水号(serialNum)
- **THEN** 系统返回该流程的所有字段信息
#### Scenario: 查询不存在的流水号
- **WHEN** 业务人员查询的业务方流水号不存在
- **THEN** 系统返回"记录不存在"的错误信息

View File

@@ -0,0 +1,78 @@
## 1. 创建新 Maven 模块
- [x] 1.1 创建 `ruoyi-loan-pricing` 模块目录结构
- [x] 1.2 创建 `ruoyi-loan-pricing/pom.xml`
- 继承父 pom
- 添加 `ruoyi-common` 依赖
- 添加 MyBatis Plus 依赖
- 添加 Spring Boot 相关依赖
- [x] 1.3 修改根 `pom.xml`
-`<modules>` 中添加 `ruoyi-loan-pricing` 模块
-`dependencyManagement` 中添加模块依赖管理
- [x] 1.4 修改 `ruoyi-admin/pom.xml`
- 添加 `ruoyi-loan-pricing` 模块依赖
## 2. 数据库设计与实现
- [x] 2.1 设计利率定价流程数据库表结构
- 包含所有必需字段(24个字段)
- 添加主键、索引
- 添加审计字段(create_by, create_time, update_by, update_time)
- [x] 2.2 创建数据库表 SQL 脚本
## 3. 后端实体类开发
- [x] 3.1 在 `ruoyi-loan-pricing` 模块中创建 `LoanPricingWorkflow` 实体类
- 使用 `@Data` 注解
- 使用 `@TableName` 映射数据库表名
- 所有字段添加数据库映射注解
- 手动添加审计字段(createBy, createTime, updateBy, updateTime)
- [x] 3.2 添加字段验证注解(@NotNull@NotBlank等)
## 4. 后端 Mapper 层开发
- [x] 4.1 在 `ruoyi-loan-pricing` 模块中创建 `LoanPricingWorkflowMapper` 接口
- 继承 MyBatis Plus 的 `BaseMapper<LoanPricingWorkflow>`
- 定义自定义查询方法(如果需要)
- [x] 4.2 创建 MyBatis XML 映射文件(如果需要自定义 SQL)
## 5. 后端 Service 层开发
- [x] 5.1 在 `ruoyi-loan-pricing` 模块中创建 `ILoanPricingWorkflowService` 接口
- 定义发起流程方法 `createLoanPricing`
- 定义列表查询方法 `selectLoanPricingList`
- 定义详情查询方法 `selectLoanPricingBySerialNum`
- [x] 5.2 创建 `LoanPricingWorkflowServiceImpl` 实现类
- 实现业务逻辑
- 生成业务方流水号(时间戳)
- 实现分页查询
- 实现多条件筛选
## 6. 后端 Controller 层开发
- [x] 6.1 在 `ruoyi-admin` 模块中创建 `LoanPricingWorkflowController` 控制器
- 添加 `@RestController``@RequestMapping` 注解
- 添加 SpringDoc/OpenAPI 注解用于生成 API 文档
- 实现发起接口 `POST /loanPricing/workflow/create`
- 实现列表查询接口 `GET /loanPricing/workflow/list`
- 实现详情查询接口 `GET /loanPricing/workflow/{serialNum}`
- [x] 6.2 添加操作日志注解 `@Log`
- [x] 6.3 添加 SpringDoc 注解生成 API 文档
- 使用 `@Tag` 定义控制器标签
- 使用 `@Operation` 定义接口描述
- 使用 `@Parameter` 定义参数说明
## 7. 测试与验证
- [x] 7.1 编写单元测试(可选)
- [x] 7.2 使用 Postman 或 Swagger UI 进行接口测试
- [x] 7.3 验证所有场景(成功和失败场景)
## 8. 文档与配置
- [x] 8.1 确认 MyBatis Plus 配置正确
- [x] 8.2 确认数据库表已创建
- [x] 8.3 验证 API 文档自动生成
- 访问 `/swagger-ui.html` 确认接口文档已生成
- 验证接口描述、参数说明、响应示例完整
- [x] 8.4 创建 API 接口文档 Markdown 文件