loan-pricing/openspec/changes/add-loan-pricing-workflow/tasks.md

1. 创建新 Maven 模块

• 1.1 创建 ruoyi-loan-pricing 模块目录结构
• 1.2 创建 ruoyi-loan-pricing/pom.xml
  • 继承父 pom
  • 添加 ruoyi-common 依赖
  • 添加 MyBatis Plus 依赖
  • 添加 Spring Boot 相关依赖
• 1.3 修改根 pom.xml
  • 在 <modules> 中添加 ruoyi-loan-pricing 模块
  • 在 dependencyManagement 中添加模块依赖管理
• 1.4 修改 ruoyi-admin/pom.xml
  • 添加 ruoyi-loan-pricing 模块依赖

2. 数据库设计与实现

• 2.1 设计利率定价流程数据库表结构
  • 包含所有必需字段(24个字段)
  • 添加主键、索引
  • 添加审计字段(create_by, create_time, update_by, update_time)
• 2.2 创建数据库表 SQL 脚本

3. 后端实体类开发

• 3.1 在 ruoyi-loan-pricing 模块中创建 LoanPricingWorkflow 实体类
  • 使用 @Data 注解
  • 使用 @TableName 映射数据库表名
  • 所有字段添加数据库映射注解
  • 手动添加审计字段(createBy, createTime, updateBy, updateTime)
• 3.2 添加字段验证注解(@NotNull、@NotBlank等)

4. 后端 Mapper 层开发

• 4.1 在 ruoyi-loan-pricing 模块中创建 LoanPricingWorkflowMapper 接口
  • 继承 MyBatis Plus 的 BaseMapper<LoanPricingWorkflow>
  • 定义自定义查询方法(如果需要)
• 4.2 创建 MyBatis XML 映射文件(如果需要自定义 SQL)

5. 后端 Service 层开发

• 5.1 在 ruoyi-loan-pricing 模块中创建 ILoanPricingWorkflowService 接口
  • 定义发起流程方法 createLoanPricing
  • 定义列表查询方法 selectLoanPricingList
  • 定义详情查询方法 selectLoanPricingBySerialNum
• 5.2 创建 LoanPricingWorkflowServiceImpl 实现类
  • 实现业务逻辑
  • 生成业务方流水号(时间戳)
  • 实现分页查询
  • 实现多条件筛选

6. 后端 Controller 层开发

• 6.1 在 ruoyi-admin 模块中创建 LoanPricingWorkflowController 控制器
  • 添加 @RestController 和 @RequestMapping 注解
  • 添加 SpringDoc/OpenAPI 注解用于生成 API 文档
  • 实现发起接口 POST /loanPricing/workflow/create
  • 实现列表查询接口 GET /loanPricing/workflow/list
  • 实现详情查询接口 GET /loanPricing/workflow/{serialNum}
• 6.2 添加操作日志注解 @Log
• 6.3 添加 SpringDoc 注解生成 API 文档
  • 使用 @Tag 定义控制器标签
  • 使用 @Operation 定义接口描述
  • 使用 @Parameter 定义参数说明

7. 测试与验证

• 7.1 编写单元测试(可选)
• 7.2 使用 Postman 或 Swagger UI 进行接口测试
• 7.3 验证所有场景(成功和失败场景)

8. 文档与配置

• 8.1 确认 MyBatis Plus 配置正确
• 8.2 确认数据库表已创建
• 8.3 验证 API 文档自动生成
  • 访问 /swagger-ui.html 确认接口文档已生成
  • 验证接口描述、参数说明、响应示例完整
• 8.4 创建 API 接口文档 Markdown 文件