参数配置

2026-02-25 16:56:04 +08:00
parent 1437989d5b
commit 5d13f7cd01
9 changed files with 167 additions and 4428 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,6 +2,29 @@

 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

+## 快速参考
+
+**启动项目:**
+- 后端: `mvn spring-boot:run` 或运行 `ry.bat`
+- 前端: `cd ruoyi-ui && npm run dev`
+
+**访问地址:**
+- 前端: http://localhost:80
+- 后端: http://localhost:8080
+- Swagger: http://localhost:8080/swagger-ui/index.html
+- Druid 监控: http://localhost:8080/druid/ (ruoyi/123456)
+
+**测试账号:**
+- 用户名: `admin`
+- 密码: `admin123`
+
+**获取 Token:**
+```bash
+POST http://localhost:8080/login/test?username=admin&password=admin123
+```
+
+---
+
 ## 项目概述

 **纪检初核系统** - 基于 **若依管理系统 v3.9.1** 构建的企业级前后端分离管理系统，用于员工异常行为风险识别。
@@ -62,10 +85,23 @@ npm run preview
 ### 数据库初始化

 ```bash
+# 初始化若依框架基础表
 mysql -u root -p < sql/ry_20250522.sql
+
+# 初始化定时任务表
 mysql -u root -p < sql/quartz.sql
+
+# 导入业务表（根据需要执行）
+mysql -u root -p ccdi < sql/dpc_employee.sql
+mysql -u root -p ccdi < sql/dpc_intermediary_blacklist.sql
+# ... 其他业务表脚本
 ```

+**注意:**
+- 业务表脚本文件名以 `ccdi_` 或 `dpc_` 开头
+- 部分脚本包含菜单数据，需要按顺序执行
+- 数据库需要先创建（数据库名: `ccdi`）
+
 ---

 ## 模块架构
@@ -95,8 +131,15 @@ ruoyi-admin (启动模块)
    ├── ruoyi-quartz (定时任务)
    ├── ruoyi-generator (代码生成)
    └── ruoyi-info-collection (信息采集模块)
+        └── 依赖 ruoyi-common
 ```

+**添加新业务模块:**
+1. 在根目录 `pom.xml` 的 `<modules>` 中添加新模块
+2. 在新模块的 `pom.xml` 中添加对 `ruoyi-common` 的依赖
+3. 在 `ruoyi-admin/pom.xml` 中添加对新模块的依赖
+4. 在新模块中按照分层规范创建 controller/service/mapper/domain 包
+
 ### ruoyi-info-collection 业务模块 (核心)

 自定义业务模块，包含以下核心功能：
@@ -161,6 +204,14 @@ public class CcdiBaseStaff {
 - **Controller**: 所有接口添加 Swagger 注释，分页使用 MyBatis Plus Page
 - **Service**: 简单 CRUD 用 MyBatis Plus 方法，复杂操作在 XML 写 SQL
 - **DTO/VO**: 接口传参使用独立 DTO，返回使用独立 VO，不与 entity 混用
+- **Mapper**: 简单操作继承 BaseMapper，复杂操作在 XML 中定义
+
+### 禁止事项
+
+- **禁止使用全限定类名**: 必须使用 `import` 语句导入类，不要在代码中使用 `java.util.List` 这样的全限定名
+- **禁止使用 `extends ServiceImpl<>`**: Service 接口和实现类分离定义
+- **禁止 Entity 混用**: DTO、VO、Excel 类必须独立，不与 Entity 混用
+- **禁止缺少 `@Resource`**: Service 注入必须使用 `@Resource` 注解

 ### API 响应格式

@@ -234,9 +285,20 @@ public AjaxResult getImportStatus(@PathVariable String taskId) {
 }
 ```

+**导入流程:**
+1. 前端上传 Excel 文件
+2. 后端异步处理，返回 taskId
+3. 前端轮询 `/import/status/{taskId}` 获取导入进度
+4. 导入完成后，可获取成功/失败数据统计
+
+**导入结果处理:**
+- 只返回导入失败的数据（含失败原因）
+- 成功数据不返回，减少响应体积
+- 支持批量插入，提高性能
+
 ### EasyExcel 字典下拉框

-导入模板支持字典下拉框配置，提升数据录入准确性。
+导入模板支持字典下拉框配置，提升数据录入准确性。使用 `DictDropdownWriteHandler` 实现。

 ### 权限控制

@@ -272,6 +334,24 @@ POST /login/test?username=admin&password=admin123
 - 生成可执行的测试脚本进行验证
 - 测试完成后保存接口输出并生成测试用例报告

+### 开发调试技巧
+
+**使用 Swagger 测试接口:**
+1. 访问 `/swagger-ui/index.html`
+2. 点击接口展开详情
+3. 点击 "Try it out" 进行测试
+4. 填写参数后点击 "Execute" 执行
+
+**查看 SQL 执行日志:**
+- 在 `application.yml` 中设置日志级别: `com.ruoyi: debug`
+- 使用 Druid 监控台查看慢 SQL
+
+**前端代理配置:**
+前端开发服务器通过代理转发请求到后端：
+- 前端地址: `http://localhost:80`
+- 后端地址: `http://localhost:8080`
+- 代理配置文件: `ruoyi-ui/vue.config.js`
+
 ---

 ## 配置说明
@@ -293,6 +373,30 @@ POST /login/test?username=admin&password=admin123
 | 数据库连接    | `application-dev.yml`                                |
 | Redis 配置 | `application-dev.yml`                                |

+### 数据源配置
+
+项目使用 Druid 连接池，支持主从分离（默认关闭从库）：
+
+- **数据库连接**: `jdbc:mysql://host:3306/ccdi`
+- **初始连接数**: 5
+- **最小连接数**: 10
+- **最大连接数**: 20
+- **慢 SQL 记录**: 超过 1000ms 的 SQL 会被记录
+
+### Redis 配置
+
+- **默认端口**: 6379
+- **数据库索引**: 0
+- **连接超时**: 10s
+
+### Druid 监控台
+
+访问地址: `http://localhost:8080/druid/`
+- 用户名: `ruoyi`
+- 密码: `123456`
+
+用于监控 SQL 执行情况、连接池状态等。
+
 ---

 ## 重要文件路径
@@ -360,3 +464,65 @@ doc/
 ## 沟通规范

 - 永远使用简体中文进行思考和对话
+
+---
+
+## 常见问题排查
+
+### 数据库连接失败
+
+**检查项:**
+1. 确认 MySQL 服务已启动
+2. 检查 `application-dev.yml` 中的数据库连接配置
+3. 确认数据库用户名和密码正确
+4. 检查数据库是否已创建（数据库名: `ccdi`）
+
+### Redis 连接失败
+
+**检查项:**
+1. 确认 Redis 服务已启动
+2. 检查 `application-dev.yml` 中的 Redis 配置
+3. 如果 Redis 不需要密码，将 `password` 配置注释掉
+
+### 前端无法访问后端接口
+
+**检查项:**
+1. 确认后端已启动（端口 8080）
+2. 检查前端代理配置（`ruoyi-ui/vue.config.js`）
+3. 确认后端接口路径正确（查看 Controller 的 `@RequestMapping`）
+
+### 导入功能无响应
+
+**检查项:**
+1. 检查文件大小是否超过限制（默认 10MB）
+2. 查看后端日志是否有异常
+3. 确认 Excel 模板格式正确
+4. 检查必填字段是否为空
+
+---
+
+## MyBatis Plus 分页使用
+
+```java
+// Controller 层
+@GetMapping("/list")
+public TableDataInfo list(QueryDTO queryDTO) {
+    PageDomain pageDomain = TableSupport.buildPageRequest();
+    Page<VO> page = new Page<>(pageDomain.getPageNum(), pageDomain.getPageSize());
+    Page<VO> result = service.selectPage(page, queryDTO);
+    return getDataTable(result.getRecords(), result.getTotal());
+}
+
+// Service 层
+Page<VO> selectPage(Page<VO> page, QueryDTO queryDTO);
+
+// Mapper 层 (使用 XML)
+<select id="selectPage" resultType="VO">
+    SELECT * FROM table_name
+    <where>
+        <if test="queryDTO.name != null">
+            AND name LIKE CONCAT('%', #{queryDTO.name}, '%')
+        </if>
+    </where>
+</select>
+```
--- a/doc/参数配置功能/ScreenShot_2026-02-25_162807_126.png
+++ b/doc/参数配置功能/ScreenShot_2026-02-25_162807_126.png
--- a/doc/参数配置功能/ScreenShot_2026-02-25_162819_927.png
+++ b/doc/参数配置功能/ScreenShot_2026-02-25_162819_927.png
--- a/doc/参数配置功能/ScreenShot_2026-02-25_162831_473.png
+++ b/doc/参数配置功能/ScreenShot_2026-02-25_162831_473.png
--- a/doc/参数配置功能/task.md
+++ b/doc/参数配置功能/task.md
--- a/docs/plans/2026-02-11-cust-fmy-relation-backend.md
+++ b/docs/plans/2026-02-11-cust-fmy-relation-backend.md
--- a/docs/plans/2026-02-11-cust-fmy-relation-frontend.md
+++ b/docs/plans/2026-02-11-cust-fmy-relation-frontend.md
--- a/docs/plans/2026-02-11-cust-fmy-relation-implementation.md
+++ b/docs/plans/2026-02-11-cust-fmy-relation-implementation.md
@@ -1,962 +0,0 @@
-# 信贷客户家庭关系维护功能实施计划
-
-> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
-
-**目标:** 开发信贷客户家庭关系维护功能，实现对信贷客户家庭成员信息的完整CRUD操作
-
-**架构:** 完全复用员工亲属关系维护功能的实现逻辑，创建独立模块 `CustFamilyRelation`，新建独立表 `ccdi_cust_fmy_relation`
-
-**技术栈:** Spring Boot 3.5.8 + MyBatis Plus 3.5.10 + Vue 2.6.12 + Element UI 2.15.14 + EasyExcel + Redis
-
---
-
-## 前置准备
-
-### Task 0: 创建数据库表
-
-**Files:**
- Create: `sql/ccdi_cust_fmy_relation.sql`
-
-**Step 1: 创建建表SQL文件**
-
-```sql
-- 信贷客户家庭关系表
-CREATE TABLE `ccdi_cust_fmy_relation` (
-  `id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `person_id` VARCHAR(50) NOT NULL COMMENT '信贷客户身份证号',
-  `relation_type` VARCHAR(50) NOT NULL COMMENT '关系类型',
-  `relation_name` VARCHAR(100) NOT NULL COMMENT '关系人姓名',
-  `gender` CHAR(1) DEFAULT NULL COMMENT '性别：M-男，F-女，O-其他',
-  `birth_date` DATE DEFAULT NULL COMMENT '关系人出生日期',
-  `relation_cert_type` VARCHAR(50) NOT NULL COMMENT '证件类型',
-  `relation_cert_no` VARCHAR(50) NOT NULL COMMENT '证件号码',
-  `mobile_phone1` VARCHAR(20) DEFAULT NULL COMMENT '手机号码1',
-  `mobile_phone2` VARCHAR(20) DEFAULT NULL COMMENT '手机号码2',
-  `wechat_no1` VARCHAR(50) DEFAULT NULL COMMENT '微信名称1',
-  `wechat_no2` VARCHAR(50) DEFAULT NULL COMMENT '微信名称2',
-  `wechat_no3` VARCHAR(50) DEFAULT NULL COMMENT '微信名称3',
-  `contact_address` VARCHAR(500) DEFAULT NULL COMMENT '详细联系地址',
-  `relation_desc` VARCHAR(500) DEFAULT NULL COMMENT '关系详细描述',
-  `status` INT NOT NULL DEFAULT 1 COMMENT '状态：0-无效，1-有效',
-  `effective_date` DATETIME DEFAULT NULL COMMENT '关系生效日期',
-  `invalid_date` DATETIME DEFAULT NULL COMMENT '关系失效日期',
-  `remark` TEXT COMMENT '备注信息',
-  `data_source` VARCHAR(50) DEFAULT NULL COMMENT '数据来源：MANUAL-手动录入，IMPORT-批量导入',
-  `is_emp_family` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否是员工的家庭关系：0-否',
-  `is_cust_family` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '是否是信贷客户的家庭关系：1-是',
-  `created_by` VARCHAR(50) NOT NULL COMMENT '记录创建人',
-  `updated_by` VARCHAR(50) DEFAULT NULL COMMENT '记录更新人',
-  `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '记录创建时间',
-  `update_time` DATETIME DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '记录更新时间',
-  PRIMARY KEY (`id`),
-  KEY `idx_person_id` (`person_id`),
-  KEY `idx_relation_cert_no` (`relation_cert_no`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='信贷客户家庭关系表';
-```
-
-**Step 2: 执行SQL创建表**
-
-Run: 连接数据库并执行 `sql/ccdi_cust_fmy_relation.sql`
-Expected: 表创建成功
-
-**Step 3: Commit**
-
-```bash
-git add sql/ccdi_cust_fmy_relation.sql
-git commit -m "feat: 创建信贷客户家庭关系表"
-```
-
---
-
-## 后端开发
-
-### Task 1: 创建实体类
-
-**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiCustFmyRelation.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiStaffFmyRelation.java:1-108`
-
-**Step 1: 创建实体类**
-
-复制 `CcdiStaffFmyRelation.java`，修改以下内容：
- 类名: `CcdiCustFmyRelation`
- 注释: `信贷客户家庭关系对象 ccdi_cust_fmy_relation`
- 表名: `@TableName("ccdi_cust_fmy_relation")`
- JavaDoc: 全部替换"员工"为"信贷客户"
-
-```java
-package com.ruoyi.ccdi.domain;
-
-import com.baomidou.mybatisplus.annotation.*;
-import lombok.Data;
-
-import java.io.Serial;
-import java.io.Serializable;
-import java.util.Date;
-
-/**
- * 信贷客户家庭关系对象 ccdi_cust_fmy_relation
- *
- * @author ruoyi
- * @date 2026-02-11
- */
-@Data
-@TableName("ccdi_cust_fmy_relation")
-public class CcdiCustFmyRelation implements Serializable {
-
-    @Serial
-    private static final long serialVersionUID = 1L;
-
-    /** 主键ID */
-    @TableId(type = IdType.AUTO)
-    private Long id;
-
-    /** 信贷客户身份证号 */
-    private String personId;
-
-    /** 关系类型 */
-    private String relationType;
-
-    /** 关系人姓名 */
-    private String relationName;
-
-    /** 性别：M-男，F-女，O-其他 */
-    private String gender;
-
-    /** 出生日期 */
-    private Date birthDate;
-
-    /** 关系人证件类型 */
-    private String relationCertType;
-
-    /** 关系人证件号码 */
-    private String relationCertNo;
-
-    /** 手机号码1 */
-    private String mobilePhone1;
-
-    /** 手机号码2 */
-    private String mobilePhone2;
-
-    /** 微信名称1 */
-    private String wechatNo1;
-
-    /** 微信名称2 */
-    private String wechatNo2;
-
-    /** 微信名称3 */
-    private String wechatNo3;
-
-    /** 详细联系地址 */
-    private String contactAddress;
-
-    /** 关系详细描述 */
-    private String relationDesc;
-
-    /** 状态：0-无效，1-有效 */
-    private Integer status;
-
-    /** 生效日期 */
-    private Date effectiveDate;
-
-    /** 失效日期 */
-    private Date invalidDate;
-
-    /** 备注 */
-    private String remark;
-
-    /** 数据来源：MANUAL-手工录入，IMPORT-导入 */
-    private String dataSource;
-
-    /** 是否是员工亲属：0-否 */
-    private Boolean isEmpFamily;
-
-    /** 是否是客户亲属：1-是 */
-    private Boolean isCustFamily;
-
-    /** 创建时间 */
-    @TableField(fill = FieldFill.INSERT)
-    private Date createTime;
-
-    /** 更新时间 */
-    @TableField(fill = FieldFill.INSERT_UPDATE)
-    private Date updateTime;
-
-    /** 创建人 */
-    @TableField(fill = FieldFill.INSERT)
-    private String createdBy;
-
-    /** 更新人 */
-    @TableField(fill = FieldFill.INSERT_UPDATE)
-    private String updatedBy;
-}
-```
-
-**Step 2: Compile**
-
-Run: `mvn compile -pl ruoyi-ccdi`
-Expected: BUILD SUCCESS
-
-**Step 3: Commit**
-
-```bash
-git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/CcdiCustFmyRelation.java
-git commit -m "feat: 添加信贷客户家庭关系实体类"
-```
-
---
-
-### Task 2: 创建DTO类
-
-**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiCustFmyRelationAddDTO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiCustFmyRelationEditDTO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiCustFmyRelationQueryDTO.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/CcdiStaffFmyRelationAddDTO.java`
-
-**Step 1: 创建AddDTO**
-
-复制 `CcdiStaffFmyRelationAddDTO.java`，修改：
- 类名: `CcdiCustFmyRelationAddDTO`
- 注释中"员工" → "信贷客户"
- personId字段注释: `@Schema(description = "信贷客户身份证号")`
- 验证消息: "员工身份证号" → "信贷客户身份证号"
-
-**Step 2: 创建EditDTO**
-
-复制 `CcdiStaffFmyRelationEditDTO.java`，修改：
- 类名: `CcdiCustFmyRelationEditDTO`
- 注释中"员工" → "信贷客户"
- 添加 `id` 字段和 `@NotNull` 验证
-
-**Step 3: 创建QueryDTO（简化版）**
-
-```java
-package com.ruoyi.ccdi.domain.dto;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-import lombok.Data;
-
-import java.io.Serial;
-import java.io.Serializable;
-
-/**
- * 信贷客户家庭关系查询DTO
- *
- * @author ruoyi
- * @date 2026-02-11
- */
-@Data
-@Schema(description = "信贷客户家庭关系查询")
-public class CcdiCustFmyRelationQueryDTO implements Serializable {
-
-    @Serial
-    private static final long serialVersionUID = 1L;
-
-    /** 信贷客户身份证号 */
-    @Schema(description = "信贷客户身份证号")
-    private String personId;
-
-    /** 关系类型 */
-    @Schema(description = "关系类型")
-    private String relationType;
-
-    /** 关系人姓名 */
-    @Schema(description = "关系人姓名")
-    private String relationName;
-}
-```
-
-**Step 4: Compile**
-
-Run: `mvn compile -pl ruoyi-ccdi`
-Expected: BUILD SUCCESS
-
-**Step 5: Commit**
-
-```bash
-git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/dto/
-git commit -m "feat: 添加信贷客户家庭关系DTO类"
-```
-
---
-
-### Task 3: 创建VO类
-
-**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiCustFmyRelationVO.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CustFmyRelationImportFailureVO.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/CcdiStaffFmyRelationVO.java`
-
-**Step 1: 创建主VO**
-
-复制 `CcdiStaffFmyRelationVO.java`，修改：
- 类名: `CcdiCustFmyRelationVO`
- 移除 `personName` 字段（不关联其他表）
- 注释中"员工" → "信贷客户"
-
-**Step 2: 创建导入失败VO**
-
-复制 `StaffFmyRelationImportFailureVO.java`，修改：
- 类名: `CustFmyRelationImportFailureVO`
- 注释中"员工" → "信贷客户"
-
-**Step 3: Compile**
-
-Run: `mvn compile -pl ruoyi-ccdi`
-Expected: BUILD SUCCESS
-
-**Step 4: Commit**
-
-```bash
-git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/vo/
-git commit -m "feat: 添加信贷客户家庭关系VO类"
-```
-
---
-
-### Task 4: 创建Excel类
-
-**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiCustFmyRelationExcel.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiStaffFmyRelationExcel.java`
-
-**Step 1: 创建Excel类**
-
-复制 `CcdiStaffFmyRelationExcel.java`，修改：
- 类名: `CcdiCustFmyRelationExcel`
- 注释: `信贷客户家庭关系Excel导入导出对象`
- personId字段: `@ExcelProperty(value = "信贷客户身份证号*", index = 0)`
- 其他保持不变
-
-**Step 2: Compile**
-
-Run: `mvn compile -pl ruoyi-ccdi`
-Expected: BUILD SUCCESS
-
-**Step 3: Commit**
-
-```bash
-git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/domain/excel/CcdiCustFmyRelationExcel.java
-git commit -m "feat: 添加信贷客户家庭关系Excel类"
-```
-
---
-
-### Task 5: 创建Mapper接口
-
-**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiCustFmyRelationMapper.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiStaffFmyRelationMapper.java`
-
-**Step 1: 创建Mapper接口**
-
-复制 `CcdiStaffFmyRelationMapper.java`，修改：
- 包名和导入: 全部 `Staff` → `Cust`
- 类名: `CcdiCustFmyRelationMapper`
- 泛型: `CcdiCustFmyRelation`
- DTO: `CcdiCustFmyRelationQueryDTO`
- VO: `CcdiCustFmyRelationVO`
- 方法注释: "员工" → "信贷客户"
-
-**Step 2: Compile**
-
-Run: `mvn compile -pl ruoyi-ccdi`
-Expected: BUILD SUCCESS
-
-**Step 3: Commit**
-
-```bash
-git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/mapper/CcdiCustFmyRelationMapper.java
-git commit -m "feat: 添加信贷客户家庭关系Mapper接口"
-```
-
---
-
-### Task 6: 创建Mapper XML映射
-
-**Files:**
- Create: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiCustFmyRelationMapper.xml`
- Reference: `ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiStaffFmyRelationMapper.xml`
-
-**Step 1: 创建XML映射文件**
-
-复制 `CcdiStaffFmyRelationMapper.xml`，修改：
- namespace: `com.ruoyi.ccdi.mapper.CcdiCustFmyRelationMapper`
- resultMap: `CcdiCustFmyRelationVOResult`
- type: `com.ruoyi.ccdi.domain.vo.CcdiCustFmyRelationVO`
- 表名: `ccdi_cust_fmy_relation`
- **移除 LEFT JOIN**（不关联员工表）
- WHERE条件: `r.is_cust_family = 1`
- **移除 personName 相关字段**
-
-```xml
-<!-- 关键修改：移除LEFT JOIN和person_name -->
-<select id="selectRelationPage" resultMap="CcdiCustFmyRelationVOResult">
-    SELECT
-        r.id, r.person_id, r.relation_type, r.relation_name,
-        r.gender, r.birth_date, r.relation_cert_type, r.relation_cert_no,
-        r.mobile_phone1, r.mobile_phone2, r.wechat_no1, r.wechat_no2, r.wechat_no3,
-        r.contact_address, r.relation_desc, r.effective_date, r.invalid_date,
-        r.status, r.remark, r.data_source, r.is_emp_family, r.is_cust_family,
-        r.created_by, r.create_time, r.updated_by, r.update_time
-    FROM ccdi_cust_fmy_relation r
-    <where>
-        r.is_cust_family = 1
-        <if test="query.personId != null and query.personId != ''">
-            AND r.person_id = #{query.personId}
-        </if>
-        <if test="query.relationType != null and query.relationType != ''">
-            AND r.relation_type = #{query.relationType}
-        </if>
-        <if test="query.relationName != null and query.relationName != ''">
-            AND r.relation_name LIKE CONCAT('%', #{query.relationName}, '%')
-        </if>
-    </where>
-    ORDER BY r.create_time DESC
-</select>
-```
-
- selectExistingRelations: `is_cust_family = 1`
-
-**Step 2: Compile**
-
-Run: `mvn compile -pl ruoyi-ccdi`
-Expected: BUILD SUCCESS
-
-**Step 3: Commit**
-
-```bash
-git add ruoyi-ccdi/src/main/resources/mapper/ccdi/CcdiCustFmyRelationMapper.xml
-git commit -m "feat: 添加信贷客户家庭关系Mapper XML映射"
-```
-
---
-
-### Task 7: 创建Service接口
-
-**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiCustFmyRelationService.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiCustFmyRelationImportService.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/ICcdiStaffFmyRelationService.java`
-
-**Step 1: 创建主Service接口**
-
-复制 `ICcdiStaffFmyRelationService.java`，修改：
- 接口名: `ICcdiCustFmyRelationService`
- 泛型: `CcdiCustFmyRelationVO`, `CcdiCustFmyRelationQueryDTO`, `CcdiCustFmyRelationAddDTO`, `CcdiCustFmyRelationEditDTO`, `CcdiCustFmyRelationExcel`
-
-**Step 2: 创建导入Service接口**
-
-复制 `ICcdiStaffFmyRelationImportService.java`，修改：
- 接口名: `ICcdiCustFmyRelationImportService`
- 泛型: `CcdiCustFmyRelationExcel`, `CustFmyRelationImportFailureVO`
-
-**Step 3: Compile**
-
-Run: `mvn compile -pl ruoyi-ccdi`
-Expected: BUILD SUCCESS
-
-**Step 4: Commit**
-
-```bash
-git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/
-git commit -m "feat: 添加信贷客户家庭关系Service接口"
-```
-
---
-
-### Task 8: 创建Service实现类
-
-**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiCustFmyRelationServiceImpl.java`
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiCustFmyRelationImportServiceImpl.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/CcdiStaffFmyRelationServiceImpl.java`
-
-**Step 1: 创建主Service实现类**
-
-复制 `CcdiStaffFmyRelationServiceImpl.java`，修改：
- 类名: `CcdiCustFmyRelationServiceImpl`
- Mapper注入: `CcdiCustFmyRelationMapper`
- ImportService注入: `ICcdiCustFmyRelationImportService`
- 泛型: `CcdiCustFmyRelationVO`, `CcdiCustFmyRelationQueryDTO` 等
- **关键修改**:
-  - `relation.setIsEmpFamily(false);`
-  - `relation.setIsCustFamily(true);`
-  - Redis Key: `import:custFmyRelation:`
-
-**Step 2: 创建导入Service实现类**
-
-复制 `CcdiStaffFmyRelationImportServiceImpl.java`，修改：
- 类名: `CcdiCustFmyRelationImportServiceImpl`
- Mapper注入: `CcdiCustFmyRelationMapper`
- 泛型: `CcdiCustFmyRelationExcel`, `CustFmyRelationImportFailureVO`
- Redis Key: `import:custFmyRelation:`
- 错误消息: "信贷客户身份证号"
-
-**Step 3: Compile**
-
-Run: `mvn compile -pl ruoyi-ccdi`
-Expected: BUILD SUCCESS
-
-**Step 4: Commit**
-
-```bash
-git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/service/impl/
-git commit -m "feat: 添加信贷客户家庭关系Service实现类"
-```
-
---
-
-### Task 9: 创建Controller
-
-**Files:**
- Create: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiCustFmyRelationController.java`
- Reference: `ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiStaffFmyRelationController.java`
-
-**Step 1: 创建Controller**
-
-复制 `CcdiStaffFmyRelationController.java`，修改：
- 类名: `CcdiCustFmyRelationController`
- Tag: `@Tag(name = "信贷客户家庭关系管理")`
- RequestMapping: `/ccdi/custFmyRelation`
- Service注入: `ICcdiCustFmyRelationService`, `ICcdiCustFmyRelationImportService`
- DTO/VO: 对应的 `CcdiCust...` 类型
- 权限标识: `ccdi:custFmyRelation:*`
- 注释: "员工" → "信贷客户"
-
-**Step 2: Compile**
-
-Run: `mvn compile -pl ruoyi-ccdi`
-Expected: BUILD SUCCESS
-
-**Step 3: Commit**
-
-```bash
-git add ruoyi-ccdi/src/main/java/com/ruoyi/ccdi/controller/CcdiCustFmyRelationController.java
-git commit -m "feat: 添加信贷客户家庭关系Controller"
-```
-
---
-
-## 前端开发
-
-### Task 10: 创建API接口文件
-
-**Files:**
- Create: `ruoyi-ui/src/api/ccdiCustFmyRelation.js`
- Reference: `ruoyi-ui/src/api/ccdiStaffFmyRelation.js`
-
-**Step 1: 创建API文件**
-
-复制 `ccdiStaffFmyRelation.js`，修改：
- url路径: `/ccdi/custFmyRelation`
- 移除 `getStaffList` 方法（不需要）
-
-```javascript
-import request from '@/utils/request'
-
-// 查询信贷客户家庭关系列表
-export function listRelation(query) {
-  return request({
-    url: '/ccdi/custFmyRelation/list',
-    method: 'get',
-    params: query
-  })
-}
-
-// 查询信贷客户家庭关系详细
-export function getRelation(id) {
-  return request({
-    url: '/ccdi/custFmyRelation/' + id,
-    method: 'get'
-  })
-}
-
-// 新增信贷客户家庭关系
-export function addRelation(data) {
-  return request({
-    url: '/ccdi/custFmyRelation',
-    method: 'post',
-    data: data
-  })
-}
-
-// 修改信贷客户家庭关系
-export function updateRelation(data) {
-  return request({
-    url: '/ccdi/custFmyRelation',
-    method: 'put',
-    data: data
-  })
-}
-
-// 删除信贷客户家庭关系
-export function delRelation(ids) {
-  return request({
-    url: '/ccdi/custFmyRelation/' + ids,
-    method: 'delete'
-  })
-}
-
-// 导出信贷客户家庭关系
-export function exportRelation(query) {
-  return request({
-    url: '/ccdi/custFmyRelation/export',
-    method: 'post',
-    params: query
-  })
-}
-
-// 下载导入模板
-export function importTemplate() {
-  return request({
-    url: '/ccdi/custFmyRelation/importTemplate',
-    method: 'post'
-  })
-}
-
-// 导入信贷客户家庭关系
-export function importData(file) {
-  const formData = new FormData()
-  formData.append('file', file)
-  return request({
-    url: '/ccdi/custFmyRelation/importData',
-    method: 'post',
-    data: formData
-  })
-}
-
-// 查询导入状态
-export function getImportStatus(taskId) {
-  return request({
-    url: '/ccdi/custFmyRelation/importStatus/' + taskId,
-    method: 'get'
-  })
-}
-
-// 查询导入失败记录
-export function getImportFailures(taskId, pageNum, pageSize) {
-  return request({
-    url: '/ccdi/custFmyRelation/importFailures/' + taskId,
-    method: 'get',
-    params: { pageNum, pageSize }
-  })
-}
-```
-
-**Step 2: Commit**
-
-```bash
-git add ruoyi-ui/src/api/ccdiCustFmyRelation.js
-git commit -m "feat: 添加信贷客户家庭关系API接口"
-```
-
---
-
-### Task 11: 创建主页面组件
-
-**Files:**
- Create: `ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue`
- Reference: `ruoyi-ui/src/views/ccdiStaffFmyRelation/index.vue`
-
-**Step 1: 创建页面组件**
-
-复制 `ccdiStaffFmyRelation/index.vue`，修改：
-
-1. **查询条件**（简化版）：
-```vue
-<!-- 移除员工姓名输入框，只保留personId、relationType、relationName -->
-<el-form-item label="信贷客户身份证号" prop="personId">
-  <el-input
-    v-model="queryParams.personId"
-    placeholder="请输入信贷客户身份证号"
-    clearable
-    style="width: 240px"
-    @keyup.enter.native="handleQuery"
-  />
-</el-form-item>
-<el-form-item label="关系类型" prop="relationType">
-  <el-select v-model="queryParams.relationType" placeholder="请选择关系类型" clearable style="width: 240px">
-    <el-option
-      v-for="dict in dict.type.ccdi_relation_type"
-      :key="dict.value"
-      :label="dict.label"
-      :value="dict.value"
-    />
-  </el-select>
-</el-form-item>
-<el-form-item label="关系人姓名" prop="relationName">
-  <el-input
-    v-model="queryParams.relationName"
-    placeholder="请输入关系人姓名"
-    clearable
-    style="width: 240px"
-    @keyup.enter.native="handleQuery"
-  />
-</el-form-item>
-<!-- 移除状态下拉框 -->
-```
-
-2. **列表列**（移除personName）：
-```vue
-<el-table-column label="信贷客户身份证号" align="center" prop="personId" width="180"/>
-<!-- 移除员工姓名列 -->
-```
-
-3. **表单**（使用普通输入框）：
-```vue
-<!-- 信贷客户身份证号改为普通输入框，不使用远程搜索 -->
-<el-form-item label="信贷客户身份证号" prop="personId">
-  <el-input
-    v-model="form.personId"
-    placeholder="请输入信贷客户身份证号"
-    :disabled="!isAdd"
-    maxlength="18"
-  />
-</el-form-item>
-```
-
-4. **权限标识**：全部 `staffFmyRelation` → `custFmyRelation`
-
-5. **导入localStorage**：
-```javascript
-const STORAGE_KEY = 'cust_fmy_relation_import_last_task';
-```
-
-6. **字典类型**：
-```vue
-<dict-tag :options="dict.type.ccdi_relation_type" :value="scope.row.relationType"/>
-<dict-tag :options="dict.type.ccdi_indiv_gender" :value="scope.row.gender"/>
-```
-
-**Step 2: Commit**
-
-```bash
-git add ruoyi-ui/src/views/ccdiCustFmyRelation/index.vue
-git commit -m "feat: 添加信贷客户家庭关系页面组件"
-```
-
---
-
-## 系统配置
-
-### Task 12: 创建菜单权限SQL
-
-**Files:**
- Create: `sql/ccdi_cust_fmy_relation_menu.sql`
- Reference: `sql/ccdi_staff_fmy_relation_menu.sql`
-
-**Step 1: 创建菜单SQL**
-
-```sql
-- 信贷客户家庭关系菜单
-INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, update_by, update_time, remark)
-VALUES
-('信贷客户家庭关系', (SELECT menu_id FROM sys_menu WHERE menu_name = '信息维护' LIMIT 1), 5, 'custFmyRelation', 'ccdiCustFmyRelation/index', 1, 0, 'C', '0', '0', 'ccdi:custFmyRelation:list', 'peoples', 'admin', NOW(), '', NULL, '信贷客户家庭关系菜单');
-
-- 获取刚插入的菜单ID
-SET @parent_id = LAST_INSERT_ID();
-
-- 添加按钮权限
-INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, update_by, update_time, remark) VALUES
-('信贷客户家庭关系查询', @parent_id, 1, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:query', '#', 'admin', NOW(), '', NULL, ''),
-('信贷客户家庭关系新增', @parent_id, 2, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:add', '#', 'admin', NOW(), '', NULL, ''),
-('信贷客户家庭关系修改', @parent_id, 3, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:edit', '#', 'admin', NOW(), '', NULL, ''),
-('信贷客户家庭关系删除', @parent_id, 4, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:remove', '#', 'admin', NOW(), '', NULL, ''),
-('信贷客户家庭关系导出', @parent_id, 5, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:export', '#', 'admin', NOW(), '', NULL, ''),
-('信贷客户家庭关系导入', @parent_id, 6, '#', '', 1, 0, 'F', '0', '0', 'ccdi:custFmyRelation:import', '#', 'admin', NOW(), '', NULL, '');
-```
-
-**Step 2: Commit**
-
-```bash
-git add sql/ccdi_cust_fmy_relation_menu.sql
-git commit -m "feat: 添加信贷客户家庭关系菜单权限"
-```
-
---
-
-### Task 13: 配置字典数据
-
-**Files:**
- Modify: 通过系统管理界面配置
-
-**Step 1: 确认字典存在**
-
-登录系统 → 系统管理 → 字典管理，确认以下字典类型已存在：
- `ccdi_relation_type`：关系类型
- `ccdi_indiv_gender`：性别
- `ccdi_certificate_type`：证件类型
-
-如不存在，参考员工亲属关系的字典数据添加。
-
---
-
-## 测试验证
-
-### Task 14: 后端接口测试
-
-**Files:**
- Create: `doc/reviews/cust-fmy-relation-api-test.md`
-
-**Step 1: 启动后端服务**
-
-Run: `mvn spring-boot:run -pl ruoyi-admin`
-Expected: 服务启动成功，访问 http://localhost:8080/swagger-ui/index.html
-
-**Step 2: 测试登录获取token**
-
-Run:
-```bash
-curl -X POST "http://localhost:8080/login" \
-  -H "Content-Type: application/json" \
-  -d '{"username":"admin","password":"admin123"}'
-```
-Expected: 返回token
-
-**Step 3: 测试查询列表接口**
-
-Run:
-```bash
-curl -X GET "http://localhost:8080/ccdi/custFmyRelation/list?pageNum=1&pageSize=10" \
-  -H "Authorization: Bearer <token>"
-```
-Expected: 返回空列表（无数据）
-
-**Step 4: 测试新增接口**
-
-Run:
-```bash
-curl -X POST "http://localhost:8080/ccdi/custFmyRelation" \
-  -H "Authorization: Bearer <token>" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "personId": "110101199001011234",
-    "relationType": "配偶",
-    "relationName": "张三",
-    "gender": "M",
-    "relationCertType": "身份证",
-    "relationCertNo": "110101199001015678"
-  }'
-```
-Expected: 返回成功
-
-**Step 5: 测试查询详情接口**
-
-Run:
-```bash
-curl -X GET "http://localhost:8080/ccdi/custFmyRelation/1" \
-  -H "Authorization: Bearer <token>"
-```
-Expected: 返回刚插入的记录
-
---
-
-### Task 15: 前端功能测试
-
-**Step 1: 启动前端服务**
-
-Run: `cd ruoyi-ui && npm run dev`
-Expected: 服务启动成功，访问 http://localhost
-
-**Step 2: 登录系统**
-
-用户名: admin
-密码: admin123
-
-**Step 3: 导航到信贷客户家庭关系页面**
-
-路径: 信息维护 → 信贷客户家庭关系
-
-**Step 4: 测试新增功能**
-
-1. 点击"新增"按钮
-2. 填写表单：
-   - 信贷客户身份证号: `110101199001011234`
-   - 关系类型: `配偶`
-   - 关系人姓名: `张三`
-   - 性别: `男`
-   - 证件类型: `身份证`
-   - 证件号码: `110101199001015678`
-3. 点击"确定"
-Expected: 新增成功，列表显示新记录
-
-**Step 5: 测试编辑功能**
-
-1. 点击"编辑"按钮
-2. 修改关系人姓名为 `张三丰`
-3. 点击"确定"
-Expected: 修改成功，列表显示更新
-
-**Step 6: 测试删除功能**
-
-1. 勾选记录
-2. 点击"删除"按钮
-3. 确认删除
-Expected: 删除成功，列表不再显示该记录
-
-**Step 7: 测试导出功能**
-
-1. 添加几条测试数据
-2. 点击"导出"按钮
-Expected: 下载Excel文件，数据正确
-
-**Step 8: 测试导入功能**
-
-1. 点击"导入"按钮
-2. 下载模板
-3. 填写数据后上传
-4. 等待异步导入完成
-Expected: 导入成功，显示结果通知
-
---
-
-### Task 16: API文档生成
-
-**Step 1: 访问Swagger文档**
-
-URL: http://localhost:8080/swagger-ui/index.html
-Expected: 看到"信贷客户家庭关系管理"分组，所有接口正常显示
-
-**Step 2: 导出API文档**
-
-使用 Swagger 导出功能，保存到: `doc/api-docs/cust-fmy-relation-api.md`
-
---
-
-## 完成检查清单
-
- [ ] 数据库表创建成功
- [ ] 后端所有类编译通过
- [ ] Controller所有接口在Swagger正常显示
- [ ] 前端页面正常加载
- [ ] 增删改查功能正常
- [ ] 导入导出功能正常
- [ ] 权限控制生效
- [ ] 字典数据正确显示
- [ ] 测试文档完整
-
---
-
-## 预期结果
-
-完成后，系统将具备以下功能：
-
-1. **信贷客户家庭关系管理页面**
-   - 列表展示（分页）
-   - 简化查询（身份证号、关系类型、关系人姓名）
-   - 新增/编辑/删除/详情
-
-2. **导入导出功能**
-   - 带字典下拉框的Excel模板
-   - 异步导入，实时状态查询
-   - 失败记录查看
-
-3. **权限控制**
-   - 完整的CRUD权限
-   - 按钮级权限控制
-
-4. **数据隔离**
-   - 独立表 `ccdi_cust_fmy_relation`
-   - `is_cust_family = 1`
--- a/docs/plans/2026-02-11-cust-fmy-relation-import-alignment.md
+++ b/docs/plans/2026-02-11-cust-fmy-relation-import-alignment.md
@@ -1,373 +0,0 @@
-# 信贷客户家庭关系导入功能对齐方案
-
-## 概述
-
-本文档描述了如何将**信贷客户家庭关系**功能的导入实现完全对齐到**员工亲属关系**的成熟模式。
-
-**参考模板**: `CcdiStaffEnterpriseRelationImportServiceImpl`
-**修改对象**: `CcdiCustFmyRelationImportServiceImpl`
-
-## 设计目标
-
-1. 提升代码质量和可维护性
-2. 优化性能,避免 N+1 查询问题
-3. 改善用户体验,提供详细的导入进度和状态反馈
-4. 统一日志记录和错误处理机制
-
-## 架构调整
-
-### 1. 引入导入工具类
-
-复用 `ImportLogUtils` 进行统一的日志记录:
- 导入开始/结束日志
- 批量查询日志
- 进度跟踪日志
- 验证错误日志
- 批量操作日志
-
-### 2. Redis 状态管理升级
-
-**现状**: 简单 String 值存储状态
-```
-"COMPLETED:10:5"
-```
-
-**优化**: Hash 结构存储详细状态
-```java
-{
-  "taskId": "uuid",
-  "status": "SUCCESS" | "PARTIAL_SUCCESS" | "PROCESSING",
-  "totalCount": 100,
-  "successCount": 95,
-  "failureCount": 5,
-  "progress": 100,
-  "startTime": 1234567890,
-  "endTime": 1234567900,
-  "message": "成功95条,失败5条"
-}
-```
-
- 过期时间: 7 天
- 失败记录: 单独 Key, JSON 序列化, 7 天过期
-
-### 3. 批量查询优化
-
-**实现 `batchExistsByCombinations` 方法**:
- 提取所有 `person_id + relation_type + relation_cert_no` 组合
- 一次性批量查询已存在的组合
- 避免循环查询导致的 N+1 问题
-
-### 4. 导入结果封装
-
-创建/复用统一的 VO:
- `ImportStatusVO`: 导入状态详情
- `ImportResultVO`: 导入提交结果
- `CustFmyRelationImportFailureVO`: 失败记录详情
-
-## 数据验证逻辑
-
-### 唯一性检查
-
-**优化前**: 每条记录单独查询
-```java
-for (excel : excels) {
-    CcdiCustFmyRelation existing = mapper.selectExistingRelations(...);
-    // N 次数据库查询
-}
-```
-
-**优化后**: 批量查询
-```java
-Set<String> existingCombinations = getExistingCombinations(excels);
-// 1 次数据库查询
-
-for (excel : excels) {
-    String combination = excel.getPersonId() + "|" + ...;
-    if (existingCombinations.contains(combination)) {
-        throw new RuntimeException("该关系已存在");
-    }
-}
-```
-
-### Excel 内部重复检查
-
-```java
-Set<String> processedCombinations = new HashSet<>();
-
-for (excel : excels) {
-    String combination = ...;
-
-    if (processedCombinations.contains(combination)) {
-        throw new RuntimeException("该关系在导入文件中重复");
-    }
-
-    processedCombinations.add(combination);
-}
-```
-
-### 验证规则
-
-**必填字段**:
- 信贷客户身份证号
- 关系类型
- 关系人姓名
- 关系人证件类型
- 关系人证件号码
-
-**格式验证**:
- 身份证号: 18位有效格式
- 证件号码: 根据证件类型验证
-
-**长度限制**:
- 关系人姓名: ≤ 50
- 关系类型: ≤ 20
- 证件号码: ≤ 50
-
-## 批量操作优化
-
-### 分批插入策略
-
-```java
-private void saveBatch(List<CcdiCustFmyRelation> list, int batchSize) {
-    for (int i = 0; i < list.size(); i += batchSize) {
-        int end = Math.min(i + batchSize, list.size());
-        List<CcdiCustFmyRelation> subList = list.subList(i, end);
-        mapper.insertBatch(subList);
-    }
-}
-
-// 调用: 每 500 条为一批
-saveBatch(newRecords, 500);
-```
-
-### 批量操作日志
-
-```
-开始批量插入: 总批次数=5, 每批大小=500
-批量插入完成: 成功=2500, 耗时=1234ms
-```
-
-## 失败记录处理
-
-### 失败记录数据结构
-
-```java
-public class CustFmyRelationImportFailureVO {
-    private Integer rowNum;           // Excel 行号
-    private String personId;          // 信贷客户身份证号
-    private String relationType;      // 关系类型
-    private String relationName;      // 关系人姓名
-    private String errorMessage;      // 错误消息
-}
-```
-
-### Redis 存储优化
-
-**Key**: `import:custFmyRelation:{taskId}:failures`
-**序列化**: JSON
-**过期时间**: 7 天
-**反序列化**:
-```java
-return JSON.parseArray(
-    JSON.toJSONString(failuresObj),
-    CustFmyRelationImportFailureVO.class
-);
-```
-
-## Controller 层调整
-
-### 导入接口
-
-```java
-@PostMapping("/importData")
-public AjaxResult importData(@RequestParam("file") MultipartFile file) {
-    List<CcdiCustFmyRelationExcel> excels =
-        EasyExcelUtil.importExcel(file.getInputStream(), ...);
-
-    if (excels == null || excels.isEmpty()) {
-        return error("至少需要一条数据");
-    }
-
-    String taskId = relationService.importRelations(excels);
-
-    ImportResultVO result = new ImportResultVO();
-    result.setTaskId(taskId);
-    result.setStatus("PROCESSING");
-    result.setMessage("导入任务已提交,正在后台处理");
-
-    return AjaxResult.success("导入任务已提交,正在后台处理", result);
-}
-```
-
-### 导入状态查询
-
-```java
-@GetMapping("/importStatus/{taskId}")
-public AjaxResult getImportStatus(@PathVariable String taskId) {
-    ImportStatusVO statusVO = relationImportService.getImportStatus(taskId);
-    return success(statusVO);
-}
-```
-
-### 失败记录查询
-
-```java
-@GetMapping("/importFailures/{taskId}")
-public TableDataInfo getImportFailures(
-    @PathVariable String taskId,
-    @RequestParam(defaultValue = "1") Integer pageNum,
-    @RequestParam(defaultValue = "10") Integer pageSize
-) {
-    List<CustFmyRelationImportFailureVO> failures =
-        relationImportService.getImportFailures(taskId);
-
-    // 手动分页
-    int fromIndex = (pageNum - 1) * pageSize;
-    int toIndex = Math.min(fromIndex + pageSize, failures.size());
-
-    if (fromIndex >= failures.size()) {
-        return getDataTable(new ArrayList<>(), failures.size());
-    }
-
-    List<CustFmyRelationImportFailureVO> pageData =
-        failures.subList(fromIndex, toIndex);
-
-    return getDataTable(pageData, failures.size());
-}
-```
-
-## 导入模板改进
-
-### 使用字典下拉框
-
-```java
-@PostMapping("/importTemplate")
-public void importTemplate(HttpServletResponse response) {
-    EasyExcelUtil.importTemplateWithDictDropdown(
-        response,
-        CcdiCustFmyRelationExcel.class,
-        "信贷客户家庭关系"
-    );
-}
-```
-
-### Excel 实体注解增强
-
-```java
-@DictDropdown(type = "ccdi_relation_type")
-private String relationType;
-
-@DictDropdown(type = "ccdi_cert_type")
-private String relationCertType;
-```
-
-## 修改文件清单
-
-### 1. Service 层
- `CcdiCustFmyRelationImportServiceImpl.java` - 核心导入逻辑重构
- `CcdiCustFmyRelationServiceImpl.java` - 导入入口方法调整
-
-### 2. Controller 层
- `CcdiCustFmyRelationController.java` - 接口返回值优化
-
-### 3. Mapper 层
- `CcdiCustFmyRelationMapper.java` - 添加批量查询方法
- Mapper XML - 实现批量查询 SQL
-
-### 4. VO 类
- 检查/创建 `ImportStatusVO.java`
- 检查/创建 `ImportResultVO.java`
- 优化 `CustFmyRelationImportFailureVO.java`
-
-### 5. Excel 实体
- `CcdiCustFmyRelationExcel.java` - 添加字典注解
-
-### 6. 工具类
- 复用 `ImportLogUtils.java`
- 复用 `EasyExcelUtil.java`
-
-## 关键代码片段
-
-### Mapper 批量查询
-
-```java
-// Mapper 接口
-List<String> batchExistsByCombinations(
-    @Param("combinations") List<String> combinations
-);
-
-// XML 实现
-<select id="batchExistsByCombinations" resultType="string">
-    SELECT CONCAT(person_id, '|', relation_type, '|', relation_cert_no)
-    FROM ccdi_cust_fmy_relation
-    WHERE CONCAT(person_id, '|', relation_type, '|', relation_cert_no) IN
-    <foreach collection="combinations" item="combo" open="(" separator="," close=")">
-        #{combo}
-    </foreach>
-</select>
-```
-
-### 异步导入方法
-
-```java
-@Async
-@Transactional(rollbackFor = Exception.class)
-public void importRelationsAsync(
-    List<CcdiCustFmyRelationExcel> excels,
-    String taskId,
-    String userName  // 新增参数,用于审计
-) {
-    // 实现逻辑...
-}
-```
-
-## 实施步骤
-
-1. **添加 Mapper 批量查询方法**
-   - 在 Mapper 接口添加 `batchExistsByCombinations`
-   - 在 XML 实现 SQL
-
-2. **重构 ImportServiceImpl**
-   - 引入 `ImportLogUtils`
-   - 实现批量查询逻辑
-   - 添加 Excel 内部重复检查
-   - 优化 Redis 状态管理
-   - 改进失败记录存储
-
-3. **创建/优化 VO 类**
-   - 检查并复用已有的 `ImportStatusVO`
-   - 检查并复用已有的 `ImportResultVO`
-   - 优化失败记录 VO
-
-4. **调整 Controller**
-   - 修改导入接口返回值
-   - 优化状态查询接口
-   - 优化失败记录查询接口
-
-5. **更新 Excel 实体**
-   - 添加 `@DictDropdown` 注解
-
-6. **测试验证**
-   - 单元测试
-   - 集成测试
-   - 性能对比测试
-
-## 预期效果
-
-### 性能提升
- 批量查询: 从 N 次减少到 1 次
- 导入 1000 条数据预计提升 50-70%
-
-### 用户体验
- 实时进度反馈
- 详细的错误信息
- 清晰的成功/失败统计
-
-### 代码质量
- 统一的日志记录
- 完善的错误处理
- 更好的可维护性
-
-## 创建日期
-
-2026-02-11