# 模型参数配置功能 - 后端实体类创建

## 任务概述

**任务编号:** 01
**任务名称:** 数据库设计与后端实体类创建
**前置任务:** 无
**预计工时:** 1.5小时

## 任务目标

创建模型参数配置功能的数据库表和初始化数据,以及所有后端实体类、DTO、VO和Maven模块配置。

---

## 开发步骤

### 1. 创建 Maven 模块

#### 1.1 创建模块目录

在项目根目录下创建 `ccdi-project` 模块:

```
ccdi-project/
├── pom.xml
└── src/main/
    ├── java/
    └── resources/
```

#### 1.2 编写 pom.xml

**文件路径:** `ccdi-project/pom.xml`

```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>ccdi</artifactId>
        <groupId>com.ruoyi</groupId>
        <version>1.0.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>ccdi-project</artifactId>

    <dependencies>
        <!-- 通用工具 -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common</artifactId>
        </dependency>
    </dependencies>
</project>
```

#### 1.3 修改根 pom.xml

**文件路径:** `pom.xml` (项目根目录)

在 `<modules>` 标签中添加:

```xml
<modules>
    ...
    <module>ccdi-project</module>
</modules>
```

#### 1.4 修改 ruoyi-admin/pom.xml

**文件路径:** `ruoyi-admin/pom.xml`

在 `<dependencies>` 标签中添加:

```xml
<!-- 项目管理模块 -->
<dependency>
    <groupId>com.ruoyi</groupId>
    <artifactId>ccdi-project</artifactId>
</dependency>
```

---

### 2. 创建数据库脚本

#### 2.1 编写建表脚本

**文件路径:** `sql/ccdi_model_param.sql`

```sql
-- ----------------------------
-- 1. 创建模型参数配置表
-- ----------------------------
DROP TABLE IF EXISTS `ccdi_model_param`;
CREATE TABLE `ccdi_model_param` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `project_id` bigint DEFAULT 0 COMMENT '项目ID(0表示默认参数,其他值为具体项目ID)',
  `model_code` varchar(100) NOT NULL COMMENT '模型编码',
  `model_name` varchar(100) NOT NULL COMMENT '模型名称',
  `param_code` varchar(100) NOT NULL COMMENT '参数编码',
  `param_name` varchar(100) NOT NULL COMMENT '监测项名称',
  `param_desc` varchar(500) DEFAULT NULL COMMENT '参数描述',
  `param_value` varchar(200) NOT NULL COMMENT '参数值',
  `param_unit` varchar(50) DEFAULT NULL COMMENT '参数单位',
  `sort_order` int DEFAULT 0 COMMENT '排序号(参数展示顺序)',
  `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_project_model_param` (`project_id`, `model_code`, `param_code`) COMMENT '同一项目下模型参数唯一',
  KEY `idx_project_id` (`project_id`) COMMENT '项目ID索引',
  KEY `idx_model_code` (`model_code`) COMMENT '模型编码索引'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='模型参数配置表';

-- ----------------------------
-- 2. 初始化大额交易模型参数
-- ----------------------------
INSERT INTO ccdi_model_param (project_id, model_code, model_name, param_code, param_name, param_desc, param_value, param_unit, sort_order, create_by, remark) VALUES
(0, 'LARGE_TRANSACTION', '大额交易模型', 'SINGLE_TRANSACTION_AMOUNT', '单笔交易额', '单笔超过该金额视为大额交易', '50000', '元', 1, 'admin', '系统默认参数'),
(0, 'LARGE_TRANSACTION', '大额交易模型', 'CUMULATIVE_TRANSACTION_AMOUNT', '累计交易额', '年累计交易额超过该金额', '5000000', '元', 2, 'admin', '系统默认参数'),
(0, 'LARGE_TRANSACTION', '大额交易模型', 'LARGE_CASH_DEPOSIT', '大额存现', '单笔存现金额超过', '200000', '元', 3, 'admin', '系统默认参数'),
(0, 'LARGE_TRANSACTION', '大额交易模型', 'FREQUENT_CASH_DEPOSIT', '短时多次存现', '24小时内累计存现超过', '100000', '元/4小时', 4, 'admin', '系统默认参数'),
(0, 'LARGE_TRANSACTION', '大额交易模型', 'FREQUENT_TRANSFER', '频繁转账', '单日转账次数超过', '10', '次/日', 5, 'admin', '系统默认参数'),
(0, 'LARGE_TRANSACTION', '大额交易模型', 'TRANSFER_FREQUENCY', '转账频率', '单日累计转账金额超过', '1000000', '元/日', 6, 'admin', '系统默认参数');

-- ----------------------------
-- 3. 初始化可疑兼职模型参数
-- ----------------------------
INSERT INTO ccdi_model_param (project_id, model_code, model_name, param_code, param_name, param_desc, param_value, param_unit, sort_order, create_by, remark) VALUES
(0, 'SUSPICIOUS_PART_TIME', '可疑兼职模型', 'MONTHLY_FIXED_INCOME', '月度固定收入', '除本行工资外,每月固定收入超过', '5000', '元/月', 1, 'admin', '系统默认参数'),
(0, 'SUSPICIOUS_PART_TIME', '可疑兼职模型', 'FIXED_COUNTERPARTY_TRANSFER', '固定对手转入', '每季从固定交易对手转入金额', '15000', '元/季', 2, 'admin', '系统默认参数'),
(0, 'SUSPICIOUS_PART_TIME', '可疑兼职模型', 'SUSPICIOUS_TIME_TRANSACTION', '非工作时间交易', '非工作时间(22:00-06:00)交易次数', '20', '次/月', 3, 'admin', '系统默认参数');

-- ----------------------------
-- 4. 初始化可疑外汇交易模型参数
-- ----------------------------
INSERT INTO ccdi_model_param (project_id, model_code, model_name, param_code, param_name, param_desc, param_value, param_unit, sort_order, create_by, remark) VALUES
(0, 'SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易模型', 'SINGLE_PURCHASE_AMOUNT', '单笔购汇金额', '单笔购汇超过该金额', '50000', '美元/笔', 1, 'admin', '系统默认参数'),
(0, 'SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易模型', 'SINGLE_SETTLEMENT_AMOUNT', '单笔结汇金额', '单笔结汇超过该金额', '50000', '美元/笔', 2, 'admin', '系统默认参数'),
(0, 'SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易模型', 'CROSS_BORDER_REMITTANCE', '跨境汇款金额', '跨境汇款金额超过', '200000', '美元/笔', 3, 'admin', '系统默认参数'),
(0, 'SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易模型', 'MONTHLY_PURCHASE_TOTAL', '月度购汇总额', '月度购汇总额超过', '100000', '美元/月', 4, 'admin', '系统默认参数'),
(0, 'SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易模型', 'MONTHLY_SETTLEMENT_TOTAL', '月度结汇总额', '月度结汇总额超过', '100000', '美元/月', 5, 'admin', '系统默认参数'),
(0, 'SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易模型', 'FREQUENT_FOREX_TRADE', '频繁外汇交易', '单日外汇交易次数超过', '5', '次/日', 6, 'admin', '系统默认参数');
```

#### 2.2 执行数据库脚本

**使用MCP连接数据库执行:**

```bash
# 通过MCP工具连接数据库并执行SQL脚本
# 注意:不使用命令行的mysql,使用MCP连接项目配置文件中的数据库
```

---

### 3. 创建实体类

#### 3.1 创建包结构

```
ccdi-project/src/main/java/com/ruoyi/ccdi/project/
├── domain/
│   ├── CcdiModelParam.java
│   ├── dto/
│   └── vo/
```

#### 3.2 创建 Entity

**文件路径:** `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/CcdiModelParam.java`

```java
package com.ruoyi.ccdi.project.domain;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import java.util.Date;

/**
 * 模型参数配置 ccdi_model_param
 */
@Data
@TableName("ccdi_model_param")
public class CcdiModelParam {

    /** 主键ID */
    @TableId(type = IdType.AUTO)
    private Long id;

    /** 项目ID(0表示默认参数) */
    private Long projectId;

    /** 模型编码 */
    private String modelCode;

    /** 模型名称 */
    private String modelName;

    /** 参数编码 */
    private String paramCode;

    /** 监测项名称 */
    private String paramName;

    /** 参数描述 */
    private String paramDesc;

    /** 参数值 */
    private String paramValue;

    /** 参数单位 */
    private String paramUnit;

    /** 排序号 */
    private Integer sortOrder;

    /** 创建者 */
    private String createBy;

    /** 创建时间 */
    private Date createTime;

    /** 更新者 */
    private String updateBy;

    /** 更新时间 */
    private Date updateTime;

    /** 备注 */
    private String remark;
}
```

---

### 4. 创建 DTO

#### 4.1 查询 DTO

**文件路径:** `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/ModelParamQueryDTO.java`

```java
package com.ruoyi.ccdi.project.domain.dto;

import lombok.Data;
import jakarta.validation.constraints.NotBlank;

/**
 * 模型参数查询DTO
 */
@Data
public class ModelParamQueryDTO {

    /** 项目ID */
    private Long projectId;

    /** 模型编码 */
    @NotBlank(message = "模型编码不能为空")
    private String modelCode;
}
```

#### 4.2 保存 DTO

**文件路径:** `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/ModelParamSaveDTO.java`

```java
package com.ruoyi.ccdi.project.domain.dto;

import lombok.Data;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import java.util.List;

/**
 * 模型参数保存DTO
 */
@Data
public class ModelParamSaveDTO {

    /** 项目ID */
    private Long projectId;

    /** 模型编码 */
    @NotBlank(message = "模型编码不能为空")
    private String modelCode;

    /** 模型名称 */
    @NotBlank(message = "模型名称不能为空")
    private String modelName;

    /** 参数列表 */
    @NotNull(message = "参数列表不能为空")
    private List<ParamItem> params;

    @Data
    public static class ParamItem {

        /** 参数编码 */
        @NotBlank(message = "参数编码不能为空")
        private String paramCode;

        /** 监测项名称 */
        private String paramName;

        /** 参数描述 */
        private String paramDesc;

        /** 参数值 - 唯一可修改字段 */
        @NotBlank(message = "参数值不能为空")
        private String paramValue;

        /** 参数单位 */
        private String paramUnit;

        /** 排序号 */
        private Integer sortOrder;
    }
}
```

---

### 5. 创建 VO

#### 5.1 参数 VO

**文件路径:** `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/ModelParamVO.java`

```java
package com.ruoyi.ccdi.project.domain.vo;

import lombok.Data;

/**
 * 模型参数VO
 */
@Data
public class ModelParamVO {

    /** 主键ID */
    private Long id;

    /** 模型编码 */
    private String modelCode;

    /** 模型名称 */
    private String modelName;

    /** 参数编码 */
    private String paramCode;

    /** 监测项名称 */
    private String paramName;

    /** 参数描述 */
    private String paramDesc;

    /** 参数值 */
    private String paramValue;

    /** 参数单位 */
    private String paramUnit;

    /** 排序号 */
    private Integer sortOrder;
}
```

#### 5.2 模型列表 VO

**文件路径:** `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/ModelListVO.java`

```java
package com.ruoyi.ccdi.project.domain.vo;

import lombok.Data;

/**
 * 模型列表VO
 */
@Data
public class ModelListVO {

    /** 模型编码 */
    private String modelCode;

    /** 模型名称 */
    private String modelName;
}
```

---

## 验证清单

完成以下验证后,本任务才算完成:

**数据库部分:**

- [ ] sql/ccdi_model_param.sql 脚本创建完成
- [ ] 数据库表创建成功
- [ ] 初始化数据插入成功(3个模型共15条参数)

**后端部分:**

- [ ] ccdi-project 模块创建成功
- [ ] 根 pom.xml 已添加模块
- [ ] ruoyi-admin/pom.xml 已添加依赖
- [ ] CcdiModelParam 实体类创建完成
- [ ] ModelParamQueryDTO 创建完成
- [ ] ModelParamSaveDTO 创建完成
- [ ] ModelParamVO 创建完成
- [ ] ModelListVO 创建完成
- [ ] 项目编译无错误: `mvn clean compile`

---

## 注意事项

**数据库部分:**

1. **执行顺序**: 必须先创建数据库表,再创建实体类
2. **使用MCP**: 使用MCP连接数据库执行SQL,不使用命令行mysql
3. **数据验证**: 执行后验证3个模型的15条参数数据是否正确插入

**后端部分:**

1. **包名规范**: 必须使用 `com.ruoyi.ccdi.project` 作为基础包名
2. **注解使用**: 实体类使用 `@Data` 注解,不继承 BaseEntity
3. **字段验证**: DTO 中必须添加验证注解 `@NotBlank`、`@NotNull`
4. **注释完整**: 所有字段必须添加注释说明
5. **导入语句**: 禁止使用全限定类名,必须使用 import 语句

---

## 下一步

完成本任务后,进入下一个任务: **02-后端业务逻辑开发.md**
