接口变动

- 修改 settings.js 中 sideTheme 默认值从 'theme-dark' 改为 'theme-light'
- 新用户首次访问时将看到浅色模式侧边栏
- 老用户的自定义设置不受影响（localStorage 优先）

.gitignore

@@ -47,7 +47,12 @@ nul
 # Git Worktrees
 .worktrees/
 
-test/
+# Test output directories (not source code)
+**/target/test-classes/
+**/target/surefire-reports/
+
+# Test data files (keep test source code)
+*.test.log
 
 !*/build/*.java
 !*/build/*.html
@@ -62,3 +67,6 @@ doc/test-data/**/~$*
 db_config.conf
 
 ~*.*
+
+
+/.playwright-cli/

AGENTS.md

@@ -16,3 +16,169 @@ Use `@/openspec/AGENTS.md` to learn:
 Keep this managed block so 'openspec update' can refresh the instructions.
 
 <!-- OPENSPEC:END -->
+
+# AGENTS.md - AI Coding Assistant Guide
+
+## 项目概述
+
+基于若依 v3.9.1 的纪检初核系统，Java 21 + Spring Boot 3 + Vue 2
+
+---
+
+## Build / Lint / Test Commands
+
+### 后端 (Maven)
+
+```bash
+# 编译项目
+mvn clean compile
+
+# 运行应用
+mvn spring-boot:run
+
+# 打包部署
+mvn clean package
+
+# 运行单个测试类
+mvn test -Dtest=ClassName
+
+# 运行单个测试方法
+mvn test -Dtest=ClassName#methodName
+
+# 跳过测试
+mvn clean package -DskipTests
+```
+
+### 前端 (npm)
+
+```bash
+cd ruoyi-ui
+
+# 安装依赖
+npm install --registry=https://registry.npmmirror.com
+
+# 开发服务器
+npm run dev
+
+# 生产构建
+npm run build:prod
+```
+
+### API 测试
+
+```bash
+# 获取 Token (测试账号: admin/admin123)
+POST http://localhost:8080/login/test?username=admin&password=admin123
+
+# Swagger 文档
+http://localhost:8080/swagger-ui/index.html
+```
+
+---
+
+## 代码规范
+
+### Java 代码风格
+
+- **注解**: 使用 Lombok `@Data` 简化实体类
+- **依赖注入**: 使用 `@Resource` 而非 `@Autowired`
+- **实体类**: 不继承 BaseEntity，单独添加审计字段
+- **禁止**: 禁止使用全限定类名 (如 `java.util.List`)，必须 import
+
+```java
+@Data
+public class CcdiBaseStaff {
+    /** 创建者 */
+    private String createBy;
+    /** 创建时间 */
+    private Date createTime;
+    /** 更新者 */
+    private String updateBy;
+    /** 更新时间 */
+    private Date updateTime;
+}
+
+@Resource
+private ICcdiBaseStaffService baseStaffService;
+```
+
+### 分层规范
+
+- **Controller**: 添加 Swagger 注释，分页使用 MyBatis Plus Page
+- **Service**: 简单 CRUD 用 MyBatis Plus，复杂操作在 XML 写 SQL
+- **DTO/VO**: 接口传参用独立 DTO，返回用独立 VO，禁止与 entity 混用
+- **禁止**: 禁止 `extends ServiceImpl<>`
+
+### API 响应格式
+
+```java
+// 成功
+AjaxResult.success("操作成功", data);
+
+// 错误
+AjaxResult.error("操作失败");
+
+// 分页
+Page<CcdiBaseStaff> page = new Page<>(pageNum, pageSize);
+IPage<CcdiBaseStaff> result = baseStaffMapper.selectPage(page, queryWrapper);
+return AjaxResult.success(result);
+```
+
+### 数据库规范
+
+- 表名: `ccdi_` 前缀 (如 `ccdi_base_staff`)
+- 非业务字段 (create_by, create_time 等) 由后端自动处理，前端表单不显示
+
+### 前端规范
+
+- **目录结构**: `views/` 按功能模块组织，`api/` 对应后端 Controller
+- **API 调用**: 使用 `@/utils/request` 封装
+- **菜单联动**: 添加页面后需同步修改数据库 `sys_menu` 表
+
+### 导入功能规范
+
+- 批量操作提高性能
+- 返回结果只展示失败数据，不展示成功数据
+- 使用 EasyExcel + 异步处理大数据量导入
+
+---
+
+## 模块架构
+
+```
+ccdi/
+├── ruoyi-admin/           # 启动入口
+├── ruoyi-framework/       # 安全配置
+├── ruoyi-system/          # 系统模块
+├── ruoyi-common/          # 通用工具
+├── ccdi-info-collection/  # 信息采集 (员工、中介、黑名单)
+├── ccdi-project/          # 项目管理
+├── ccdi-lsfx/             # 流水分析对接
+└── ruoyi-ui/              # 前端
+```
+
+### 添加新模块
+
+1. 根 pom.xml 添加 `<module>`
+2. pom.xml 添加 `ruoyi-common` 依赖
+3. `ruoyi-admin/pom.xml` 添加模块依赖
+4. 按分层创建 controller/service/mapper/domain 包
+
+---
+
+## 常用路径
+
+| 用途 | 路径 |
+|------|------|
+| 应用入口 | `ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java` |
+| 信息采集 Controller | `ccdi-info-collection/src/main/java/com/ruoyi/info/collection/controller/` |
+| 项目管理 Controller | `ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/` |
+| 前端 API | `ruoyi-ui/src/api/` |
+| Vue 路由 | `ruoyi-ui/src/router/index.js` |
+
+---
+
+## 沟通规范
+
+- 使用简体中文进行思考和对话
+- 遇到 MCP 数据库操作时，使用项目配置文件中的数据库

assets/项目异步文件上传/task.md

@@ -1,10 +1,18 @@
 # 项目异步文件上传功能
 ## 数据库
-- 文件上传记录表：记录项目下所有文件的上传记录。项目id，流水分析平台的项目id，文件id，文件名称，文件大小，文件状态（上传中、解析中、解析成功、解析失败），主体名称，主体证件号，上传时间，上传人
+- 文件上传记录表：记录项目下所有文件的上传记录。项目id，流水分析平台的项目id，文件id，文件名称，文件大小，文件状态（上传中、解析中、解析成功、解析失败），主体名称，主体账号，上传时间，上传人
 
 ## 流程
 - 在项目详情的上传数据页面，点击流水导入的上传流水按钮
 - 批量选择文件，点击确认
 - 每个文件都需要调接口传输到流水分析平台。建一个线程池，然后每个文件一个线程进行异步处理。处理流程如下
-	1. 在文件上传表中插入一条该文件的记录，关联文件与项目，此时文件状态为上传中
+	1. 在文件上传表中插入一条该文件的记录，关联文件与项目和保存文件参数，此时文件状态为上传中
-	2. 调用流水分析平台的上传文件接口，
+	2. 调用流水分析平台的上传文件接口，获取返回参数中的logId，将状态更新为解析中并更新数据库
+	3. 轮询调用判断文件是否解析结束接口，间隔2秒，如果parsing为true继续，如果为false或者轮询达到300次则结束
+	4. 调用文件上传后获取单个文件上传后的状态接口，status等于-5且uploadStatusDesc等于data.wait.confirm.newaccount表示文件上传后解析成功，从返回值中获取enterpriseNameList更新到主体名称，accountNoList更新到主体账号，文件状态更新为解析成功；反之将文件状态更新为解析失败
+	5. 解析成功后，轮询调用获取流水列表并存储到兰溪本地接口，获取所有的流水，通过批量插入的方式保存到流水表中
+	
+## 设计
+- 线程池容量为100个线程。如果线程池空闲线程不足，则提示系统繁忙稍后再试
+- 方法中所有步骤添加完善的日志
+- 每次调用文件上传接口产生的日志单独生成一个日志文件，方便进行维护

ccdi-lsfx/src/main/java/com/ruoyi/lsfx/client/LsfxAnalysisClient.java

@@ -1,8 +1,10 @@
 package com.ruoyi.lsfx.client;
 
 import com.ruoyi.lsfx.constants.LsfxConstants;
+import com.ruoyi.lsfx.domain.request.DeleteFilesRequest;
 import com.ruoyi.lsfx.domain.request.FetchInnerFlowRequest;
 import com.ruoyi.lsfx.domain.request.GetBankStatementRequest;
+import com.ruoyi.lsfx.domain.request.GetFileUploadStatusRequest;
 import com.ruoyi.lsfx.domain.request.GetTokenRequest;
 import com.ruoyi.lsfx.domain.response.*;
 import com.ruoyi.lsfx.exception.LsfxApiException;
@@ -13,8 +15,9 @@ import jakarta.annotation.Resource;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Component;
-import org.springframework.web.multipart.MultipartFile;
 
+import java.io.File;
+import java.util.Arrays;
 import java.util.HashMap;
 import java.util.Map;
 
@@ -55,6 +58,12 @@ public class LsfxAnalysisClient {
     @Value("${lsfx.api.endpoints.get-bank-statement}")
     private String getBankStatementEndpoint;
 
+    @Value("${lsfx.api.endpoints.get-file-upload-status}")
+    private String getFileUploadStatusEndpoint;
+
+    @Value("${lsfx.api.endpoints.delete-files}")
+    private String deleteFilesEndpoint;
+
     /**
      * 获取Token
      */
@@ -100,8 +109,8 @@ public class LsfxAnalysisClient {
     /**
      * 上传文件
      */
-    public UploadFileResponse uploadFile(Integer groupId, MultipartFile file) {
+    public UploadFileResponse uploadFile(Integer groupId, File file) {
-        log.info("【流水分析】上传文件请求: groupId={}, fileName={}", groupId, file.getOriginalFilename());
+        log.info("【流水分析】上传文件请求: groupId={}, fileName={}", groupId, file.getName());
         long startTime = System.currentTimeMillis();
 
         try {
@@ -251,4 +260,108 @@ public class LsfxAnalysisClient {
             throw new LsfxApiException("获取银行流水失败: " + e.getMessage(), e);
         }
     }
+
+    /**
+     * 获取单个文件上传状态(接口5)
+     * 用途: 获取文件解析后的主体名称和账号等信息
+     *
+     * 关键判断:
+     * - status=-5 且 uploadStatusDesc="data.wait.confirm.newaccount" 表示解析成功
+     * - enterpriseNameList仅有一个空字符串""时,表示流水文件未生成主体
+     *
+     * @param request 请求参数(groupId必填, logId可选)
+     * @return 文件上传状态信息
+     */
+    public GetFileUploadStatusResponse getFileUploadStatus(GetFileUploadStatusRequest request) {
+        log.info("【流水分析】获取文件上传状态: groupId={}, logId={}",
+            request.getGroupId(), request.getLogId());
+        long startTime = System.currentTimeMillis();
+
+        try {
+            String url = baseUrl + getFileUploadStatusEndpoint;
+
+            // GET请求,构建查询参数
+            Map<String, Object> params = new HashMap<>();
+            params.put("groupId", request.getGroupId());
+            if (request.getLogId() != null) {
+                params.put("logId", request.getLogId());
+            }
+
+            Map<String, String> headers = new HashMap<>();
+            headers.put(LsfxConstants.HEADER_CLIENT_ID, clientId);
+
+            GetFileUploadStatusResponse response = httpUtil.get(url, params, headers,
+                GetFileUploadStatusResponse.class);
+
+            long elapsed = System.currentTimeMillis() - startTime;
+            if (response != null && response.getData() != null) {
+                log.info("【流水分析】获取文件上传状态成功: logId数量={}, 耗时={}ms",
+                    response.getData().getLogs() != null ? response.getData().getLogs().size() : 0,
+                    elapsed);
+            } else {
+                log.warn("【流水分析】获取文件上传状态响应异常: 耗时={}ms", elapsed);
+            }
+
+            return response;
+        } catch (LsfxApiException e) {
+            log.error("【流水分析】获取文件上传状态失败: groupId={}, error={}",
+                request.getGroupId(), e.getMessage(), e);
+            throw e;
+        } catch (Exception e) {
+            log.error("【流水分析】获取文件上传状态未知异常: groupId={}",
+                request.getGroupId(), e);
+            throw new LsfxApiException("获取文件上传状态失败: " + e.getMessage(), e);
+        }
+    }
+
+    /**
+     * 删除文件/主体(接口6)
+     * 用途: 删除解析失败或不需要的流水文件
+     *
+     * 使用场景:
+     * - 文件解析失败时清理文件
+     * - 删除错误上传的文件
+     *
+     * @param request 请求参数(groupId, logIds, userId必填)
+     * @return 删除结果
+     */
+    public DeleteFilesResponse deleteFiles(DeleteFilesRequest request) {
+        log.info("【流水分析】删除文件请求: groupId={}, logIds={}, userId={}",
+            request.getGroupId(), Arrays.toString(request.getLogIds()), request.getUserId());
+        long startTime = System.currentTimeMillis();
+
+        try {
+            String url = baseUrl + deleteFilesEndpoint;
+
+            // 构建form-data参数
+            Map<String, Object> params = new HashMap<>();
+            params.put("groupId", request.getGroupId());
+            params.put("logIds", request.getLogIds());  // 数组
+            params.put("userId", request.getUserId());
+
+            Map<String, String> headers = new HashMap<>();
+            headers.put(LsfxConstants.HEADER_CLIENT_ID, clientId);
+
+            DeleteFilesResponse response = httpUtil.postFormData(url, params, headers,
+                DeleteFilesResponse.class);
+
+            long elapsed = System.currentTimeMillis() - startTime;
+            if (response != null && response.getData() != null) {
+                log.info("【流水分析】删除文件成功: message={}, 耗时={}ms",
+                    response.getData().getMessage(), elapsed);
+            } else {
+                log.warn("【流水分析】删除文件响应异常: 耗时={}ms", elapsed);
+            }
+
+            return response;
+        } catch (LsfxApiException e) {
+            log.error("【流水分析】删除文件失败: groupId={}, error={}",
+                request.getGroupId(), e.getMessage(), e);
+            throw e;
+        } catch (Exception e) {
+            log.error("【流水分析】删除文件未知异常: groupId={}",
+                request.getGroupId(), e);
+            throw new LsfxApiException("删除文件失败: " + e.getMessage(), e);
+        }
+    }
 }

ccdi-lsfx/src/main/java/com/ruoyi/lsfx/constants/LsfxConstants.java

@@ -27,4 +27,12 @@ public class LsfxConstants {
 
     /** 默认角色 */
     public static final String DEFAULT_ROLE = "VIEWER";
+
+    // 新增:固定值常量(根据文档)
+    public static final String DEFAULT_USER_ID = "902001";
+    public static final String DEFAULT_USER_NAME = "902001";
+    public static final String DEFAULT_APP_ID = "remote_app";
+    public static final String DEFAULT_ORG_CODE = "902000";
+    public static final String DEFAULT_DEPARTMENT_CODE = "902000";
+    public static final String DEFAULT_DATA_CHANNEL_CODE = "ZJRCU";
 }

ccdi-lsfx/src/main/java/com/ruoyi/lsfx/controller/LsfxTestController.java

@@ -4,8 +4,11 @@ import com.ruoyi.common.annotation.Anonymous;
 import com.ruoyi.common.core.domain.AjaxResult;
 import com.ruoyi.common.utils.StringUtils;
 import com.ruoyi.lsfx.client.LsfxAnalysisClient;
+import com.ruoyi.lsfx.constants.LsfxConstants;
+import com.ruoyi.lsfx.domain.request.DeleteFilesRequest;
 import com.ruoyi.lsfx.domain.request.FetchInnerFlowRequest;
 import com.ruoyi.lsfx.domain.request.GetBankStatementRequest;
+import com.ruoyi.lsfx.domain.request.GetFileUploadStatusRequest;
 import com.ruoyi.lsfx.domain.request.GetTokenRequest;
 import com.ruoyi.lsfx.domain.response.*;
 import io.swagger.v3.oas.annotations.Operation;
@@ -15,6 +18,12 @@ import jakarta.annotation.Resource;
 import org.springframework.web.bind.annotation.*;
 import org.springframework.web.multipart.MultipartFile;
 
+import java.io.File;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.StandardCopyOption;
+
 /**
  * 流水分析平台接口测试控制器
  */
@@ -37,17 +46,19 @@ public class LsfxTestController {
         if (StringUtils.isBlank(request.getEntityName())) {
             return AjaxResult.error("参数不完整：entityName为必填");
         }
+
+        // 必填字段设置默认值
         if (StringUtils.isBlank(request.getUserId())) {
-            return AjaxResult.error("参数不完整：userId为必填");
+            request.setUserId(LsfxConstants.DEFAULT_USER_ID);
         }
         if (StringUtils.isBlank(request.getUserName())) {
-            return AjaxResult.error("参数不完整：userName为必填");
+            request.setUserName(LsfxConstants.DEFAULT_USER_NAME);
         }
         if (StringUtils.isBlank(request.getOrgCode())) {
-            return AjaxResult.error("参数不完整：orgCode为必填");
+            request.setOrgCode(LsfxConstants.DEFAULT_ORG_CODE);
         }
         if (StringUtils.isBlank(request.getDepartmentCode())) {
-            return AjaxResult.error("参数不完整：departmentCode为必填");
+            request.setDepartmentCode(LsfxConstants.DEFAULT_DEPARTMENT_CODE);
         }
 
         GetTokenResponse response = lsfxAnalysisClient.getToken(request);
@@ -71,8 +82,28 @@ public class LsfxTestController {
             return AjaxResult.error("文件大小超过限制：最大10MB");
         }
 
-        UploadFileResponse response = lsfxAnalysisClient.uploadFile(groupId, file);
+        // 将 MultipartFile 转换为 File
-        return AjaxResult.success(response);
+        Path tempFile = null;
+        try {
+            // 创建临时文件
+            tempFile = Files.createTempFile("upload_", "_" + file.getOriginalFilename());
+            Files.copy(file.getInputStream(), tempFile, StandardCopyOption.REPLACE_EXISTING);
+
+            File convertedFile = tempFile.toFile();
+            UploadFileResponse response = lsfxAnalysisClient.uploadFile(groupId, convertedFile);
+            return AjaxResult.success(response);
+        } catch (IOException e) {
+            return AjaxResult.error("文件转换失败：" + e.getMessage());
+        } finally {
+            // 删除临时文件
+            if (tempFile != null) {
+                try {
+                    Files.deleteIfExists(tempFile);
+                } catch (IOException e) {
+                    // 忽略删除失败
+                }
+            }
+        }
     }
 
     @Operation(summary = "拉取行内流水", description = "从数仓拉取行内流水数据")
@@ -98,6 +129,11 @@ public class LsfxTestController {
             return AjaxResult.error("参数错误：开始日期不能大于结束日期");
         }
 
+        // 设置dataChannelCode默认值
+        if (StringUtils.isEmpty(request.getDataChannelCode())) {
+            request.setDataChannelCode(LsfxConstants.DEFAULT_DATA_CHANNEL_CODE);
+        }
+
         FetchInnerFlowResponse response = lsfxAnalysisClient.fetchInnerFlow(request);
         return AjaxResult.success(response);
     }
@@ -141,4 +177,43 @@ public class LsfxTestController {
         GetBankStatementResponse response = lsfxAnalysisClient.getBankStatement(request);
         return AjaxResult.success(response);
     }
+
+    @Operation(summary = "获取单个文件上传状态",
+               description = "获取文件解析后的主体名称和账号等信息。status=-5且uploadStatusDesc='data.wait.confirm.newaccount'表示解析成功")
+    @GetMapping("/getFileUploadStatus")
+    public AjaxResult getFileUploadStatus(
+        @Parameter(description = "项目ID") @RequestParam Integer groupId,
+        @Parameter(description = "文件ID(可选,不传则查询所有)") @RequestParam(required = false) Integer logId
+    ) {
+        // 参数校验
+        if (groupId == null || groupId <= 0) {
+            return AjaxResult.error("参数不完整：groupId为必填且大于0");
+        }
+
+        GetFileUploadStatusRequest request = new GetFileUploadStatusRequest();
+        request.setGroupId(groupId);
+        request.setLogId(logId);
+
+        GetFileUploadStatusResponse response = lsfxAnalysisClient.getFileUploadStatus(request);
+        return AjaxResult.success(response);
+    }
+
+    @Operation(summary = "删除文件",
+               description = "删除解析失败或不需要的流水文件")
+    @PostMapping("/deleteFiles")
+    public AjaxResult deleteFiles(@RequestBody DeleteFilesRequest request) {
+        // 参数校验
+        if (request.getGroupId() == null || request.getGroupId() <= 0) {
+            return AjaxResult.error("参数不完整：groupId为必填且大于0");
+        }
+        if (request.getLogIds() == null || request.getLogIds().length == 0) {
+            return AjaxResult.error("参数不完整：logIds为必填且不能为空");
+        }
+        if (request.getUserId() == null) {
+            return AjaxResult.error("参数不完整：userId为必填");
+        }
+
+        DeleteFilesResponse response = lsfxAnalysisClient.deleteFiles(request);
+        return AjaxResult.success(response);
+    }
 }

ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/request/DeleteFilesRequest.java

@@ -0,0 +1,19 @@
+package com.ruoyi.lsfx.domain.request;
+
+import lombok.Data;
+
+/**
+ * 删除文件请求(接口6)
+ */
+@Data
+public class DeleteFilesRequest {
+
+    /** 项目ID (必填) */
+    private Integer groupId;
+
+    /** 文件ID数组 (必填) */
+    private Integer[] logIds;
+
+    /** 用户柜员号 (必填) */
+    private Integer userId;
+}

ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/request/GetFileUploadStatusRequest.java

@@ -0,0 +1,16 @@
+package com.ruoyi.lsfx.domain.request;
+
+import lombok.Data;
+
+/**
+ * 获取单个文件上传状态请求(接口5)
+ */
+@Data
+public class GetFileUploadStatusRequest {
+
+    /** 项目ID (必填) */
+    private Integer groupId;
+
+    /** 文件ID (可选,不传则查询所有) */
+    private Integer logId;
+}

ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/DeleteFilesResponse.java

@@ -0,0 +1,31 @@
+package com.ruoyi.lsfx.domain.response;
+
+import lombok.Data;
+
+/**
+ * 删除文件响应(接口6)
+ */
+@Data
+public class DeleteFilesResponse {
+
+    /** 返回码 */
+    private String code;
+
+    /** 状态 */
+    private String status;
+
+    /** 成功标识 */
+    private Boolean successResponse;
+
+    /** 响应数据 */
+    private DeleteFilesData data;
+
+    /** 响应消息 */
+    private String message;
+
+    @Data
+    public static class DeleteFilesData {
+        /** 删除成功消息 */
+        private String message;
+    }
+}

ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java

@@ -1,7 +1,10 @@
 package com.ruoyi.lsfx.domain.response;
 
+import com.fasterxml.jackson.annotation.JsonFormat;
 import lombok.Data;
+
 import java.math.BigDecimal;
+import java.util.Date;
 import java.util.List;
 
 /**
@@ -131,6 +134,9 @@ public class GetBankStatementResponse {
         /** 上传logId */
         private Integer batchId;
 
+        /** 上传序号 */
+        private Integer uploadSequenceNumber;
+
         /** 项目id */
         private Integer groupId;
 
@@ -183,5 +189,14 @@ public class GetBankStatementResponse {
 
         /** 交易余额 */
         private BigDecimal trxBalance;
+
+        // ===== 审计字段 =====
+
+        /** 创建时间 */
+        @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+        private Date createDate;
+
+        /** 创建者 */
+        private Long createdBy;
     }
 }

ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetFileUploadStatusResponse.java

@@ -0,0 +1,119 @@
+package com.ruoyi.lsfx.domain.response;
+
+import lombok.Data;
+import java.util.List;
+
+/**
+ * 获取单个文件上传状态响应(接口5)
+ */
+@Data
+public class GetFileUploadStatusResponse {
+
+    /** 返回码 */
+    private String code;
+
+    /** 状态 */
+    private String status;
+
+    /** 成功标识 */
+    private Boolean successResponse;
+
+    /** 响应数据 */
+    private FileUploadStatusData data;
+
+    @Data
+    public static class FileUploadStatusData {
+        /** 日志列表 */
+        private List<LogItem> logs;
+
+        /** 状态 */
+        private String status;
+
+        /** 账号ID */
+        private Integer accountId;
+
+        /** 币种 */
+        private String currency;
+    }
+
+    @Data
+    public static class LogItem {
+        /** 账号列表 */
+        private List<String> accountNoList;
+
+        /** 银行名称 */
+        private String bankName;
+
+        /** 数据类型信息 [格式, 分隔符] */
+        private List<String> dataTypeInfo;
+
+        /** 下载文件名 */
+        private String downloadFileName;
+
+        /** 主体名称列表(重要:用于判断是否需要生成主体) */
+        private List<String> enterpriseNameList;
+
+        /** 文件大小(字节) */
+        private Long fileSize;
+
+        /** 文件上传者ID */
+        private Integer fileUploadBy;
+
+        /** 文件上传者用户名 */
+        private String fileUploadByUserName;
+
+        /** 文件上传时间 */
+        private String fileUploadTime;
+
+        /** 是否拆分 */
+        private Integer isSplit;
+
+        /** 企业ID */
+        private Integer leId;
+
+        /** 文件ID */
+        private Integer logId;
+
+        /** 日志元数据 */
+        private String logMeta;
+
+        /** 日志类型 */
+        private String logType;
+
+        /** 登录企业ID */
+        private Integer loginLeId;
+
+        /** 丢失头部 */
+        private List<String> lostHeader;
+
+        /** 真实银行名称 */
+        private String realBankName;
+
+        /** 行数 */
+        private Integer rows;
+
+        /** 来源 */
+        private String source;
+
+        /** 状态(-5表示解析成功) */
+        private Integer status;
+
+        /** 模板名称 */
+        private String templateName;
+
+        /** 总记录数 */
+        private Integer totalRecords;
+
+        /** 交易结束日期ID */
+        private Integer trxDateEndId;
+
+        /** 交易开始日期ID */
+        private Integer trxDateStartId;
+
+        /** 上传文件名 */
+        private String uploadFileName;
+
+        /** 上传状态描述 */
+        private String uploadStatusDesc;
+    }
+}

ccdi-lsfx/src/main/java/com/ruoyi/lsfx/util/HttpUtil.java

@@ -1,14 +1,20 @@
 package com.ruoyi.lsfx.util;
 
+import com.fasterxml.jackson.databind.ObjectMapper;
 import com.ruoyi.lsfx.exception.LsfxApiException;
 import jakarta.annotation.Resource;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.core.io.FileSystemResource;
 import org.springframework.http.*;
 import org.springframework.stereotype.Component;
 import org.springframework.util.LinkedMultiValueMap;
 import org.springframework.util.MultiValueMap;
 import org.springframework.web.client.RestClientException;
 import org.springframework.web.client.RestTemplate;
+import org.springframework.web.util.UriComponentsBuilder;
 
+import java.io.File;
 import java.util.Map;
 
 /**
@@ -17,9 +23,69 @@ import java.util.Map;
 @Component
 public class HttpUtil {
 
+    private static final Logger log = LoggerFactory.getLogger(HttpUtil.class);
+
     @Resource
     private RestTemplate restTemplate;
 
+    @Resource
+    private ObjectMapper objectMapper;
+
+    /**
+     * 发送GET请求（带查询参数和请求头）
+     * @param url 请求URL
+     * @param params 查询参数
+     * @param headers 请求头
+     * @param responseType 响应类型
+     * @return 响应对象
+     */
+    public <T> T get(String url, Map<String, Object> params, Map<String, String> headers, Class<T> responseType) {
+        try {
+            // 构建URL with查询参数
+            UriComponentsBuilder builder = UriComponentsBuilder.fromHttpUrl(url);
+            if (params != null && !params.isEmpty()) {
+                params.forEach((key, value) -> {
+                    if (value != null) {
+                        builder.queryParam(key, value);
+                    }
+                });
+            }
+
+            String fullUrl = builder.toUriString();
+            log.debug("【HTTP GET】请求URL: {}", fullUrl);
+
+            // 创建请求头
+            HttpHeaders httpHeaders = new HttpHeaders();
+            if (headers != null) {
+                headers.forEach(httpHeaders::add);
+            }
+
+            // 构建请求实体
+            HttpEntity<String> entity = new HttpEntity<>(httpHeaders);
+
+            // 执行GET请求
+            ResponseEntity<String> response = restTemplate.exchange(
+                fullUrl,
+                HttpMethod.GET,
+                entity,
+                String.class
+            );
+
+            log.debug("【HTTP GET】响应状态: {}", response.getStatusCode());
+            log.debug("【HTTP GET】响应内容: {}", response.getBody());
+
+            // 解析响应
+            if (response.getStatusCode().is2xxSuccessful() && response.getBody() != null) {
+                return objectMapper.readValue(response.getBody(), responseType);
+            } else {
+                throw new LsfxApiException("GET请求失败: " + response.getStatusCode());
+            }
+        } catch (Exception e) {
+            log.error("【HTTP GET】请求异常: url={}, error={}", url, e.getMessage(), e);
+            throw new LsfxApiException("GET请求异常: " + e.getMessage(), e);
+        }
+    }
+
     /**
      * 发送GET请求（带请求头）
      * @param url 请求URL
@@ -136,7 +202,15 @@ public class HttpUtil {
 
             MultiValueMap<String, Object> body = new LinkedMultiValueMap<>();
             if (params != null) {
-                params.forEach(body::add);
+                params.forEach((key, value) -> {
+                    // 如果是File对象，包装为FileSystemResource
+                    if (value instanceof File) {
+                        File file = (File) value;
+                        body.add(key, new FileSystemResource(file));
+                    } else {
+                        body.add(key, value);
+                    }
+                });
             }
 
             HttpEntity<MultiValueMap<String, Object>> requestEntity = new HttpEntity<>(body, httpHeaders);

ccdi-project/src/main/java/com/ruoyi/ccdi/project/config/AsyncThreadPoolConfig.java

@@ -0,0 +1,48 @@
+package com.ruoyi.ccdi.project.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.scheduling.annotation.EnableAsync;
+import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
+
+import java.util.concurrent.Executor;
+import java.util.concurrent.ThreadPoolExecutor;
+
+/**
+ * 异步线程池配置
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Configuration
+@EnableAsync
+public class AsyncThreadPoolConfig {
+
+    /**
+     * 文件上传专用线程池
+     * 容量：100个线程
+     * 拒绝策略：AbortPolicy（直接拒绝，由调度线程捕获并重试）
+     */
+    @Bean("fileUploadExecutor")
+    public Executor fileUploadExecutor() {
+        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+        // 核心线程数
+        executor.setCorePoolSize(100);
+        // 最大线程数
+        executor.setMaxPoolSize(100);
+        // 队列容量（设为0，不使用队列，直接走拒绝策略）
+        executor.setQueueCapacity(0);
+        // 线程名称前缀
+        executor.setThreadNamePrefix("file-upload-");
+        // 拒绝策略：AbortPolicy，抛出 RejectedExecutionException
+        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.AbortPolicy());
+        // 线程空闲时间（秒）
+        executor.setKeepAliveSeconds(60);
+        // 等待所有任务完成后再关闭
+        executor.setWaitForTasksToCompleteOnShutdown(true);
+        // 最长等待时间
+        executor.setAwaitTerminationSeconds(60);
+        executor.initialize();
+        return executor;
+    }
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiFileUploadController.java

@@ -0,0 +1,114 @@
+package com.ruoyi.ccdi.project.controller;
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.ruoyi.ccdi.project.domain.dto.CcdiFileUploadQueryDTO;
+import com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord;
+import com.ruoyi.ccdi.project.domain.vo.CcdiFileUploadStatisticsVO;
+import com.ruoyi.ccdi.project.service.ICcdiFileUploadService;
+import com.ruoyi.common.core.controller.BaseController;
+import com.ruoyi.common.core.domain.AjaxResult;
+import com.ruoyi.common.core.page.PageDomain;
+import com.ruoyi.common.core.page.TableDataInfo;
+import com.ruoyi.common.core.page.TableSupport;
+import com.ruoyi.common.utils.SecurityUtils;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.util.concurrent.RejectedExecutionException;
+
+/**
+ * 文件上传 Controller
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Slf4j
+@RestController
+@RequestMapping("/ccdi/file-upload")
+@Tag(name = "文件上传管理", description = "项目文件上传相关接口")
+public class CcdiFileUploadController extends BaseController {
+
+    @Resource
+    private ICcdiFileUploadService fileUploadService;
+
+    /**
+     * 批量上传文件（异步）
+     */
+    @PostMapping("/batch")
+    @Operation(summary = "批量上传文件", description = "异步批量上传流水文件")
+    public AjaxResult batchUpload(@RequestParam Long projectId,
+                                    @RequestParam MultipartFile[] files) {
+        // 参数校验
+        if (projectId == null) {
+            return AjaxResult.error("项目ID不能为空");
+        }
+        if (files == null || files.length == 0) {
+            return AjaxResult.error("请选择要上传的文件");
+        }
+        if (files.length > 100) {
+            return AjaxResult.error("单次最多上传100个文件");
+        }
+
+        // 校验文件大小和格式
+        for (MultipartFile file : files) {
+            if (file.isEmpty()) {
+                return AjaxResult.error("文件不能为空");
+            }
+            if (file.getSize() > 50 * 1024 * 1024) {
+                return AjaxResult.error("文件 " + file.getOriginalFilename() + " 超过50MB限制");
+            }
+            String fileName = file.getOriginalFilename();
+            if (!fileName.endsWith(".xlsx") && !fileName.endsWith(".xls")) {
+                return AjaxResult.error("文件 " + fileName + " 格式不支持，仅支持Excel文件");
+            }
+        }
+
+        try {
+            String username = SecurityUtils.getUsername();
+            String batchId = fileUploadService.batchUploadFiles(projectId, files, username);
+            return AjaxResult.success("上传任务已提交", batchId);
+        } catch (RejectedExecutionException e) {
+            log.warn("线程池已满，拒绝上传请求: projectId={}, fileCount={}", projectId, files.length);
+            return AjaxResult.error("系统繁忙，请稍后再试");
+        } catch (Exception e) {
+            log.error("批量上传失败: projectId={}", projectId, e);
+            return AjaxResult.error("上传失败：" + e.getMessage());
+        }
+    }
+
+    /**
+     * 查询上传记录列表
+     */
+    @GetMapping("/list")
+    @Operation(summary = "查询上传记录列表", description = "分页查询文件上传记录")
+    public TableDataInfo list(CcdiFileUploadQueryDTO queryDTO) {
+        PageDomain pageDomain = TableSupport.buildPageRequest();
+        Page<CcdiFileUploadRecord> page = new Page<>(pageDomain.getPageNum(), pageDomain.getPageSize());
+        Page<CcdiFileUploadRecord> result = fileUploadService.selectPage(page, queryDTO);
+        return getDataTable(result.getRecords(), result.getTotal());
+    }
+
+    /**
+     * 查询上传统计
+     */
+    @GetMapping("/statistics/{projectId}")
+    @Operation(summary = "查询上传统计", description = "统计各状态的文件数量")
+    public AjaxResult getStatistics(@PathVariable Long projectId) {
+        CcdiFileUploadStatisticsVO statistics = fileUploadService.countByStatus(projectId);
+        return AjaxResult.success(statistics);
+    }
+
+    /**
+     * 查询记录详情
+     */
+    @GetMapping("/detail/{id}")
+    @Operation(summary = "查询记录详情", description = "根据ID查询文件上传记录详情")
+    public AjaxResult getDetail(@PathVariable Long id) {
+        CcdiFileUploadRecord record = fileUploadService.getById(id);
+        return AjaxResult.success(record);
+    }
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiFileUploadQueryDTO.java

@@ -0,0 +1,31 @@
+package com.ruoyi.ccdi.project.domain.dto;
+
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+/**
+ * 文件上传记录查询 DTO
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Data
+public class CcdiFileUploadQueryDTO implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /** 项目ID */
+    private Long projectId;
+
+    /** 文件状态 */
+    private String fileStatus;
+
+    /** 文件名称（模糊查询） */
+    private String fileName;
+
+    /** 上传人 */
+    private String uploadUser;
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java

@@ -0,0 +1,214 @@
+package com.ruoyi.ccdi.project.domain.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.ruoyi.lsfx.domain.response.GetBankStatementResponse.BankStatementItem;
+import lombok.Data;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.BeanUtils;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.math.BigDecimal;
+import java.util.Date;
+
+/**
+ * 银行流水对象 ccdi_bank_statement
+ *
+ * @author ruoyi
+ * @date 2026-03-04
+ */
+@Data
+@TableName("ccdi_bank_statement")
+public class CcdiBankStatement implements Serializable {
+
+    private static final Logger log = LoggerFactory.getLogger(CcdiBankStatement.class);
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    // ===== 主键和关联字段 =====
+
+    /** 流水ID */
+    @TableId(type = IdType.AUTO)
+    private Long bankStatementId;
+
+    /** 关联项目ID（业务字段） */
+    private Long projectId;
+
+    /** 企业ID */
+    private Integer leId;
+
+    /** 账号ID */
+    private Long accountId;
+
+    /** 项目id（保留原有字段） */
+    private Integer groupId;
+
+    // ===== 账号信息 =====
+
+    /** 企业账号名称 */
+    private String leAccountName;
+
+    /** 企业银行账号 */
+    private String leAccountNo;
+
+    /** 账号日期ID */
+    private Integer accountingDateId;
+
+    /** 账号日期 */
+    private String accountingDate;
+
+    /** 交易日期 */
+    private String trxDate;
+
+    /** 币种 */
+    private String currency;
+
+    // ===== 交易金额 =====
+
+    /** 付款金额 */
+    private BigDecimal amountDr;
+
+    /** 收款金额 */
+    private BigDecimal amountCr;
+
+    /** 余额 */
+    private BigDecimal amountBalance;
+
+    // ===== 交易类型和标志 =====
+
+    /** 交易类型 */
+    private String cashType;
+
+    /** 交易标志位 */
+    private String trxFlag;
+
+    /** 分类ID */
+    private Integer trxType;
+
+    /** 异常类型 */
+    private String exceptionType;
+
+    /** 是否为内部交易 */
+    private Integer internalFlag;
+
+    // ===== 对手方信息 =====
+
+    /** 对手方企业ID */
+    private Integer customerLeId;
+
+    /** 对手方企业名称 */
+    private String customerAccountName;
+
+    /** 对手方账号 */
+    private String customerAccountNo;
+
+    /** 对手方银行 */
+    private String customerBank;
+
+    /** 对手方备注 */
+    private String customerReference;
+
+    // ===== 摘要和备注 =====
+
+    /** 用户交易摘要 */
+    private String userMemo;
+
+    /** 银行交易摘要 */
+    private String bankComments;
+
+    /** 银行交易号 */
+    private String bankTrxNumber;
+
+    // ===== 银行信息 =====
+
+    /** 所属银行缩写 */
+    private String bank;
+
+    // ===== 批次和上传信息 =====
+
+    /** 上传logId */
+    private Integer batchId;
+
+    /** 每次上传在文件中的line */
+    private Integer batchSequence;
+
+    // ===== 附加字段 =====
+
+    /** meta json（固定为null） */
+    private String metaJson;
+
+    /** 是否包含余额 */
+    private Integer noBalance;
+
+    /** 初始余额 */
+    private Integer beginBalance;
+
+    /** 结束余额 */
+    private Integer endBalance;
+
+    /** 覆盖标识 */
+    private Long overrideBsId;
+
+    /** 交易方式 */
+    private String paymentMethod;
+
+    /** 身份证号 */
+    private String cretNo;
+
+    // ===== 审计字段 =====
+
+    /** 创建时间 */
+    private Date createDate;
+
+    /** 创建者 */
+    private Long createdBy;
+
+    /**
+     * 从流水分析接口响应转换为实体
+     *
+     * @param item 流水分析接口返回的流水项
+     * @return 流水实体，如果 item 为 null 则返回 null
+     */
+    public static CcdiBankStatement fromResponse(BankStatementItem item) {
+        // 1. 空值检查
+        if (item == null) {
+            log.warn("流水项为空，无法转换");
+            return null;
+        }
+
+        try {
+            // 2. 创建实体对象
+            CcdiBankStatement entity = new CcdiBankStatement();
+
+            // 3. 使用 BeanUtils 复制同名字段
+            BeanUtils.copyProperties(item, entity);
+
+            // 4. 手动映射字段名不一致的情况
+            entity.setLeAccountNo(item.getAccountMaskNo());
+            entity.setCustomerAccountNo(item.getCustomerAccountMaskNo());
+            entity.setLeAccountName(item.getLeName());
+            entity.setAmountDr(item.getDrAmount());
+            entity.setAmountCr(item.getCrAmount());
+            entity.setAmountBalance(item.getBalanceAmount());
+            entity.setTrxFlag(item.getTransFlag());
+            entity.setTrxType(item.getTransTypeId());
+            entity.setCustomerLeId(item.getCustomerId());
+            entity.setCustomerAccountName(item.getCustomerName());
+            entity.setBatchSequence(item.getUploadSequenceNumber());
+
+            // 5. 特殊字段处理
+            entity.setMetaJson(null);  // 根据文档要求强制设为 null
+
+            // 注意：project_id 需要在 Service 层根据业务逻辑设置
+
+            return entity;
+        } catch (Exception e) {
+            log.error("流水数据转换失败, bankStatementId={}", item.getBankStatementId(), e);
+            throw new RuntimeException("流水数据转换失败", e);
+        }
+    }
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiFileUploadRecord.java

@@ -0,0 +1,61 @@
+package com.ruoyi.ccdi.project.domain.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.util.Date;
+
+/**
+ * 文件上传记录实体
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Data
+@TableName("ccdi_file_upload_record")
+public class CcdiFileUploadRecord implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /** 主键ID */
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 项目ID */
+    private Long projectId;
+
+    /** 流水分析平台项目ID */
+    private Integer lsfxProjectId;
+
+    /** 流水分析平台返回的logId */
+    private Integer logId;
+
+    /** 文件名称 */
+    private String fileName;
+
+    /** 文件大小（字节） */
+    private Long fileSize;
+
+    /** 文件状态：uploading-上传中，parsing-解析中，parsed_success-解析成功，parsed_failed-解析失败 */
+    private String fileStatus;
+
+    /** 主体名称（多个用逗号分隔） */
+    private String enterpriseNames;
+
+    /** 主体账号（多个用逗号分隔） */
+    private String accountNos;
+
+    /** 错误信息（解析失败时记录） */
+    private String errorMessage;
+
+    /** 上传时间 */
+    private Date uploadTime;
+
+    /** 上传人 */
+    private String uploadUser;
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/CcdiFileUploadStatisticsVO.java

@@ -0,0 +1,34 @@
+package com.ruoyi.ccdi.project.domain.vo;
+
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+/**
+ * 文件上传统计 VO
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Data
+public class CcdiFileUploadStatisticsVO implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /** 上传中数量 */
+    private Long uploading;
+
+    /** 解析中数量 */
+    private Long parsing;
+
+    /** 解析成功数量 */
+    private Long parsedSuccess;
+
+    /** 解析失败数量 */
+    private Long parsedFailed;
+
+    /** 总数量 */
+    private Long total;
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/log/FileUploadLogAppender.java

@@ -0,0 +1,103 @@
+package com.ruoyi.ccdi.project.log;
+
+import ch.qos.logback.classic.PatternLayout;
+import ch.qos.logback.classic.spi.ILoggingEvent;
+import ch.qos.logback.core.FileAppender;
+import ch.qos.logback.core.UnsynchronizedAppenderBase;
+import lombok.extern.slf4j.Slf4j;
+
+import java.io.File;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+
+/**
+ * 文件上传批次日志Appender
+ * 为每个批次创建独立的日志文件
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Slf4j
+public class FileUploadLogAppender extends UnsynchronizedAppenderBase<ILoggingEvent> {
+
+    private static final ThreadLocal<FileAppender<ILoggingEvent>> currentAppender = new ThreadLocal<>();
+
+    private PatternLayout layout;
+
+    @Override
+    public void start() {
+        // 初始化日志格式
+        this.layout = new PatternLayout();
+        this.layout.setPattern("%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n");
+        this.layout.setContext(getContext());
+        this.layout.start();
+
+        super.start();
+        log.info("【文件上传日志】FileUploadLogAppender已启动");
+    }
+
+    @Override
+    protected void append(ILoggingEvent event) {
+        FileAppender<ILoggingEvent> appender = currentAppender.get();
+        if (appender != null) {
+            appender.doAppend(event);
+        }
+    }
+
+    /**
+     * 为指定批次创建独立的日志文件
+     *
+     * @param uploadPath ruoyi.profile配置的上传路径
+     * @param projectId 项目ID
+     * @param batchId 批次ID
+     */
+    public static void createBatchLogFile(String uploadPath, Long projectId, String batchId) {
+        try {
+            // 构建日志文件路径: {ruoyi.profile}/logs/file-upload/{projectId}/{timestamp}.log
+            String timestamp = new SimpleDateFormat("yyyyMMdd-HHmmss").format(new Date());
+            String logDirPath = uploadPath + File.separator + "logs" + File.separator
+                    + "file-upload" + File.separator + projectId;
+
+            // 确保目录存在
+            File logDir = new File(logDirPath);
+            if (!logDir.exists()) {
+                logDir.mkdirs();
+            }
+
+            String logFilePath = logDirPath + File.separator + timestamp + ".log";
+
+            // 创建FileAppender
+            FileAppender<ILoggingEvent> appender = new FileAppender<>();
+            appender.setFile(logFilePath);
+
+            PatternLayout layout = new PatternLayout();
+            layout.setPattern("%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n");
+            layout.setContext(appender.getContext());
+            layout.start();
+
+            appender.setLayout(layout);
+            appender.setAppend(true);
+            appender.setContext(appender.getContext());
+            appender.start();
+
+            currentAppender.set(appender);
+
+            log.info("【文件上传日志】创建批次日志文件: path={}, batchId={}", logFilePath, batchId);
+
+        } catch (Exception e) {
+            log.error("【文件上传日志】创建批次日志文件失败: projectId={}, batchId={}", projectId, batchId, e);
+        }
+    }
+
+    /**
+     * 关闭当前批次的日志文件
+     */
+    public static void closeBatchLogFile() {
+        FileAppender<ILoggingEvent> appender = currentAppender.get();
+        if (appender != null) {
+            appender.stop();
+            currentAppender.remove();
+            log.info("【文件上传日志】关闭批次日志文件");
+        }
+    }
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiBankStatementMapper.java

@@ -0,0 +1,24 @@
+package com.ruoyi.ccdi.project.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.ruoyi.ccdi.project.domain.entity.CcdiBankStatement;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
+
+/**
+ * 银行流水Mapper接口
+ *
+ * @author ruoyi
+ * @date 2026-03-04
+ */
+public interface CcdiBankStatementMapper extends BaseMapper<CcdiBankStatement> {
+
+    /**
+     * 批量插入银行流水
+     *
+     * @param list 银行流水列表
+     * @return 插入记录数
+     */
+    int insertBatch(@Param("list") List<CcdiBankStatement> list);
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFileUploadRecordMapper.java

@@ -0,0 +1,35 @@
+package com.ruoyi.ccdi.project.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 文件上传记录 Mapper 接口
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Mapper
+public interface CcdiFileUploadRecordMapper extends BaseMapper<CcdiFileUploadRecord> {
+
+    /**
+     * 批量插入文件上传记录
+     *
+     * @param records 记录列表
+     * @return 插入条数
+     */
+    int insertBatch(@Param("list") List<CcdiFileUploadRecord> records);
+
+    /**
+     * 统计各状态文件数量
+     *
+     * @param projectId 项目ID
+     * @return 统计结果（Map形式，key为状态，value为数量）
+     */
+    List<Map<String, Object>> countByStatus(@Param("projectId") Long projectId);
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiFileUploadService.java

@@ -0,0 +1,52 @@
+package com.ruoyi.ccdi.project.service;
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.ruoyi.ccdi.project.domain.dto.CcdiFileUploadQueryDTO;
+import com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord;
+import com.ruoyi.ccdi.project.domain.vo.CcdiFileUploadStatisticsVO;
+import org.springframework.web.multipart.MultipartFile;
+
+/**
+ * 文件上传服务接口
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+public interface ICcdiFileUploadService {
+
+    /**
+     * 批量上传文件
+     *
+     * @param projectId 项目ID
+     * @param files 文件数组
+     * @param username 上传人
+     * @return 批次ID
+     */
+    String batchUploadFiles(Long projectId, MultipartFile[] files, String username);
+
+    /**
+     * 查询上传记录列表
+     *
+     * @param page 分页参数
+     * @param queryDTO 查询条件
+     * @return 分页结果
+     */
+    Page<CcdiFileUploadRecord> selectPage(Page<CcdiFileUploadRecord> page,
+                                          CcdiFileUploadQueryDTO queryDTO);
+
+    /**
+     * 统计各状态文件数量
+     *
+     * @param projectId 项目ID
+     * @return 统计结果
+     */
+    CcdiFileUploadStatisticsVO countByStatus(Long projectId);
+
+    /**
+     * 根据ID查询记录详情
+     *
+     * @param id 记录ID
+     * @return 记录详情
+     */
+    CcdiFileUploadRecord getById(Long id);
+}

ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java

@@ -0,0 +1,620 @@
+package com.ruoyi.ccdi.project.service.impl;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.ruoyi.ccdi.project.domain.CcdiProject;
+import com.ruoyi.ccdi.project.domain.dto.CcdiFileUploadQueryDTO;
+import com.ruoyi.ccdi.project.domain.entity.CcdiBankStatement;
+import com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord;
+import com.ruoyi.ccdi.project.domain.vo.CcdiFileUploadStatisticsVO;
+import com.ruoyi.ccdi.project.log.FileUploadLogAppender;
+import com.ruoyi.ccdi.project.mapper.CcdiBankStatementMapper;
+import com.ruoyi.ccdi.project.mapper.CcdiFileUploadRecordMapper;
+import com.ruoyi.ccdi.project.mapper.CcdiProjectMapper;
+import com.ruoyi.ccdi.project.service.ICcdiFileUploadService;
+import com.ruoyi.lsfx.client.LsfxAnalysisClient;
+import com.ruoyi.lsfx.domain.request.GetBankStatementRequest;
+import com.ruoyi.lsfx.domain.request.GetFileUploadStatusRequest;
+import com.ruoyi.lsfx.domain.response.*;
+import jakarta.annotation.Resource;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.scheduling.annotation.Async;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.transaction.support.TransactionSynchronization;
+import org.springframework.transaction.support.TransactionSynchronizationManager;
+import org.springframework.util.StringUtils;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.File;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.nio.file.StandardCopyOption;
+import java.util.*;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.Executor;
+import java.util.concurrent.RejectedExecutionException;
+
+/**
+ * 文件上传服务实现
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Slf4j
+@Service
+public class CcdiFileUploadServiceImpl implements ICcdiFileUploadService {
+
+    /**
+     * 若依框架文件上传路径
+     */
+    @Value("${ruoyi.profile}")
+    private String uploadPath;
+
+    @Resource
+    private CcdiFileUploadRecordMapper recordMapper;
+
+    @Resource
+    private CcdiProjectMapper projectMapper;
+
+    @Resource
+    @Qualifier("fileUploadExecutor")
+    private Executor fileUploadExecutor;
+
+    @Resource
+    private LsfxAnalysisClient lsfxClient;
+
+    @Resource
+    private CcdiBankStatementMapper bankStatementMapper;
+
+    /**
+     * 获取临时文件存储目录
+     */
+    private String getTempFileDir() {
+        return uploadPath + File.separator + "temp";
+    }
+
+    @Override
+    public Page<CcdiFileUploadRecord> selectPage(Page<CcdiFileUploadRecord> page,
+                                                  CcdiFileUploadQueryDTO queryDTO) {
+        LambdaQueryWrapper<CcdiFileUploadRecord> queryWrapper = new LambdaQueryWrapper<>();
+
+        // 项目ID
+        if (queryDTO.getProjectId() != null) {
+            queryWrapper.eq(CcdiFileUploadRecord::getProjectId, queryDTO.getProjectId());
+        }
+
+        // 文件状态
+        if (StringUtils.hasText(queryDTO.getFileStatus())) {
+            queryWrapper.eq(CcdiFileUploadRecord::getFileStatus, queryDTO.getFileStatus());
+        }
+
+        // 文件名称(模糊查询)
+        if (StringUtils.hasText(queryDTO.getFileName())) {
+            queryWrapper.like(CcdiFileUploadRecord::getFileName, queryDTO.getFileName());
+        }
+
+        // 上传人
+        if (StringUtils.hasText(queryDTO.getUploadUser())) {
+            queryWrapper.eq(CcdiFileUploadRecord::getUploadUser, queryDTO.getUploadUser());
+        }
+
+        // 按上传时间倒序
+        queryWrapper.orderByDesc(CcdiFileUploadRecord::getUploadTime);
+
+        return recordMapper.selectPage(page, queryWrapper);
+    }
+
+    @Override
+    public CcdiFileUploadStatisticsVO countByStatus(Long projectId) {
+        // 查询统计数据
+        List<Map<String, Object>> statusCounts = recordMapper.countByStatus(projectId);
+
+        // 组装 VO
+        CcdiFileUploadStatisticsVO vo = new CcdiFileUploadStatisticsVO();
+        vo.setUploading(0L);
+        vo.setParsing(0L);
+        vo.setParsedSuccess(0L);
+        vo.setParsedFailed(0L);
+
+        long total = 0L;
+        for (Map<String, Object> item : statusCounts) {
+            String status = (String) item.get("status");
+            Long count = ((Number) item.get("count")).longValue();
+            total += count;
+
+            switch (status) {
+                case "uploading" -> vo.setUploading(count);
+                case "parsing" -> vo.setParsing(count);
+                case "parsed_success" -> vo.setParsedSuccess(count);
+                case "parsed_failed" -> vo.setParsedFailed(count);
+            }
+        }
+
+        vo.setTotal(total);
+        return vo;
+    }
+
+    @Override
+    public CcdiFileUploadRecord getById(Long id) {
+        return recordMapper.selectById(id);
+    }
+
+    @Transactional
+    @Override
+    public String batchUploadFiles(Long projectId, MultipartFile[] files, String username) {
+        log.info("【文件上传】开始批量上传: projectId={}, 文件数量={}, username={}",
+                 projectId, files.length, username);
+
+        // 1. 生成批次ID
+        String batchId = UUID.randomUUID().toString().replace("-", "");
+
+        // 2. 查询项目信息并获取 lsfxProjectId
+        CcdiProject project = projectMapper.selectById(projectId);
+        if (project == null) {
+            throw new IllegalArgumentException("项目不存在: projectId=" + projectId);
+        }
+
+        Integer lsfxProjectId = project.getLsfxProjectId();
+        if (lsfxProjectId == null) {
+            throw new IllegalStateException("项目未关联流水分析平台: projectId=" + projectId);
+        }
+
+        log.info("【文件上传】项目信息验证通过: projectId={}, lsfxProjectId={}", projectId, lsfxProjectId);
+
+        // Critical Fix #2 & #4: 保存临时文件和创建记录在同一个循环中，确保一一对应
+        List<String> tempFilePaths = new ArrayList<>();
+        List<CcdiFileUploadRecord> records = new ArrayList<>();
+        Date now = new Date();
+
+        try {
+            // 确保临时目录存在
+            Path tempDir = Paths.get(getTempFileDir());
+            if (!Files.exists(tempDir)) {
+                Files.createDirectories(tempDir);
+            }
+
+            // 同一个循环中保存临时文件和创建记录，确保索引一一对应
+            for (int i = 0; i < files.length; i++) {
+                MultipartFile file = files[i];
+
+                // 1. 保存临时文件
+                String originalFilename = file.getOriginalFilename();
+                String tempFileName = batchId + "_" + i + "_" + System.currentTimeMillis() + "_" + originalFilename;
+                Path tempFilePath = tempDir.resolve(tempFileName);
+
+                Files.copy(file.getInputStream(), tempFilePath, StandardCopyOption.REPLACE_EXISTING);
+                tempFilePaths.add(tempFilePath.toString());
+
+                log.debug("【文件上传】保存临时文件[{}]: originalName={}, tempPath={}",
+                         i, originalFilename, tempFilePath);
+
+                // 2. 创建记录（使用相同的索引i）
+                CcdiFileUploadRecord record = new CcdiFileUploadRecord();
+                record.setProjectId(projectId);
+                record.setLsfxProjectId(lsfxProjectId);
+                record.setFileName(originalFilename);
+                record.setFileSize(file.getSize());
+                record.setFileStatus("uploading");
+                record.setUploadTime(now);
+                record.setUploadUser(username);
+                records.add(record);
+            }
+        } catch (IOException e) {
+            log.error("【文件上传】保存临时文件失败", e);
+            throw new RuntimeException("保存临时文件失败: " + e.getMessage(), e);
+        }
+
+        // 验证数量一致性
+        if (tempFilePaths.size() != records.size()) {
+            throw new RuntimeException(String.format(
+                "临时文件数量(%d)与记录数量(%d)不一致", tempFilePaths.size(), records.size()));
+        }
+
+        recordMapper.insertBatch(records);
+        log.info("【文件上传】批量插入记录成功: 数量={}", records.size());
+
+        // Critical Fix #3: 验证ID已生成
+        for (CcdiFileUploadRecord record : records) {
+            if (record.getId() == null) {
+                throw new RuntimeException("批量插入失败: 未生成记录ID,请检查Mapper配置useGeneratedKeys=true");
+            }
+        }
+        log.debug("【文件上传】ID验证通过: 所有记录ID已生成");
+
+        // Critical Fix #1: 使用TransactionSynchronization确保异步任务在事务提交后启动
+        final Integer finalLsfxProjectId = lsfxProjectId;
+        TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() {
+            @Override
+            public void afterCommit() {
+                log.info("【文件上传】事务已提交,启动异步任务");
+                CompletableFuture.runAsync(() -> {
+                    submitTasksAsync(projectId, finalLsfxProjectId, tempFilePaths, records, batchId);
+                });
+            }
+        });
+
+        log.info("【文件上传】批量上传任务已提交: batchId={}", batchId);
+        return batchId;
+    }
+
+    /**
+     * 调度线程:循环提交任务到线程池
+     * 支持等待30秒重试机制
+     *
+     * @param projectId 项目ID
+     * @param lsfxProjectId 流水分析项目ID
+     * @param tempFilePaths 临时文件路径列表
+     * @param records 文件上传记录列表
+     * @param batchId 批次ID
+     */
+    private void submitTasksAsync(Long projectId, Integer lsfxProjectId,
+                                   List<String> tempFilePaths,
+                                   List<CcdiFileUploadRecord> records,
+                                   String batchId) {
+        log.info("【文件上传】调度线程启动: projectId={}, batchId={}", projectId, batchId);
+
+        // 创建批次日志文件
+        FileUploadLogAppender.createBatchLogFile(uploadPath, projectId, batchId);
+
+        try {
+            // 循环提交任务
+            for (int i = 0; i < tempFilePaths.size(); i++) {
+                // Critical Fix #6: 检查线程中断状态
+                if (Thread.currentThread().isInterrupted()) {
+                    log.warn("【文件上传】调度线程被中断,停止提交剩余任务");
+                    break;
+                }
+
+                String tempFilePath = tempFilePaths.get(i);
+                CcdiFileUploadRecord record = records.get(i);
+
+                boolean submitted = false;
+                int retryCount = 0;
+
+                while (!submitted && retryCount < 2) {
+                    try {
+                        // 尝试提交异步任务
+                        CompletableFuture.runAsync(
+                            () -> processFileAsync(projectId, lsfxProjectId, tempFilePath, record.getId(), batchId, record),
+                            fileUploadExecutor
+                        );
+                        submitted = true;
+                        log.info("【文件上传】任务提交成功: fileName={}, recordId={}",
+                                 record.getFileName(), record.getId());
+                    } catch (RejectedExecutionException e) {
+                        retryCount++;
+                        if (retryCount == 1) {
+                            log.warn("【文件上传】线程池已满,等待30秒后重试: fileName={}",
+                                     record.getFileName());
+                            try {
+                                Thread.sleep(30000);
+                            } catch (InterruptedException ie) {
+                                Thread.currentThread().interrupt();
+                                log.error("【文件上传】等待被中断: fileName={}", record.getFileName());
+                                updateRecordStatus(record.getId(), "parsed_failed", "任务提交被中断");
+                                break;
+                            }
+                        } else {
+                            log.error("【文件上传】重试失败,放弃任务: fileName={}", record.getFileName());
+                            updateRecordStatus(record.getId(), "parsed_failed", "系统繁忙,请稍后重试");
+                        }
+                    }
+                }
+            }
+
+            log.info("【文件上传】调度线程完成: projectId={}, batchId={}", projectId, batchId);
+        } finally {
+            // 关闭批次日志文件
+            FileUploadLogAppender.closeBatchLogFile();
+        }
+    }
+
+    /**
+     * 更新记录状态(辅助方法)
+     */
+    private void updateRecordStatus(Long recordId, String status, String errorMessage) {
+        CcdiFileUploadRecord record = new CcdiFileUploadRecord();
+        record.setId(recordId);
+        record.setFileStatus(status);
+        record.setErrorMessage(errorMessage);
+        recordMapper.updateById(record);
+    }
+
+    /**
+     * 异步处理单个文件的完整流程
+     * 包含:上传 → 轮询解析状态 → 获取结果 → 保存流水数据
+     *
+     * @param projectId 项目ID
+     * @param lsfxProjectId 流水分析项目ID
+     * @param tempFilePath 临时文件路径
+     * @param recordId 记录ID
+     * @param batchId 批次ID
+     * @param record 文件上传记录
+     */
+    @Async("fileUploadExecutor")
+    public void processFileAsync(Long projectId, Integer lsfxProjectId, String tempFilePath,
+                                   Long recordId, String batchId, CcdiFileUploadRecord record) {
+        log.info("【文件上传】开始处理文件: fileName={}, recordId={}, tempPath={}",
+                 record.getFileName(), recordId, tempFilePath);
+
+        try {
+            // 步骤1:状态已是uploading,记录已存在
+
+            // 从临时文件路径读取文件
+            Path filePath = Paths.get(tempFilePath);
+            if (!Files.exists(filePath)) {
+                throw new RuntimeException("临时文件不存在: " + tempFilePath);
+            }
+
+            // 步骤2:上传文件到流水分析平台
+            log.info("【文件上传】步骤2: 上传文件到流水分析平台, tempPath={}", tempFilePath);
+
+            File file = filePath.toFile();
+            if (!file.exists()) {
+                throw new RuntimeException("临时文件不存在: " + tempFilePath);
+            }
+
+            UploadFileResponse uploadResponse = lsfxClient.uploadFile(lsfxProjectId, file);
+            if (uploadResponse == null || uploadResponse.getData() == null
+                || uploadResponse.getData().getUploadLogList() == null
+                || uploadResponse.getData().getUploadLogList().isEmpty()) {
+                throw new RuntimeException("上传文件失败: 响应数据为空");
+            }
+
+            // 从 uploadLogList 中获取第一个 logId
+            Integer logId = uploadResponse.getData().getUploadLogList().get(0).getLogId();
+            if (logId == null) {
+                throw new RuntimeException("上传文件失败: 未返回logId");
+            }
+
+            log.info("【文件上传】文件上传成功: logId={}", logId);
+
+            // 步骤3:更新状态为 parsing
+            log.info("【文件上传】步骤3: 更新状态为解析中, logId={}", logId);
+            record.setLogId(logId);
+            record.setFileStatus("parsing");
+            recordMapper.updateById(record);
+
+            // 步骤4:轮询解析状态(最多300次,间隔2秒)
+            log.info("【文件上传】步骤4: 开始轮询解析状态");
+            boolean parsingComplete = waitForParsingComplete(lsfxProjectId, logId.toString());
+
+            if (!parsingComplete) {
+                throw new RuntimeException("解析超时(超过10分钟),请检查文件格式是否正确");
+            }
+
+            // 步骤5:获取文件上传状态
+            log.info("【文件上传】步骤5: 获取文件上传状态: logId={}", logId);
+
+            GetFileUploadStatusRequest statusRequest = new GetFileUploadStatusRequest();
+            statusRequest.setGroupId(lsfxProjectId);
+            statusRequest.setLogId(logId);
+
+            GetFileUploadStatusResponse statusResponse = lsfxClient.getFileUploadStatus(statusRequest);
+
+            if (statusResponse == null || statusResponse.getData() == null
+                || statusResponse.getData().getLogs() == null
+                || statusResponse.getData().getLogs().isEmpty()) {
+                throw new RuntimeException("获取文件上传状态失败: 响应数据为空");
+            }
+
+            // 获取第一个log项（因为我们传了logId，应该只返回一个）
+            GetFileUploadStatusResponse.LogItem logItem = statusResponse.getData().getLogs().get(0);
+            Integer status = logItem.getStatus();
+            String uploadStatusDesc = logItem.getUploadStatusDesc();
+
+            log.info("【文件上传】文件状态: status={}, uploadStatusDesc={}", status, uploadStatusDesc);
+
+            // 步骤6:判断解析结果
+            // status=-5 且 uploadStatusDesc="data.wait.confirm.newaccount" 表示解析成功
+            boolean parseSuccess = status != null && status == -5
+                && "data.wait.confirm.newaccount".equals(uploadStatusDesc);
+
+            if (parseSuccess) {
+                // 解析成功
+                log.info("【文件上传】步骤6: 解析成功,保存主体信息");
+
+                // 提取主体名称和账号
+                List<String> enterpriseNames = logItem.getEnterpriseNameList();
+                List<String> accountNos = logItem.getAccountNoList();
+
+                String enterpriseNamesStr = enterpriseNames != null ? String.join(",", enterpriseNames) : "";
+                String accountNosStr = accountNos != null ? String.join(",", accountNos) : "";
+
+                record.setFileStatus("parsed_success");
+                record.setEnterpriseNames(enterpriseNamesStr);
+                record.setAccountNos(accountNosStr);
+                recordMapper.updateById(record);
+
+                log.info("【文件上传】主体信息已保存: enterpriseNames={}, accountNos={}",
+                         enterpriseNamesStr, accountNosStr);
+
+                // 步骤7:获取流水数据并保存
+                log.info("【文件上传】步骤7: 获取流水数据");
+                fetchAndSaveBankStatements(projectId, lsfxProjectId, logId);
+
+            } else {
+                // 解析失败
+                log.warn("【文件上传】步骤6: 解析失败: status={}, desc={}", status, uploadStatusDesc);
+                record.setFileStatus("parsed_failed");
+                record.setErrorMessage("解析失败: " + uploadStatusDesc);
+                recordMapper.updateById(record);
+            }
+
+            log.info("【文件上传】处理完成: fileName={}", record.getFileName());
+
+        } catch (Exception e) {
+            log.error("【文件上传】处理失败: fileName={}", record.getFileName(), e);
+            updateRecordStatus(recordId, "parsed_failed", e.getMessage());
+        } finally {
+            // 清理临时文件
+            try {
+                Path filePath = Paths.get(tempFilePath);
+                if (Files.exists(filePath)) {
+                    Files.delete(filePath);
+                    log.debug("【文件上传】清理临时文件: {}", tempFilePath);
+                }
+            } catch (IOException e) {
+                log.warn("【文件上传】清理临时文件失败: {}", tempFilePath, e);
+            }
+        }
+    }
+
+    /**
+     * 轮询解析状态（固定间隔2秒，最多300次）
+     *
+     * @param groupId 项目ID
+     * @param logId 文件ID
+     * @return true=解析完成，false=超时未完成
+     */
+    private boolean waitForParsingComplete(Integer groupId, String logId) {
+        log.info("【文件上传】开始轮询解析状态: groupId={}, logId={}", groupId, logId);
+
+        int maxRetries = 300;
+        int intervalSeconds = 2;
+
+        for (int i = 1; i <= maxRetries; i++) {
+            try {
+                // 调用检查解析状态接口
+                CheckParseStatusResponse response = lsfxClient.checkParseStatus(groupId, logId);
+
+                if (response == null || response.getData() == null) {
+                    log.warn("【文件上传】轮询第{}次: 响应数据为空", i);
+                    Thread.sleep(intervalSeconds * 1000L);
+                    continue;
+                }
+
+                Boolean parsing = response.getData().getParsing();
+                log.debug("【文件上传】轮询第{}次: parsing={}", i, parsing);
+
+                // parsing=false 表示解析完成
+                if (Boolean.FALSE.equals(parsing)) {
+                    log.info("【文件上传】解析完成: logId={}, 轮询次数={}", logId, i);
+                    return true;
+                }
+
+                // 未完成，等待后继续
+                if (i < maxRetries) {
+                    Thread.sleep(intervalSeconds * 1000L);
+                }
+
+            } catch (InterruptedException e) {
+                Thread.currentThread().interrupt();
+                log.error("【文件上传】轮询被中断: logId={}", logId, e);
+                return false;
+            } catch (Exception e) {
+                log.error("【文件上传】轮询异常: logId={}, 次数={}", logId, i, e);
+                // 继续轮询，不中断
+            }
+        }
+
+        log.warn("【文件上传】轮询超时: logId={}, 已轮询{}次", logId, maxRetries);
+        return false;
+    }
+
+    /**
+     * 获取并保存流水数据（每页1000条，批量插入每批1000条）
+     *
+     * @param projectId 项目ID（业务字段）
+     * @param groupId 流水分析平台项目ID
+     * @param logId 文件ID
+     */
+    private void fetchAndSaveBankStatements(Long projectId, Integer groupId, Integer logId) {
+        log.info("【文件上传】开始获取流水数据: projectId={}, groupId={}, logId={}",
+                 projectId, groupId, logId);
+
+        // 步骤1: 先调用一次接口获取 totalCount
+        GetBankStatementRequest firstRequest = new GetBankStatementRequest();
+        firstRequest.setGroupId(groupId);
+        firstRequest.setLogId(logId);
+        firstRequest.setPageNow(1);
+        firstRequest.setPageSize(1);  // 只获取1条，用于获取总数
+
+        GetBankStatementResponse firstResponse = lsfxClient.getBankStatement(firstRequest);
+
+        if (firstResponse == null || firstResponse.getData() == null) {
+            log.warn("【文件上传】获取流水数据失败: 响应数据为空");
+            return;
+        }
+
+        Integer totalCount = firstResponse.getData().getTotalCount();
+        if (totalCount == null || totalCount <= 0) {
+            log.warn("【文件上传】无流水数据需要保存: totalCount={}", totalCount);
+            return;
+        }
+
+        log.info("【文件上传】获取到总数: totalCount={}", totalCount);
+
+        // 步骤2: 计算分页信息
+        int pageSize = 1000;  // 每页1000条
+        int batchSize = 1000;  // 批量插入每批1000条（与pageSize保持一致）
+        int totalPages = (int) Math.ceil((double) totalCount / pageSize);
+
+        log.info("【文件上传】分页信息: 每页{}条, 共{}页", pageSize, totalPages);
+
+        List<CcdiBankStatement> batchList = new ArrayList<>(batchSize);
+        int totalSaved = 0;
+
+        // 步骤3: 循环分页获取所有数据
+        for (int pageNow = 1; pageNow <= totalPages; pageNow++) {
+            try {
+                // 构建请求参数
+                GetBankStatementRequest request = new GetBankStatementRequest();
+                request.setGroupId(groupId);
+                request.setLogId(logId);
+                request.setPageNow(pageNow);
+                request.setPageSize(pageSize);
+
+                // 获取流水数据
+                GetBankStatementResponse response = lsfxClient.getBankStatement(request);
+
+                if (response == null || response.getData() == null
+                    || response.getData().getBankStatementList() == null) {
+                    log.warn("【文件上传】获取流水数据为空: pageNow={}", pageNow);
+                    continue;
+                }
+
+                List<GetBankStatementResponse.BankStatementItem> items =
+                    response.getData().getBankStatementList();
+
+                log.debug("【文件上传】获取第{}页数据: {}条", pageNow, items.size());
+
+                // 转换并收集到批量列表
+                for (GetBankStatementResponse.BankStatementItem item : items) {
+                    CcdiBankStatement statement = CcdiBankStatement.fromResponse(item);
+                    if (statement != null) {
+                        statement.setProjectId(projectId);  // 设置业务项目ID
+                        batchList.add(statement);
+
+                        // 达到批量插入阈值（1000条），执行插入
+                        if (batchList.size() >= batchSize) {
+                            bankStatementMapper.insertBatch(batchList);
+                            totalSaved += batchList.size();
+                            log.debug("【文件上传】批量插入流水: {}条, 累计{}条",
+                                     batchList.size(), totalSaved);
+                            batchList.clear();
+                        }
+                    }
+                }
+
+            } catch (Exception e) {
+                log.error("【文件上传】获取或保存流水数据失败: pageNow={}", pageNow, e);
+                // 继续处理下一页，不中断整个流程
+            }
+        }
+
+        // 步骤4: 保存剩余的数据
+        if (!batchList.isEmpty()) {
+            bankStatementMapper.insertBatch(batchList);
+            totalSaved += batchList.size();
+            log.debug("【文件上传】批量插入剩余流水: {}条", batchList.size());
+        }
+
+        log.info("【文件上传】流水数据保存完成: 总共保存{}条", totalSaved);
+    }
+}

ccdi-project/src/main/resources/mapper/ccdi/project/CcdiBankStatementMapper.xml

@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.ruoyi.ccdi.project.mapper.CcdiBankStatementMapper">
+
+    <resultMap type="com.ruoyi.ccdi.project.domain.entity.CcdiBankStatement" id="CcdiBankStatementResult">
+        <id     property="bankStatementId"    column="bank_statement_id"    />
+        <result property="projectId"          column="project_id"           />
+        <result property="leId"               column="LE_ID"                />
+        <result property="accountId"          column="ACCOUNT_ID"           />
+        <result property="groupId"            column="group_id"             />
+        <result property="leAccountName"      column="LE_ACCOUNT_NAME"      />
+        <result property="leAccountNo"        column="LE_ACCOUNT_NO"        />
+        <result property="accountingDateId"   column="ACCOUNTING_DATE_ID"   />
+        <result property="accountingDate"     column="ACCOUNTING_DATE"      />
+        <result property="trxDate"            column="TRX_DATE"             />
+        <result property="currency"           column="CURRENCY"             />
+        <result property="amountDr"           column="AMOUNT_DR"            />
+        <result property="amountCr"           column="AMOUNT_CR"            />
+        <result property="amountBalance"      column="AMOUNT_BALANCE"       />
+        <result property="cashType"           column="CASH_TYPE"            />
+        <result property="customerLeId"       column="CUSTOMER_LE_ID"       />
+        <result property="customerAccountName" column="CUSTOMER_ACCOUNT_NAME" />
+        <result property="customerAccountNo"  column="CUSTOMER_ACCOUNT_NO"  />
+        <result property="customerBank"       column="customer_bank"        />
+        <result property="customerReference"  column="customer_reference"   />
+        <result property="userMemo"           column="USER_MEMO"            />
+        <result property="bankComments"       column="BANK_COMMENTS"        />
+        <result property="bankTrxNumber"      column="BANK_TRX_NUMBER"      />
+        <result property="bank"               column="BANK"                 />
+        <result property="trxFlag"            column="TRX_FLAG"             />
+        <result property="trxType"            column="TRX_TYPE"             />
+        <result property="exceptionType"      column="EXCEPTION_TYPE"       />
+        <result property="internalFlag"       column="internal_flag"        />
+        <result property="batchId"            column="batch_id"             />
+        <result property="batchSequence"      column="batch_sequence"       />
+        <result property="createDate"         column="CREATE_DATE"          />
+        <result property="createdBy"          column="created_by"           />
+        <result property="metaJson"           column="meta_json"            />
+        <result property="noBalance"          column="no_balance"           />
+        <result property="beginBalance"       column="begin_balance"        />
+        <result property="endBalance"         column="end_balance"          />
+        <result property="overrideBsId"       column="override_bs_id"       />
+        <result property="paymentMethod"      column="payment_method"       />
+        <result property="cretNo"             column="cret_no"              />
+    </resultMap>
+
+    <sql id="selectCcdiBankStatementVo">
+        select bank_statement_id, project_id, LE_ID, ACCOUNT_ID, group_id,
+               LE_ACCOUNT_NAME, LE_ACCOUNT_NO, ACCOUNTING_DATE_ID, ACCOUNTING_DATE,
+               TRX_DATE, CURRENCY, AMOUNT_DR, AMOUNT_CR, AMOUNT_BALANCE,
+               CASH_TYPE, CUSTOMER_LE_ID, CUSTOMER_ACCOUNT_NAME, CUSTOMER_ACCOUNT_NO,
+               customer_bank, customer_reference, USER_MEMO, BANK_COMMENTS,
+               BANK_TRX_NUMBER, BANK, TRX_FLAG, TRX_TYPE, EXCEPTION_TYPE,
+               internal_flag, batch_id, batch_sequence, CREATE_DATE, created_by,
+               meta_json, no_balance, begin_balance, end_balance,
+               override_bs_id, payment_method, cret_no
+        from ccdi_bank_statement
+    </sql>
+
+    <insert id="insertBatch" parameterType="java.util.List">
+        insert into ccdi_bank_statement (
+            project_id, LE_ID, ACCOUNT_ID, group_id,
+            LE_ACCOUNT_NAME, LE_ACCOUNT_NO, ACCOUNTING_DATE_ID, ACCOUNTING_DATE,
+            TRX_DATE, CURRENCY, AMOUNT_DR, AMOUNT_CR, AMOUNT_BALANCE,
+            CASH_TYPE, CUSTOMER_LE_ID, CUSTOMER_ACCOUNT_NAME, CUSTOMER_ACCOUNT_NO,
+            customer_bank, customer_reference, USER_MEMO, BANK_COMMENTS,
+            BANK_TRX_NUMBER, BANK, TRX_FLAG, TRX_TYPE, EXCEPTION_TYPE,
+            internal_flag, batch_id, batch_sequence, CREATE_DATE, created_by,
+            meta_json, no_balance, begin_balance, end_balance,
+            override_bs_id, payment_method, cret_no
+        ) values
+        <foreach collection="list" item="item" separator=",">
+            (
+                #{item.projectId}, #{item.leId}, #{item.accountId}, #{item.groupId},
+                #{item.leAccountName}, #{item.leAccountNo}, #{item.accountingDateId}, #{item.accountingDate},
+                #{item.trxDate}, #{item.currency}, #{item.amountDr}, #{item.amountCr}, #{item.amountBalance},
+                #{item.cashType}, #{item.customerLeId}, #{item.customerAccountName}, #{item.customerAccountNo},
+                #{item.customerBank}, #{item.customerReference}, #{item.userMemo}, #{item.bankComments},
+                #{item.bankTrxNumber}, #{item.bank}, #{item.trxFlag}, #{item.trxType}, #{item.exceptionType},
+                #{item.internalFlag}, #{item.batchId}, #{item.batchSequence}, #{item.createDate}, #{item.createdBy},
+                #{item.metaJson}, #{item.noBalance}, #{item.beginBalance}, #{item.endBalance},
+                #{item.overrideBsId}, #{item.paymentMethod}, #{item.cretNo}
+            )
+        </foreach>
+    </insert>
+
+</mapper>

ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFileUploadRecordMapper.xml

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.ruoyi.ccdi.project.mapper.CcdiFileUploadRecordMapper">
+
+    <resultMap type="com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord" id="CcdiFileUploadRecordResult">
+        <id     property="id"               column="id"                 />
+        <result property="projectId"       column="project_id"         />
+        <result property="lsfxProjectId"   column="lsfx_project_id"    />
+        <result property="logId"           column="log_id"             />
+        <result property="fileName"        column="file_name"          />
+        <result property="fileSize"        column="file_size"          />
+        <result property="fileStatus"      column="file_status"        />
+        <result property="enterpriseNames" column="enterprise_names"   />
+        <result property="accountNos"      column="account_nos"        />
+        <result property="errorMessage"    column="error_message"      />
+        <result property="uploadTime"      column="upload_time"        />
+        <result property="uploadUser"      column="upload_user"        />
+    </resultMap>
+
+    <sql id="selectCcdiFileUploadRecordVo">
+        select id, project_id, lsfx_project_id, log_id, file_name, file_size,
+               file_status, enterprise_names, account_nos, error_message,
+               upload_time, upload_user
+        from ccdi_file_upload_record
+    </sql>
+
+    <!-- 批量插入 -->
+    <insert id="insertBatch" parameterType="java.util.List" useGeneratedKeys="true" keyProperty="id">
+        insert into ccdi_file_upload_record (
+            project_id, lsfx_project_id, file_name, file_size, file_status,
+            upload_time, upload_user
+        ) values
+        <foreach collection="list" item="item" separator=",">
+            (
+                #{item.projectId}, #{item.lsfxProjectId}, #{item.fileName},
+                #{item.fileSize}, #{item.fileStatus}, #{item.uploadTime},
+                #{item.uploadUser}
+            )
+        </foreach>
+    </insert>
+
+    <!-- 统计各状态文件数量 -->
+    <select id="countByStatus" resultType="java.util.Map">
+        select file_status as `status`, count(*) as count
+        from ccdi_file_upload_record
+        where project_id = #{projectId}
+        group by file_status
+    </select>
+
+</mapper>

ccdi-project/src/test/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatementTest.java

@@ -0,0 +1,94 @@
+package com.ruoyi.ccdi.project.domain.entity;
+
+import com.ruoyi.lsfx.domain.response.GetBankStatementResponse.BankStatementItem;
+import org.junit.jupiter.api.Test;
+
+import java.math.BigDecimal;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+/**
+ * 银行流水实体类测试
+ *
+ * @author ruoyi
+ * @date 2026-03-04
+ */
+class CcdiBankStatementTest {
+
+    @Test
+    void testFromResponse_Success() {
+        // 准备测试数据
+        BankStatementItem item = new BankStatementItem();
+        item.setBankStatementId(123456L);
+        item.setLeId(100);
+        item.setAccountId(200L);
+        item.setLeName("测试企业");
+        item.setAccountMaskNo("6222****1234");
+        item.setDrAmount(new BigDecimal("1000.00"));
+        item.setCrAmount(new BigDecimal("500.00"));
+        item.setBalanceAmount(new BigDecimal("5000.00"));
+        item.setTrxDate("2026-03-04");
+        item.setCustomerAccountMaskNo("6228****5678");
+
+        // 执行转换
+        CcdiBankStatement entity = CcdiBankStatement.fromResponse(item);
+
+        // 验证结果
+        assertNotNull(entity, "转换结果不应为null");
+        assertEquals(123456L, entity.getBankStatementId(), "流水ID应该匹配");
+        assertEquals(100, entity.getLeId(), "企业ID应该匹配");
+        assertEquals(200L, entity.getAccountId(), "账号ID应该匹配");
+        assertEquals("测试企业", entity.getLeAccountName(), "企业名称应该匹配");
+
+        // 验证手动映射的字段
+        assertEquals("6222****1234", entity.getLeAccountNo(), "企业账号应该从 accountMaskNo 映射");
+        assertEquals("6228****5678", entity.getCustomerAccountNo(), "对手方账号应该从 customerAccountMaskNo 映射");
+
+        // 验证金额字段
+        assertEquals(new BigDecimal("1000.00"), entity.getAmountDr(), "付款金额应该匹配");
+        assertEquals(new BigDecimal("500.00"), entity.getAmountCr(), "收款金额应该匹配");
+        assertEquals(new BigDecimal("5000.00"), entity.getAmountBalance(), "余额应该匹配");
+
+        // 验证特殊字段
+        assertNull(entity.getMetaJson(), "metaJson 应该强制为 null");
+        assertNull(entity.getProjectId(), "projectId 应该为 null（需要 Service 层设置）");
+    }
+
+    @Test
+    void testFromResponse_Null() {
+        // 测试空值处理
+        CcdiBankStatement entity = CcdiBankStatement.fromResponse(null);
+
+        // 验证返回 null
+        assertNull(entity, "传入 null 应该返回 null");
+    }
+
+    @Test
+    void testFromResponse_EmptyObject() {
+        // 测试空对象转换
+        BankStatementItem item = new BankStatementItem();
+
+        // 执行转换
+        CcdiBankStatement entity = CcdiBankStatement.fromResponse(item);
+
+        // 验证不会抛出异常
+        assertNotNull(entity, "空对象转换结果不应为 null");
+        assertNull(entity.getMetaJson(), "metaJson 应该为 null");
+    }
+
+    @Test
+    void testFromResponse_FieldTypeCompatibility() {
+        // 测试字段类型兼容性
+        BankStatementItem item = new BankStatementItem();
+        item.setInternalFlag(1);  // Integer 类型
+        item.setTransTypeId(100);  // Integer 类型
+
+        // 执行转换
+        CcdiBankStatement entity = CcdiBankStatement.fromResponse(item);
+
+        // 验证类型转换正确
+        assertNotNull(entity, "转换结果不应为 null");
+        assertEquals(1, entity.getInternalFlag(), "Integer 类型应该正确复制");
+        assertEquals(100, entity.getTrxType(), "Integer 类型应该正确复制");
+    }
+}

doc/api-docs/ccdi-file-upload-api.md

@@ -0,0 +1,227 @@
+# 文件上传 API 文档
+
+## 1. 批量上传文件
+
+### 接口地址
+POST /ccdi/file-upload/batch
+
+### 请求参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| projectId | Long | 是 | 项目ID |
+| files | File[] | 是 | 文件数组（最多100个，单个最大50MB） |
+
+### 请求示例
+```bash
+curl -X POST "http://localhost:8080/ccdi/file-upload/batch" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -F "projectId=1" \
+  -F "files=@/path/to/file1.xlsx" \
+  -F "files=@/path/to/file2.xlsx"
+```
+
+### 返回示例
+```json
+{
+  "code": 200,
+  "msg": "上传任务已提交",
+  "data": "a1b2c3d4e5f6g7h8"
+}
+```
+
+### 返回字段说明
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| code | Integer | 状态码，200表示成功 |
+| msg | String | 提示信息 |
+| data | String | 批次ID，用于追踪上传任务 |
+
+### 错误码说明
+| code | msg | 说明 |
+|------|-----|------|
+| 500 | 项目ID不能为空 | 缺少必填参数 |
+| 500 | 请选择要上传的文件 | 文件数组为空 |
+| 500 | 单次最多上传100个文件 | 文件数量超限 |
+| 500 | 文件 xxx 超过50MB限制 | 文件大小超限 |
+| 500 | 文件 xxx 格式不支持，仅支持Excel文件 | 文件格式错误 |
+| 500 | 系统繁忙，请稍后再试 | 线程池已满 |
+
+---
+
+## 2. 查询上传记录列表
+
+### 接口地址
+GET /ccdi/file-upload/list
+
+### 请求参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| projectId | Long | 否 | 项目ID |
+| fileStatus | String | 否 | 文件状态：uploading/parsing/parsed_success/parsed_failed |
+| fileName | String | 否 | 文件名称（模糊查询） |
+| uploadUser | String | 否 | 上传人 |
+| pageNum | Integer | 否 | 页码，默认1 |
+| pageSize | Integer | 否 | 每页数量，默认10 |
+
+### 请求示例
+```bash
+curl -X GET "http://localhost:8080/ccdi/file-upload/list?projectId=1&fileStatus=parsed_success&pageNum=1&pageSize=10" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### 返回示例
+```json
+{
+  "code": 200,
+  "msg": "查询成功",
+  "rows": [
+    {
+      "id": 1,
+      "projectId": 1,
+      "lsfxProjectId": 100,
+      "logId": 123456,
+      "fileName": "流水1.xlsx",
+      "fileSize": 2621440,
+      "fileStatus": "parsed_success",
+      "enterpriseNames": "张三,李四",
+      "accountNos": "622xxx,623xxx",
+      "uploadTime": "2026-03-05 10:30:00",
+      "uploadUser": "admin"
+    }
+  ],
+  "total": 100
+}
+```
+
+### 返回字段说明
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| rows | Array | 记录列表 |
+| total | Long | 总记录数 |
+
+---
+
+## 3. 查询上传统计
+
+### 接口地址
+GET /ccdi/file-upload/statistics/{projectId}
+
+### 路径参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| projectId | Long | 是 | 项目ID |
+
+### 请求示例
+```bash
+curl -X GET "http://localhost:8080/ccdi/file-upload/statistics/1" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### 返回示例
+```json
+{
+  "code": 200,
+  "msg": "查询成功",
+  "data": {
+    "uploading": 2,
+    "parsing": 3,
+    "parsedSuccess": 15,
+    "parsedFailed": 1,
+    "total": 21
+  }
+}
+```
+
+### 返回字段说明
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| uploading | Long | 上传中数量 |
+| parsing | Long | 解析中数量 |
+| parsedSuccess | Long | 解析成功数量 |
+| parsedFailed | Long | 解析失败数量 |
+| total | Long | 总数量 |
+
+---
+
+## 4. 查询记录详情
+
+### 接口地址
+GET /ccdi/file-upload/detail/{id}
+
+### 路径参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| id | Long | 是 | 记录ID |
+
+### 请求示例
+```bash
+curl -X GET "http://localhost:8080/ccdi/file-upload/detail/1" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### 返回示例
+```json
+{
+  "code": 200,
+  "msg": "查询成功",
+  "data": {
+    "id": 1,
+    "projectId": 1,
+    "lsfxProjectId": 100,
+    "logId": 123456,
+    "fileName": "流水1.xlsx",
+    "fileSize": 2621440,
+    "fileStatus": "parsed_success",
+    "enterpriseNames": "张三,李四",
+    "accountNos": "622xxx,623xxx",
+    "errorMessage": null,
+    "uploadTime": "2026-03-05 10:30:00",
+    "uploadUser": "admin"
+  }
+}
+```
+
+---
+
+## 5. 文件状态说明
+
+| 状态 | 说明 |
+|------|------|
+| uploading | 文件上传中 |
+| parsing | 文件解析中 |
+| parsed_success | 文件解析成功 |
+| parsed_failed | 文件解析失败 |
+
+---
+
+## 6. 通用说明
+
+### 认证方式
+所有接口需要在请求头中携带 Token：
+```
+Authorization: Bearer YOUR_TOKEN
+```
+
+### 获取 Token
+```bash
+POST /login/test?username=admin&password=admin123
+```
+
+### 响应格式
+所有接口统一返回格式：
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": {}
+}
+```
+
+### 错误处理
+当发生错误时，返回格式：
+```json
+{
+  "code": 500,
+  "msg": "错误信息"
+}
+```

doc/design/2026-03-05-async-file-upload-design.md

@@ -0,0 +1,560 @@
+# 项目异步文件上传功能 - 设计文档
+
+## 文档信息
+- **创建日期**: 2026-03-05
+- **版本**: v1.0
+- **作者**: Claude
+- **状态**: 已批准
+
+## 1. 概述
+
+### 1.1 功能描述
+实现项目流水文件的异步批量上传功能，支持文件上传到流水分析平台、轮询解析状态、获取解析结果、保存流水数据到本地数据库的完整流程。
+
+### 1.2 核心需求
+- 批量上传流水文件（最多100个文件）
+- 异步处理每个文件的上传→解析→存储流程
+- 线程池容量100，超载时等待30秒重试
+- 实时跟踪文件处理状态
+- 生成独立的批次日志文件便于维护
+
+### 1.3 技术栈
+- Spring @Async 异步处理
+- ThreadPoolTaskExecutor 线程池
+- MyBatis Plus 批量操作
+- Logback 自定义日志
+- Vue + Element UI 前端
+
+## 2. 数据库设计
+
+### 2.1 文件上传记录表
+
+```sql
+CREATE TABLE `ccdi_file_upload_record` (
+  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+  `project_id` bigint(20) NOT NULL COMMENT '项目ID',
+  `lsfx_project_id` int(11) DEFAULT NULL COMMENT '流水分析平台项目ID',
+  `log_id` int(11) DEFAULT NULL COMMENT '流水分析平台返回的logId',
+  `file_name` varchar(255) NOT NULL COMMENT '文件名称',
+  `file_size` bigint(20) DEFAULT NULL COMMENT '文件大小（字节）',
+  `file_status` varchar(20) NOT NULL COMMENT '文件状态：uploading-上传中，parsing-解析中，parsed_success-解析成功，parsed_failed-解析失败',
+  `enterprise_names` text COMMENT '主体名称（多个用逗号分隔）',
+  `account_nos` text COMMENT '主体账号（多个用逗号分隔）',
+  `error_message` text COMMENT '错误信息（解析失败时记录）',
+  `upload_time` datetime NOT NULL COMMENT '上传时间',
+  `upload_user` varchar(64) NOT NULL COMMENT '上传人',
+  PRIMARY KEY (`id`),
+  KEY `idx_project_id` (`project_id`),
+  KEY `idx_log_id` (`log_id`),
+  KEY `idx_file_status` (`file_status`),
+  KEY `idx_upload_time` (`upload_time`),
+  KEY `idx_project_status` (`project_id`, `file_status`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='项目文件上传记录表';
+```
+
+### 2.2 字段说明
+
+| 字段 | 类型 | 说明 | 备注 |
+|------|------|------|------|
+| id | bigint | 主键ID | 自增 |
+| project_id | bigint | 项目ID | 外键关联 ccdi_project |
+| lsfx_project_id | int | 流水分析平台项目ID | 用于调用流水分析接口 |
+| log_id | int | 流水分析平台返回的logId | 关键字段，用于查询解析状态和流水数据 |
+| file_name | varchar(255) | 文件名称 | 原始文件名 |
+| file_size | bigint | 文件大小 | 字节数 |
+| file_status | varchar(20) | 文件状态 | uploading/parsing/parsed_success/parsed_failed |
+| enterprise_names | text | 主体名称 | 解析成功后存储，多个用逗号分隔 |
+| account_nos | text | 主体账号 | 解析成功后存储，多个用逗号分隔 |
+| error_message | text | 错误信息 | 解析失败时记录原因 |
+| upload_time | datetime | 上传时间 | 记录创建时间 |
+| upload_user | varchar(64) | 上传人 | 操作用户 |
+
+## 3. 后端架构设计
+
+### 3.1 模块结构
+
+```
+ccdi-project/src/main/java/com/ruoyi/ccdi/project/
+├── controller/
+│   └── CcdiFileUploadController.java          # 文件上传接口
+├── service/
+│   ├── ICcdiFileUploadService.java            # 文件上传服务接口
+│   └── impl/
+│       └── CcdiFileUploadServiceImpl.java     # 文件上传服务实现
+├── mapper/
+│   └── CcdiFileUploadRecordMapper.java        # 文件上传记录Mapper
+├── domain/
+│   ├── entity/
+│   │   └── CcdiFileUploadRecord.java          # 文件上传记录实体
+│   ├── dto/
+│   │   └── CcdiFileUploadQueryDTO.java        # 查询DTO
+│   └── vo/
+│       ├── CcdiFileUploadVO.java              # 文件上传响应VO
+│       └── CcdiFileUploadStatisticsVO.java    # 统计VO
+├── config/
+│   └── AsyncThreadPoolConfig.java             # 异步线程池配置
+└── log/
+    └── FileUploadLogAppender.java             # 自定义日志Appender
+
+ccdi-project/src/main/resources/
+└── mapper/ccdi/project/
+    └── CcdiFileUploadRecordMapper.xml         # Mapper XML映射文件
+```
+
+### 3.2 Controller 接口设计
+
+| 接口路径 | 方法 | 功能 | 参数 | 返回值 |
+|---------|------|------|------|--------|
+| `/ccdi/file-upload/batch` | POST | 批量上传文件 | projectId, files[] | batchId |
+| `/ccdi/file-upload/list` | GET | 查询上传记录列表 | projectId, fileStatus, pageNum, pageSize | 分页列表 |
+| `/ccdi/file-upload/statistics/{projectId}` | GET | 查询上传统计 | projectId | 各状态数量 |
+| `/ccdi/file-upload/detail/{id}` | GET | 查询记录详情 | id | 完整信息 |
+| `/ccdi/file-upload/thread-pool/status` | GET | 查询线程池状态 | - | 线程池状态信息 |
+
+### 3.3 Service 核心方法
+
+#### ICcdiFileUploadService 接口
+
+```java
+public interface ICcdiFileUploadService {
+    /**
+     * 批量上传文件
+     * @param projectId 项目ID
+     * @param files 文件数组
+     * @param username 上传人
+     * @return 批次ID
+     */
+    String batchUploadFiles(Long projectId, MultipartFile[] files, String username);
+
+    /**
+     * 异步处理单个文件
+     * @Async("fileUploadExecutor")
+     */
+    void processFileAsync(Long projectId, Integer lsfxProjectId, MultipartFile file,
+                          Long recordId, String batchId, CcdiFileUploadRecord record);
+
+    /**
+     * 查询上传记录列表
+     */
+    Page<CcdiFileUploadRecord> selectPage(Page<CcdiFileUploadRecord> page,
+                                          CcdiFileUploadQueryDTO queryDTO);
+
+    /**
+     * 统计各状态文件数量
+     */
+    Map<String, Long> countByStatus(Long projectId);
+}
+```
+
+#### 核心处理流程
+
+```java
+// 1. batchUploadFiles - 主入口
+String batchUploadFiles(Long projectId, MultipartFile[] files, String username) {
+    // 1.1 生成批次ID
+    String batchId = UUID.randomUUID().toString().replace("-", "");
+
+    // 1.2 获取项目的 lsfxProjectId
+    Integer lsfxProjectId = project.getLsfxProjectId();
+
+    // 1.3 批量插入文件记录（status=uploading）
+    List<CcdiFileUploadRecord> records = createRecords(projectId, lsfxProjectId, files, username);
+    recordMapper.insertBatch(records);
+
+    // 1.4 异步启动调度线程提交任务
+    CompletableFuture.runAsync(() -> {
+        submitTasksAsync(projectId, lsfxProjectId, files, records, batchId);
+    });
+
+    // 1.5 立即返回 batchId
+    return batchId;
+}
+
+// 2. submitTasksAsync - 调度线程
+void submitTasksAsync(Long projectId, Integer lsfxProjectId, MultipartFile[] files,
+                      List<CcdiFileUploadRecord> records, String batchId) {
+    // 2.1 创建批次日志文件
+    FileUploadLogAppender.createBatchLogFile(projectId, batchId);
+
+    // 2.2 循环提交任务，支持重试
+    for (int i = 0; i < files.length; i++) {
+        boolean submitted = false;
+        int retryCount = 0;
+
+        while (!submitted && retryCount < 2) {
+            try {
+                // 提交异步任务到线程池
+                CompletableFuture.runAsync(
+                    () -> processFileAsync(projectId, lsfxProjectId, files[i],
+                                           records.get(i).getId(), batchId, records.get(i)),
+                    fileUploadExecutor
+                );
+                submitted = true;
+            } catch (RejectedExecutionException e) {
+                retryCount++;
+                if (retryCount == 1) {
+                    Thread.sleep(30000); // 等待30秒
+                } else {
+                    // 重试失败，更新记录状态
+                    updateRecordStatus(records.get(i).getId(), "parsed_failed", "系统繁忙");
+                }
+            }
+        }
+    }
+}
+
+// 3. processFileAsync - 文件处理线程
+@Async("fileUploadExecutor")
+void processFileAsync(Long projectId, Integer lsfxProjectId, MultipartFile file,
+                      Long recordId, String batchId, CcdiFileUploadRecord record) {
+    try {
+        // 3.1 上传文件到流水分析平台
+        UploadFileResponse uploadResponse = lsfxClient.uploadFile(lsfxProjectId, file);
+        Integer logId = uploadResponse.getData().getLogId();
+
+        // 3.2 更新状态为 parsing
+        record.setLogId(logId);
+        record.setFileStatus("parsing");
+        recordMapper.updateById(record);
+
+        // 3.3 轮询解析状态（最多300次，间隔2秒）
+        boolean parsingComplete = waitForParsingComplete(lsfxProjectId, logId.toString());
+
+        // 3.4 获取文件上传状态
+        GetFileUploadStatusResponse statusResponse = lsfxClient.getFileUploadStatus(...);
+
+        // 3.5 判断解析结果
+        if (status == -5 && desc == "data.wait.confirm.newaccount") {
+            // 解析成功
+            record.setFileStatus("parsed_success");
+            record.setEnterpriseNames(...);
+            record.setAccountNos(...);
+            recordMapper.updateById(record);
+
+            // 3.6 获取流水数据并批量保存
+            fetchAndSaveBankStatements(projectId, lsfxProjectId, logId, totalCount);
+        } else {
+            // 解析失败
+            record.setFileStatus("parsed_failed");
+            record.setErrorMessage(...);
+            recordMapper.updateById(record);
+        }
+    } catch (Exception e) {
+        updateRecordStatus(recordId, "parsed_failed", e.getMessage());
+    }
+}
+```
+
+## 4. 线程池配置
+
+### 4.1 配置类
+
+```java
+@Configuration
+@EnableAsync
+public class AsyncThreadPoolConfig {
+
+    @Bean("fileUploadExecutor")
+    public Executor fileUploadExecutor() {
+        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+        executor.setCorePoolSize(100);              // 核心线程数
+        executor.setMaxPoolSize(100);               // 最大线程数
+        executor.setQueueCapacity(0);               // 队列容量（0表示不使用队列）
+        executor.setThreadNamePrefix("file-upload-"); // 线程名称前缀
+        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.AbortPolicy()); // 拒绝策略
+        executor.setKeepAliveSeconds(60);           // 空闲线程存活时间
+        executor.setWaitForTasksToCompleteOnShutdown(true); // 等待任务完成再关闭
+        executor.setAwaitTerminationSeconds(60);    // 最长等待时间
+        executor.initialize();
+        return executor;
+    }
+}
+```
+
+### 4.2 拒绝策略
+
+- **策略**: AbortPolicy
+- **行为**: 抛出 RejectedExecutionException
+- **处理**: 调度线程捕获异常，等待30秒后重试1次
+- **重试失败**: 更新记录状态为 `parsed_failed`，错误信息"系统繁忙"
+
+## 5. 日志管理
+
+### 5.1 日志文件组织
+
+- **路径格式**: `logs/file-upload/{projectId}/{timestamp}.log`
+- **示例**: `logs/file-upload/123/20260305-103025.log`
+- **特点**: 每个批次生成独立的日志文件
+
+### 5.2 Logback 配置
+
+```xml
+<!-- logback-fileupload.xml -->
+<appender name="FILE_UPLOAD" class="com.ruoyi.ccdi.project.log.FileUploadLogAppender">
+    <layout class="ch.qos.logback.classic.PatternLayout">
+        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
+    </layout>
+    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+        <fileNamePattern>logs/file-upload/%d{yyyy-MM-dd}/%d{HH}.log</fileNamePattern>
+        <maxHistory>30</maxHistory>
+        <maxFileSize>100MB</maxFileSize>
+    </rollingPolicy>
+</appender>
+
+<logger name="com.ruoyi.ccdi.project.service.impl.CcdiFileUploadServiceImpl"
+        level="INFO" additivity="false">
+    <appender-ref ref="FILE_UPLOAD"/>
+</logger>
+```
+
+### 5.3 自定义 Appender
+
+```java
+public class FileUploadLogAppender extends UnsynchronizedAppenderBase<ILoggingEvent> {
+
+    private static final ThreadLocal<FileAppender<ILoggingEvent>> currentAppender =
+        new ThreadLocal<>();
+
+    /**
+     * 为指定批次创建独立的日志文件
+     */
+    public static void createBatchLogFile(Long projectId, String batchId) {
+        String timestamp = new SimpleDateFormat("yyyyMMdd-HHmmss").format(new Date());
+        String logPath = String.format("logs/file-upload/%d/%s.log", projectId, timestamp);
+
+        FileAppender<ILoggingEvent> appender = new FileAppender<>();
+        appender.setFile(logPath);
+        appender.setLayout(...);
+        appender.start();
+
+        currentAppender.set(appender);
+    }
+
+    @Override
+    protected void append(ILoggingEvent event) {
+        FileAppender<ILoggingEvent> appender = currentAppender.get();
+        if (appender != null) {
+            appender.doAppend(event);
+        }
+    }
+}
+```
+
+## 6. 前端交互设计
+
+### 6.1 上传流程
+
+```
+用户选择文件 → 确认上传 → 显示loading
+    ↓
+调用 batchUploadFiles() API
+    ↓
+后端立即返回 batchId
+    ↓
+前端提示"上传任务已提交"
+    ↓
+跳转到上传记录列表页
+    ↓
+每5秒自动刷新列表（可关闭）
+```
+
+### 6.2 列表页展示
+
+**统计卡片:**
+- 上传中: 2
+- 解析中: 3
+- 解析成功: 15
+- 解析失败: 1
+
+**文件列表:**
+
+| 文件名 | 大小 | 状态 | 主体名称 | 上传时间 | 操作 |
+|--------|------|------|----------|----------|------|
+| 流水1.xlsx | 2.5MB | 🔄 解析中 | - | 10:30:25 | - |
+| 流水2.xlsx | 1.8MB | ✅ 解析成功 | 张三,李四 | 10:28:15 | 查看流水 |
+| 流水3.xlsx | 3.2MB | ❌ 解析失败 | - | 10:25:30 | 查看错误 |
+
+### 6.3 API 接口
+
+```javascript
+// 批量上传文件
+POST /ccdi/file-upload/batch
+参数: FormData(projectId, files[])
+返回: { code: 200, msg: "上传任务已提交", data: batchId }
+
+// 查询上传记录列表
+GET /ccdi/file-upload/list
+参数: { projectId, fileStatus, pageNum, pageSize }
+返回: { rows: [], total: 100 }
+
+// 查询上传统计
+GET /ccdi/file-upload/statistics/{projectId}
+返回: { uploading: 2, parsing: 3, parsed_success: 15, parsed_failed: 1 }
+```
+
+## 7. 异常处理
+
+### 7.1 Controller 层异常
+
+| 异常类型 | 处理方式 | 返回信息 |
+|---------|---------|---------|
+| 参数为空 | 参数校验 | "项目ID不能为空" |
+| 文件数量超限 | 参数校验 | "单次最多上传100个文件" |
+| 文件大小超限 | 参数校验 | "文件超过50MB限制" |
+| 文件格式错误 | 参数校验 | "仅支持Excel文件" |
+| 项目不存在 | 业务校验 | "项目不存在" |
+
+### 7.2 Service 层异常
+
+| 异常类型 | 处理方式 | 记录状态 |
+|---------|---------|---------|
+| 流水分析平台接口异常 | 捕获并记录 | parsed_failed |
+| 轮询超时（>300次） | 捕获并记录 | parsed_failed |
+| 文件解析失败 | 捕获并记录 | parsed_failed |
+| 线程池满且重试失败 | 捕获并记录 | parsed_failed |
+| 其他未知异常 | 捕获并记录 | parsed_failed |
+
+### 7.3 异常处理代码示例
+
+```java
+try {
+    // 处理文件
+    processFileInternal(projectId, lsfxProjectId, file, record);
+} catch (LsfxApiException e) {
+    log.error("流水分析平台接口异常", e);
+    updateRecordStatus(recordId, "parsed_failed", "流水分析平台接口异常：" + e.getMessage());
+} catch (InterruptedException e) {
+    Thread.currentThread().interrupt();
+    log.error("处理被中断", e);
+    updateRecordStatus(recordId, "parsed_failed", "处理被中断");
+} catch (Exception e) {
+    log.error("处理失败（未知异常）", e);
+    updateRecordStatus(recordId, "parsed_failed", "处理失败：" + e.getMessage());
+}
+```
+
+## 8. 性能优化
+
+### 8.1 数据库优化
+
+**索引建议:**
+```sql
+-- 组合索引提升查询性能
+ALTER TABLE ccdi_file_upload_record
+ADD INDEX idx_project_status (project_id, file_status);
+
+ALTER TABLE ccdi_bank_statement
+ADD INDEX idx_project_log (project_id, batch_id);
+```
+
+**批量插入:**
+- 使用 MyBatis Plus 的 `saveBatch(statements, 500)`
+- 每批500条，避免单次插入过多数据
+
+### 8.2 轮询优化
+
+**动态间隔策略:**
+- 前10次：1秒间隔
+- 11-50次：2秒间隔
+- 51次后：5秒间隔
+
+### 8.3 线程池监控
+
+```java
+@GetMapping("/thread-pool/status")
+public AjaxResult getThreadPoolStatus() {
+    ThreadPoolExecutor pool = fileUploadExecutor.getThreadPoolExecutor();
+
+    Map<String, Object> status = new HashMap<>();
+    status.put("activeCount", pool.getActiveCount());
+    status.put("corePoolSize", pool.getCorePoolSize());
+    status.put("queueSize", pool.getQueue().size());
+    status.put("completedTaskCount", pool.getCompletedTaskCount());
+
+    return AjaxResult.success(status);
+}
+```
+
+## 9. 测试场景
+
+### 9.1 功能测试
+
+| 场景 | 输入 | 预期结果 |
+|------|------|---------|
+| 正常上传 | 10个Excel文件，每个5MB | 所有文件处理成功 |
+| 大文件上传 | 1个50MB文件 | 处理成功 |
+| 文件数量超限 | 101个文件 | 返回错误提示 |
+| 文件格式错误 | 上传PDF文件 | 返回错误提示 |
+| 解析失败 | 格式错误的Excel | 状态更新为parsed_failed |
+
+### 9.2 压力测试
+
+| 场景 | 并发数 | 预期结果 |
+|------|--------|---------|
+| 正常并发 | 100个线程同时上传 | 所有任务正常处理 |
+| 超载测试 | 150个文件同时上传 | 超过100的文件等待30秒重试 |
+| 持续运行 | 1000次循环上传 | 无内存泄漏，无线程死锁 |
+
+### 9.3 边界测试
+
+| 场景 | 操作 | 预期结果 |
+|------|------|---------|
+| 项目被删除 | 上传中删除项目 | 任务取消，状态更新为失败 |
+| 重复上传 | 同一文件上传2次 | 生成2条独立记录和logId |
+| 网络中断 | 轮询时网络断开 | 捕获异常，状态更新为失败 |
+
+## 10. 部署注意事项
+
+### 10.1 配置检查清单
+
+- [ ] 线程池容量配置（默认100）
+- [ ] 文件上传大小限制（默认50MB）
+- [ ] 日志文件路径权限
+- [ ] 数据库索引创建
+- [ ] 流水分析平台地址配置
+- [ ] 应用认证信息配置
+
+### 10.2 监控指标
+
+- 线程池活跃线程数
+- 文件上传成功率（parsed_success / total）
+- 平均处理时长
+- 线程池拒绝次数
+- 日志文件大小和数量
+
+### 10.3 运维建议
+
+- 定期清理30天前的日志文件
+- 监控线程池状态，必要时调整容量
+- 关注数据库连接池使用情况
+- 流水分析平台接口调用成功率监控
+
+## 11. 附录
+
+### 11.1 状态机转换
+
+```
+uploading (初始状态)
+    ↓
+parsing (上传成功，轮询中)
+    ↓
+parsed_success (解析成功) 或 parsed_failed (解析失败)
+```
+
+### 11.2 关键时序
+
+- 文件上传：2-5秒（取决于文件大小）
+- 轮询解析：最多10分钟（300次 × 2秒）
+- 获取流水数据：1-3分钟（取决于流水数量）
+- 总处理时长：约3-15分钟/文件
+
+### 11.3 数据量估算
+
+- 单个Excel文件：平均5000条流水
+- 100个文件：约50万条流水
+- 数据库存储：约200MB
+- 日志文件：约5-10MB/批次
+
+---
+
+**文档结束**

doc/design/2026-03-05-async-file-upload-frontend-design-update.md

@@ -0,0 +1,98 @@
+# 异步文件上传功能 - 前端设计更新
+
+## 文档信息
+- **更新日期**: 2026-03-05
+- **版本**: v1.1
+- **变更说明**: 修改文件格式限制
+
+## 变更内容
+
+### 文件格式限制变更
+
+**原限制**：
+- 仅支持 Excel 文件（.xlsx, .xls）
+
+**新限制**：
+- 支持 PDF 文件（.pdf）
+- 支持 CSV 文件（.csv）
+- 支持 Excel 文件（.xlsx, .xls）
+
+### 修改点
+
+#### 1. 前端校验逻辑
+```javascript
+// 修改前
+const validTypes = ['.xlsx', '.xls'];
+
+// 修改后
+const validTypes = ['.pdf', '.csv', '.xlsx', '.xls'];
+```
+
+#### 2. 错误提示
+```
+修改前: "仅支持 .xlsx, .xls 格式文件"
+修改后: "仅支持 PDF、CSV、Excel 格式文件"
+```
+
+#### 3. 上传卡片描述
+```
+修改前: "支持 Excel、PDF 格式文件上传"
+修改后: "支持 PDF、CSV、Excel 格式文件上传"
+```
+
+#### 4. 批量上传弹窗提示
+```
+修改前: "支持 .xlsx, .xls 格式文件，最多上传100个文件"
+修改后: "支持 PDF、CSV、Excel 格式文件，最多100个文件，单个文件不超过50MB"
+```
+
+#### 5. accept属性
+```html
+<!-- 新增 -->
+<el-upload accept=".pdf,.csv,.xlsx,.xls" ...>
+```
+
+## 后端接口变更要求
+
+后端Controller接口需要同步修改文件格式校验逻辑：
+
+```java
+// CcdiFileUploadController.java
+// 修改文件格式校验部分
+
+// 修改前
+if (!fileName.endsWith(".xlsx") && !fileName.endsWith(".xls")) {
+    return AjaxResult.error("文件 " + fileName + " 格式不支持，仅支持Excel文件");
+}
+
+// 修改后
+String lowerFileName = fileName.toLowerCase();
+if (!lowerFileName.endsWith(".pdf") && !lowerFileName.endsWith(".csv") 
+    && !lowerFileName.endsWith(".xlsx") && !lowerFileName.endsWith(".xls")) {
+    return AjaxResult.error("文件 " + fileName + " 格式不支持，仅支持PDF、CSV、Excel文件");
+}
+```
+
+## 测试变更
+
+### 测试文件格式
+
+需要测试以下格式：
+- ✅ PDF 文件
+- ✅ CSV 文件
+- ✅ XLSX 文件
+- ✅ XLS 文件
+- ❌ 其他格式（应被拒绝）
+
+### 测试用例
+
+1. 上传PDF文件 → 应成功
+2. 上传CSV文件 → 应成功
+3. 上传XLSX文件 → 应成功
+4. 上传XLS文件 → 应成功
+5. 上传TXT文件 → 应提示"格式不支持"
+6. 上传DOC文件 → 应提示"格式不支持"
+
+---
+
+**文档结束**

doc/design/2026-03-05-async-file-upload-frontend-design.md

@@ -0,0 +1,149 @@
+# 项目异步文件上传功能 - 前端设计文档（轮询版本）
+
+## 文档信息
+- **创建日期**: 2026-03-05
+- **版本**: v1.1
+- **作者**: Claude
+- **状态**: 已批准
+- **关联文档**: [后端设计文档](./2026-03-05-async-file-upload-design.md)
+- **变更说明**: 移除WebSocket，改为页面轮询机制
+
+## 1. 设计概述
+
+### 1.1 功能描述
+基于现有项目管理模块的上传数据组件（UploadData.vue），扩展实现流水文件的异步批量上传功能。
+
+### 1.2 技术栈
+- Vue.js 2.6.12
+- Element UI 2.15.14
+- Axios（HTTP 请求）
+- 页面轮询（定时刷新）
+
+## 2. 核心变更
+
+### 2.1 移除WebSocket
+- 不再使用WebSocket实时推送
+- 改用HTTP轮询机制定时刷新
+
+### 2.2 轮询机制
+
+**启动条件**：
+- 上传文件后立即启动
+- 检测到有uploading或parsing状态文件时自动启动
+
+**停止条件**：
+- 所有文件处理完成（无uploading和parsing状态）
+- 组件销毁时
+- 用户手动停止
+
+**轮询间隔**：
+- 默认5秒
+- 可根据活跃任务数量动态调整
+
+## 3. 轮询实现
+
+### 3.1 数据结构
+
+```javascript
+data() {
+  return {
+    // 轮询相关
+    pollingTimer: null,
+    pollingEnabled: false,
+    pollingInterval: 5000  // 5秒
+  }
+}
+```
+
+### 3.2 核心方法
+
+```javascript
+methods: {
+  // 启动轮询
+  startPolling() {
+    if (this.pollingEnabled) return
+    
+    this.pollingEnabled = true
+    
+    const poll = () => {
+      if (!this.pollingEnabled) return
+      
+      Promise.all([
+        this.loadStatistics(),
+        this.loadFileList()
+      ]).then(() => {
+        // 检查是否需要继续轮询
+        if (this.statistics.uploading === 0 && 
+            this.statistics.parsing === 0) {
+          this.stopPolling()
+          return
+        }
+        
+        this.pollingTimer = setTimeout(poll, this.pollingInterval)
+      })
+    }
+    
+    poll()
+  },
+  
+  // 停止轮询
+  stopPolling() {
+    this.pollingEnabled = false
+    if (this.pollingTimer) {
+      clearTimeout(this.pollingTimer)
+      this.pollingTimer = null
+    }
+  },
+  
+  // 上传成功后启动轮询
+  async handleBatchUpload() {
+    // ... 上传逻辑 ...
+    
+    // 刷新数据并启动轮询
+    await Promise.all([
+      this.loadStatistics(),
+      this.loadFileList()
+    ])
+    
+    this.startPolling()
+  }
+}
+```
+
+### 3.3 生命周期管理
+
+```javascript
+mounted() {
+  this.loadStatistics()
+  this.loadFileList()
+  
+  // 检查是否需要启动轮询
+  if (this.statistics.uploading > 0 || this.statistics.parsing > 0) {
+    this.startPolling()
+  }
+},
+
+beforeDestroy() {
+  this.stopPolling()
+}
+```
+
+## 4. 其他功能
+
+批量上传弹窗、统计卡片、文件列表等功能保持不变，详见原设计文档。
+
+## 5. 开发计划
+
+1. **API 接口封装**（0.5天）
+2. **批量上传弹窗**（1天）
+3. **统计卡片组件**（0.5天）
+4. **文件列表组件**（1天）
+5. **轮询机制**（0.5天）
+6. **联调测试**（1天）
+
+**总计**：4.5个工作日
+
+---
+
+**文档结束**
+```

doc/plans/2026-03-05-async-file-upload-part1-database.md

@@ -0,0 +1,483 @@
+# 项目异步文件上传功能 - 子计划1：数据库和基础组件
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 创建文件上传功能的数据库表、实体类、Mapper接口和基础配置
+
+**Architecture:** 使用 MyBatis Plus 进行数据持久化，配置容量100的异步线程池
+
+**Tech Stack:** MySQL 8.0, MyBatis Plus 3.5.10, Spring Boot 3.5.8
+
+---
+
+## Task 1: 数据库表创建
+
+**Files:**
+- Create: `sql/ccdi_file_upload_record.sql`
+
+**Step 1: 创建SQL脚本文件**
+
+创建文件 `sql/ccdi_file_upload_record.sql`:
+
+```sql
+-- 项目文件上传记录表
+-- 用途：记录项目下所有文件的上传记录和处理状态
+-- 作者：系统
+-- 日期：2026-03-05
+
+USE ccdi;
+
+-- 创建文件上传记录表
+CREATE TABLE `ccdi_file_upload_record` (
+  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+  `project_id` bigint(20) NOT NULL COMMENT '项目ID',
+  `lsfx_project_id` int(11) DEFAULT NULL COMMENT '流水分析平台项目ID',
+  `log_id` int(11) DEFAULT NULL COMMENT '流水分析平台返回的logId',
+  `file_name` varchar(255) NOT NULL COMMENT '文件名称',
+  `file_size` bigint(20) DEFAULT NULL COMMENT '文件大小（字节）',
+  `file_status` varchar(20) NOT NULL COMMENT '文件状态：uploading-上传中，parsing-解析中，parsed_success-解析成功，parsed_failed-解析失败',
+  `enterprise_names` text COMMENT '主体名称（多个用逗号分隔）',
+  `account_nos` text COMMENT '主体账号（多个用逗号分隔）',
+  `error_message` text COMMENT '错误信息（解析失败时记录）',
+  `upload_time` datetime NOT NULL COMMENT '上传时间',
+  `upload_user` varchar(64) NOT NULL COMMENT '上传人',
+  PRIMARY KEY (`id`),
+  KEY `idx_project_id` (`project_id`),
+  KEY `idx_log_id` (`log_id`),
+  KEY `idx_file_status` (`file_status`),
+  KEY `idx_upload_time` (`upload_time`),
+  KEY `idx_project_status` (`project_id`, `file_status`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='项目文件上传记录表';
+```
+
+**Step 2: 执行SQL脚本**
+
+```bash
+mysql -h 116.62.17.81 -u root -pKfcx@1234 ccdi < sql/ccdi_file_upload_record.sql
+```
+
+**Step 3: 验证表创建成功**
+
+```bash
+mysql -h 116.62.17.81 -u root -pKfcx@1234 ccdi -e "SHOW CREATE TABLE ccdi_file_upload_record\G"
+```
+
+Expected: 输出表结构，包含所有字段和索引
+
+**Step 4: 提交SQL脚本**
+
+```bash
+git add sql/ccdi_file_upload_record.sql
+git commit -m "feat: 添加文件上传记录表SQL脚本"
+```
+
+---
+
+## Task 2: 实体类创建
+
+**Files:**
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiFileUploadRecord.java`
+
+**Step 1: 创建实体类**
+
+创建文件 `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiFileUploadRecord.java`:
+
+```java
+package com.ruoyi.ccdi.project.domain.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.util.Date;
+
+/**
+ * 文件上传记录实体
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Data
+@TableName("ccdi_file_upload_record")
+public class CcdiFileUploadRecord implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /** 主键ID */
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 项目ID */
+    private Long projectId;
+
+    /** 流水分析平台项目ID */
+    private Integer lsfxProjectId;
+
+    /** 流水分析平台返回的logId */
+    private Integer logId;
+
+    /** 文件名称 */
+    private String fileName;
+
+    /** 文件大小（字节） */
+    private Long fileSize;
+
+    /** 文件状态：uploading-上传中，parsing-解析中，parsed_success-解析成功，parsed_failed-解析失败 */
+    private String fileStatus;
+
+    /** 主体名称（多个用逗号分隔） */
+    private String enterpriseNames;
+
+    /** 主体账号（多个用逗号分隔） */
+    private String accountNos;
+
+    /** 错误信息（解析失败时记录） */
+    private String errorMessage;
+
+    /** 上传时间 */
+    private Date uploadTime;
+
+    /** 上传人 */
+    private String uploadUser;
+}
+```
+
+**Step 2: 编译验证**
+
+```bash
+cd ccdi-project
+mvn clean compile
+```
+
+Expected: BUILD SUCCESS
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiFileUploadRecord.java
+git commit -m "feat: 添加文件上传记录实体类"
+```
+
+---
+
+## Task 3: Mapper 接口和 XML
+
+**Files:**
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFileUploadRecordMapper.java`
+- Create: `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFileUploadRecordMapper.xml`
+
+**Step 1: 创建 Mapper 接口**
+
+创建文件 `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFileUploadRecordMapper.java`:
+
+```java
+package com.ruoyi.ccdi.project.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
+
+/**
+ * 文件上传记录 Mapper 接口
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Mapper
+public interface CcdiFileUploadRecordMapper extends BaseMapper<CcdiFileUploadRecord> {
+
+    /**
+     * 批量插入文件上传记录
+     *
+     * @param records 记录列表
+     * @return 插入条数
+     */
+    int insertBatch(@Param("list") List<CcdiFileUploadRecord> records);
+
+    /**
+     * 统计各状态文件数量
+     *
+     * @param projectId 项目ID
+     * @return 统计结果（Map形式，key为状态，value为数量）
+     */
+    List<java.util.Map<String, Object>> countByStatus(@Param("projectId") Long projectId);
+}
+```
+
+**Step 2: 创建 Mapper XML**
+
+创建文件 `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFileUploadRecordMapper.xml`:
+
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.ruoyi.ccdi.project.mapper.CcdiFileUploadRecordMapper">
+
+    <resultMap type="com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord" id="CcdiFileUploadRecordResult">
+        <id     property="id"               column="id"                 />
+        <result property="projectId"       column="project_id"         />
+        <result property="lsfxProjectId"   column="lsfx_project_id"    />
+        <result property="logId"           column="log_id"             />
+        <result property="fileName"        column="file_name"          />
+        <result property="fileSize"        column="file_size"          />
+        <result property="fileStatus"      column="file_status"        />
+        <result property="enterpriseNames" column="enterprise_names"   />
+        <result property="accountNos"      column="account_nos"        />
+        <result property="errorMessage"    column="error_message"      />
+        <result property="uploadTime"      column="upload_time"        />
+        <result property="uploadUser"      column="upload_user"        />
+    </resultMap>
+
+    <sql id="selectCcdiFileUploadRecordVo">
+        select id, project_id, lsfx_project_id, log_id, file_name, file_size,
+               file_status, enterprise_names, account_nos, error_message,
+               upload_time, upload_user
+        from ccdi_file_upload_record
+    </sql>
+
+    <!-- 批量插入 -->
+    <insert id="insertBatch" parameterType="java.util.List">
+        insert into ccdi_file_upload_record (
+            project_id, lsfx_project_id, file_name, file_size, file_status,
+            upload_time, upload_user
+        ) values
+        <foreach collection="list" item="item" separator=",">
+            (
+                #{item.projectId}, #{item.lsfxProjectId}, #{item.fileName},
+                #{item.fileSize}, #{item.fileStatus}, #{item.uploadTime},
+                #{item.uploadUser}
+            )
+        </foreach>
+    </insert>
+
+    <!-- 统计各状态文件数量 -->
+    <select id="countByStatus" resultType="java.util.Map">
+        select file_status as `status`, count(*) as count
+        from ccdi_file_upload_record
+        where project_id = #{projectId}
+        group by file_status
+    </select>
+
+</mapper>
+```
+
+**Step 3: 编译验证**
+
+```bash
+cd ccdi-project
+mvn clean compile
+```
+
+Expected: BUILD SUCCESS
+
+**Step 4: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFileUploadRecordMapper.java
+git add ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFileUploadRecordMapper.xml
+git commit -m "feat: 添加文件上传记录Mapper接口和XML映射"
+```
+
+---
+
+## Task 4: DTO 和 VO 类
+
+**Files:**
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiFileUploadQueryDTO.java`
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/CcdiFileUploadStatisticsVO.java`
+
+**Step 1: 创建查询 DTO**
+
+创建文件 `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiFileUploadQueryDTO.java`:
+
+```java
+package com.ruoyi.ccdi.project.domain.dto;
+
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+/**
+ * 文件上传记录查询 DTO
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Data
+public class CcdiFileUploadQueryDTO implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /** 项目ID */
+    private Long projectId;
+
+    /** 文件状态 */
+    private String fileStatus;
+
+    /** 文件名称（模糊查询） */
+    private String fileName;
+
+    /** 上传人 */
+    private String uploadUser;
+}
+```
+
+**Step 2: 创建统计 VO**
+
+创建文件 `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/CcdiFileUploadStatisticsVO.java`:
+
+```java
+package com.ruoyi.ccdi.project.domain.vo;
+
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+/**
+ * 文件上传统计 VO
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Data
+public class CcdiFileUploadStatisticsVO implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /** 上传中数量 */
+    private Long uploading;
+
+    /** 解析中数量 */
+    private Long parsing;
+
+    /** 解析成功数量 */
+    private Long parsedSuccess;
+
+    /** 解析失败数量 */
+    private Long parsedFailed;
+
+    /** 总数量 */
+    private Long total;
+}
+```
+
+**Step 3: 编译验证**
+
+```bash
+cd ccdi-project
+mvn clean compile
+```
+
+Expected: BUILD SUCCESS
+
+**Step 4: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiFileUploadQueryDTO.java
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/CcdiFileUploadStatisticsVO.java
+git commit -m "feat: 添加文件上传查询DTO和统计VO"
+```
+
+---
+
+## Task 5: 线程池配置
+
+**Files:**
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/config/AsyncThreadPoolConfig.java`
+
+**Step 1: 创建线程池配置类**
+
+创建文件 `ccdi-project/src/main/java/com/ruoyi/ccdi/project/config/AsyncThreadPoolConfig.java`:
+
+```java
+package com.ruoyi.ccdi.project.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.scheduling.annotation.EnableAsync;
+import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
+
+import java.util.concurrent.Executor;
+import java.util.concurrent.ThreadPoolExecutor;
+
+/**
+ * 异步线程池配置
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Configuration
+@EnableAsync
+public class AsyncThreadPoolConfig {
+
+    /**
+     * 文件上传专用线程池
+     * 容量：100个线程
+     * 拒绝策略：AbortPolicy（直接拒绝，由调度线程捕获并重试）
+     */
+    @Bean("fileUploadExecutor")
+    public Executor fileUploadExecutor() {
+        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+        // 核心线程数
+        executor.setCorePoolSize(100);
+        // 最大线程数
+        executor.setMaxPoolSize(100);
+        // 队列容量（设为0，不使用队列，直接走拒绝策略）
+        executor.setQueueCapacity(0);
+        // 线程名称前缀
+        executor.setThreadNamePrefix("file-upload-");
+        // 拒绝策略：AbortPolicy，抛出 RejectedExecutionException
+        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.AbortPolicy());
+        // 线程空闲时间（秒）
+        executor.setKeepAliveSeconds(60);
+        // 等待所有任务完成后再关闭
+        executor.setWaitForTasksToCompleteOnShutdown(true);
+        // 最长等待时间
+        executor.setAwaitTerminationSeconds(60);
+        executor.initialize();
+        return executor;
+    }
+}
+```
+
+**Step 2: 编译验证**
+
+```bash
+cd ccdi-project
+mvn clean compile
+```
+
+Expected: BUILD SUCCESS
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/config/AsyncThreadPoolConfig.java
+git commit -m "feat: 添加异步线程池配置"
+```
+
+---
+
+## 子计划1完成检查清单
+
+- [ ] 数据库表创建成功
+- [ ] 实体类编译通过
+- [ ] Mapper接口和XML映射正确
+- [ ] DTO和VO类创建完成
+- [ ] 线程池配置完成
+- [ ] 所有代码已提交到git
+
+**下一步：** 执行子计划2 - Service层核心实现

doc/plans/2026-03-05-async-file-upload-part2-service.md

@@ -0,0 +1,510 @@
+# 项目异步文件上传功能 - 子计划2：Service层核心实现
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 实现文件上传的核心业务逻辑，包括批量上传、异步处理、状态更新
+
+**Architecture:** 双层异步架构（调度线程 + 文件处理线程池），先插入记录后异步处理
+
+**Tech Stack:** Spring @Async, CompletableFuture, MyBatis Plus
+
+---
+
+## Task 1: Service 接口
+
+**Files:**
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiFileUploadService.java`
+
+**Step 1: 创建 Service 接口**
+
+创建文件 `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiFileUploadService.java`:
+
+```java
+package com.ruoyi.ccdi.project.service;
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.ruoyi.ccdi.project.domain.dto.CcdiFileUploadQueryDTO;
+import com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord;
+import com.ruoyi.ccdi.project.domain.vo.CcdiFileUploadStatisticsVO;
+import org.springframework.web.multipart.MultipartFile;
+
+/**
+ * 文件上传服务接口
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+public interface ICcdiFileUploadService {
+
+    /**
+     * 批量上传文件
+     *
+     * @param projectId 项目ID
+     * @param files 文件数组
+     * @param username 上传人
+     * @return 批次ID
+     */
+    String batchUploadFiles(Long projectId, MultipartFile[] files, String username);
+
+    /**
+     * 查询上传记录列表
+     *
+     * @param page 分页参数
+     * @param queryDTO 查询条件
+     * @return 分页结果
+     */
+    Page<CcdiFileUploadRecord> selectPage(Page<CcdiFileUploadRecord> page,
+                                          CcdiFileUploadQueryDTO queryDTO);
+
+    /**
+     * 统计各状态文件数量
+     *
+     * @param projectId 项目ID
+     * @return 统计结果
+     */
+    CcdiFileUploadStatisticsVO countByStatus(Long projectId);
+
+    /**
+     * 根据ID查询记录详情
+     *
+     * @param id 记录ID
+     * @return 记录详情
+     */
+    CcdiFileUploadRecord getById(Long id);
+}
+```
+
+**Step 2: 编译验证**
+
+```bash
+cd ccdi-project
+mvn clean compile
+```
+
+Expected: BUILD SUCCESS
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiFileUploadService.java
+git commit -m "feat: 添加文件上传服务接口"
+```
+
+---
+
+## Task 2: Service 实现 - Part 1: 基础CRUD方法
+
+**Files:**
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java`
+
+**Step 1: 创建 Service 实现类**
+
+创建文件 `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java`:
+
+```java
+package com.ruoyi.ccdi.project.service.impl;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.ruoyi.ccdi.project.domain.dto.CcdiFileUploadQueryDTO;
+import com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord;
+import com.ruoyi.ccdi.project.domain.vo.CcdiFileUploadStatisticsVO;
+import com.ruoyi.ccdi.project.mapper.CcdiFileUploadRecordMapper;
+import com.ruoyi.ccdi.project.service.ICcdiFileUploadService;
+import jakarta.annotation.Resource;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.util.StringUtils;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 文件上传服务实现
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Slf4j
+@Service
+public class CcdiFileUploadServiceImpl implements ICcdiFileUploadService {
+
+    @Resource
+    private CcdiFileUploadRecordMapper recordMapper;
+
+    @Override
+    public Page<CcdiFileUploadRecord> selectPage(Page<CcdiFileUploadRecord> page,
+                                                  CcdiFileUploadQueryDTO queryDTO) {
+        LambdaQueryWrapper<CcdiFileUploadRecord> queryWrapper = new LambdaQueryWrapper<>();
+
+        // 项目ID
+        if (queryDTO.getProjectId() != null) {
+            queryWrapper.eq(CcdiFileUploadRecord::getProjectId, queryDTO.getProjectId());
+        }
+
+        // 文件状态
+        if (StringUtils.hasText(queryDTO.getFileStatus())) {
+            queryWrapper.eq(CcdiFileUploadRecord::getFileStatus, queryDTO.getFileStatus());
+        }
+
+        // 文件名称（模糊查询）
+        if (StringUtils.hasText(queryDTO.getFileName())) {
+            queryWrapper.like(CcdiFileUploadRecord::getFileName, queryDTO.getFileName());
+        }
+
+        // 上传人
+        if (StringUtils.hasText(queryDTO.getUploadUser())) {
+            queryWrapper.eq(CcdiFileUploadRecord::getUploadUser, queryDTO.getUploadUser());
+        }
+
+        // 按上传时间倒序
+        queryWrapper.orderByDesc(CcdiFileUploadRecord::getUploadTime);
+
+        return recordMapper.selectPage(page, queryWrapper);
+    }
+
+    @Override
+    public CcdiFileUploadStatisticsVO countByStatus(Long projectId) {
+        // 查询统计数据
+        List<Map<String, Object>> statusCounts = recordMapper.countByStatus(projectId);
+
+        // 组装 VO
+        CcdiFileUploadStatisticsVO vo = new CcdiFileUploadStatisticsVO();
+        vo.setUploading(0L);
+        vo.setParsing(0L);
+        vo.setParsedSuccess(0L);
+        vo.setParsedFailed(0L);
+
+        long total = 0L;
+        for (Map<String, Object> item : statusCounts) {
+            String status = (String) item.get("status");
+            Long count = ((Number) item.get("count")).longValue();
+            total += count;
+
+            switch (status) {
+                case "uploading" -> vo.setUploading(count);
+                case "parsing" -> vo.setParsing(count);
+                case "parsed_success" -> vo.setParsedSuccess(count);
+                case "parsed_failed" -> vo.setParsedFailed(count);
+            }
+        }
+
+        vo.setTotal(total);
+        return vo;
+    }
+
+    @Override
+    public CcdiFileUploadRecord getById(Long id) {
+        return recordMapper.selectById(id);
+    }
+
+    // batchUploadFiles 方法将在下一步实现
+    @Override
+    public String batchUploadFiles(Long projectId, MultipartFile[] files, String username) {
+        // TODO: 将在下一步实现
+        throw new UnsupportedOperationException("Method not implemented yet");
+    }
+}
+```
+
+**Step 2: 编译验证**
+
+```bash
+cd ccdi-project
+mvn clean compile
+```
+
+Expected: BUILD SUCCESS
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java
+git commit -m "feat: 添加文件上传服务实现（基础CRUD方法）"
+```
+
+---
+
+## Task 3: Service 实现 - Part 2: 批量上传主方法
+
+**Files:**
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java`
+
+**Step 1: 实现批量上传主方法**
+
+在 `CcdiFileUploadServiceImpl.java` 中添加以下代码（替换原来的 TODO）：
+
+```java
+@Resource
+@org.springframework.beans.factory.annotation.Qualifier("fileUploadExecutor")
+private java.util.concurrent.Executor fileUploadExecutor;
+
+@Override
+public String batchUploadFiles(Long projectId, MultipartFile[] files, String username) {
+    log.info("【文件上传】开始批量上传: projectId={}, 文件数量={}, username={}",
+             projectId, files.length, username);
+
+    // 1. 生成批次ID
+    String batchId = java.util.UUID.randomUUID().toString().replace("-", "");
+
+    // 2. 获取项目的 lsfxProjectId
+    // TODO: 需要注入 CcdiProjectMapper 并查询项目信息
+    // Integer lsfxProjectId = project.getLsfxProjectId();
+    Integer lsfxProjectId = 1; // 临时硬编码，稍后修复
+
+    // 3. 批量插入文件记录（status=uploading）
+    List<CcdiFileUploadRecord> records = new java.util.ArrayList<>();
+    java.util.Date now = new java.util.Date();
+
+    for (MultipartFile file : files) {
+        CcdiFileUploadRecord record = new CcdiFileUploadRecord();
+        record.setProjectId(projectId);
+        record.setLsfxProjectId(lsfxProjectId);
+        record.setFileName(file.getOriginalFilename());
+        record.setFileSize(file.getSize());
+        record.setFileStatus("uploading");
+        record.setUploadTime(now);
+        record.setUploadUser(username);
+        records.add(record);
+    }
+
+    recordMapper.insertBatch(records);
+    log.info("【文件上传】批量插入记录成功: 数量={}", records.size());
+
+    // 4. 异步启动调度线程提交任务
+    final Integer finalLsfxProjectId = lsfxProjectId;
+    java.util.concurrent.CompletableFuture.runAsync(() -> {
+        submitTasksAsync(projectId, finalLsfxProjectId, files, records, batchId);
+    });
+
+    log.info("【文件上传】批量上传任务已提交: batchId={}", batchId);
+    return batchId;
+}
+
+/**
+ * 调度线程：循环提交任务到线程池
+ * 支持等待30秒重试机制
+ */
+private void submitTasksAsync(Long projectId, Integer lsfxProjectId,
+                               MultipartFile[] files,
+                               List<CcdiFileUploadRecord> records,
+                               String batchId) {
+    log.info("【文件上传】调度线程启动: projectId={}, batchId={}", projectId, batchId);
+
+    // 循环提交任务
+    for (int i = 0; i < files.length; i++) {
+        MultipartFile file = files[i];
+        CcdiFileUploadRecord record = records.get(i);
+
+        boolean submitted = false;
+        int retryCount = 0;
+
+        while (!submitted && retryCount < 2) {
+            try {
+                // 尝试提交异步任务
+                java.util.concurrent.CompletableFuture.runAsync(
+                    () -> processFileAsync(projectId, lsfxProjectId, file,
+                                           record.getId(), batchId, record),
+                    fileUploadExecutor
+                );
+                submitted = true;
+                log.info("【文件上传】任务提交成功: fileName={}, recordId={}",
+                         file.getOriginalFilename(), record.getId());
+            } catch (java.util.concurrent.RejectedExecutionException e) {
+                retryCount++;
+                if (retryCount == 1) {
+                    log.warn("【文件上传】线程池已满，等待30秒后重试: fileName={}",
+                             file.getOriginalFilename());
+                    try {
+                        Thread.sleep(30000);
+                    } catch (InterruptedException ie) {
+                        Thread.currentThread().interrupt();
+                        log.error("【文件上传】等待被中断: fileName={}", file.getOriginalFilename());
+                        updateRecordStatus(record.getId(), "parsed_failed", "任务提交被中断");
+                        break;
+                    }
+                } else {
+                    log.error("【文件上传】重试失败，放弃任务: fileName={}", file.getOriginalFilename());
+                    updateRecordStatus(record.getId(), "parsed_failed", "系统繁忙，请稍后重试");
+                }
+            }
+        }
+    }
+
+    log.info("【文件上传】调度线程完成: projectId={}, batchId={}", projectId, batchId);
+}
+
+/**
+ * 更新记录状态（辅助方法）
+ */
+private void updateRecordStatus(Long recordId, String status, String errorMessage) {
+    CcdiFileUploadRecord record = new CcdiFileUploadRecord();
+    record.setId(recordId);
+    record.setFileStatus(status);
+    record.setErrorMessage(errorMessage);
+    recordMapper.updateById(record);
+}
+
+/**
+ * 异步处理单个文件的完整流程
+ * TODO: 下一步实现完整逻辑
+ */
+private void processFileAsync(Long projectId, Integer lsfxProjectId, MultipartFile file,
+                               Long recordId, String batchId, CcdiFileUploadRecord record) {
+    // TODO: 将在下一步实现
+    log.info("【文件上传】开始处理文件: fileName={}", file.getOriginalFilename());
+}
+```
+
+**Step 2: 编译验证**
+
+```bash
+cd ccdi-project
+mvn clean compile
+```
+
+Expected: BUILD SUCCESS
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java
+git commit -m "feat: 实现批量上传主方法和调度线程"
+```
+
+---
+
+## Task 4: Service 实现 - Part 3: 异步处理单个文件
+
+**Files:**
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java`
+
+**Step 1: 实现异步处理单个文件的完整流程**
+
+在 `CcdiFileUploadServiceImpl.java` 中，替换 `processFileAsync` 方法：
+
+```java
+/**
+ * 异步处理单个文件的完整流程
+ * 包含：上传 → 轮询解析状态 → 获取结果 → 保存流水数据
+ */
+@org.springframework.scheduling.annotation.Async("fileUploadExecutor")
+public void processFileAsync(Long projectId, Integer lsfxProjectId, MultipartFile file,
+                               Long recordId, String batchId, CcdiFileUploadRecord record) {
+    log.info("【文件上传】开始处理文件: fileName={}, recordId={}",
+             file.getOriginalFilename(), recordId);
+
+    try {
+        // 步骤1：状态已是uploading，记录已存在
+
+        // 步骤2：上传文件到流水分析平台
+        log.info("【文件上传】步骤2: 上传文件到流水分析平台");
+        // TODO: 调用 lsfxClient.uploadFile()
+        // UploadFileResponse uploadResponse = lsfxClient.uploadFile(lsfxProjectId, file);
+        // Integer logId = uploadResponse.getData().getLogId();
+
+        // 临时模拟 logId
+        Integer logId = (int) (System.currentTimeMillis() % 1000000);
+
+        // 步骤3：更新状态为 parsing
+        log.info("【文件上传】步骤3: 更新状态为解析中, logId={}", logId);
+        record.setLogId(logId);
+        record.setFileStatus("parsing");
+        recordMapper.updateById(record);
+
+        // 步骤4：轮询解析状态（最多300次，间隔2秒）
+        log.info("【文件上传】步骤4: 开始轮询解析状态");
+        // TODO: 实现真实的轮询逻辑
+        // boolean parsingComplete = waitForParsingComplete(lsfxProjectId, logId.toString());
+        boolean parsingComplete = true; // 临时模拟
+
+        if (!parsingComplete) {
+            throw new RuntimeException("解析超时（超过10分钟），请检查文件格式是否正确");
+        }
+
+        // 步骤5：获取文件上传状态
+        log.info("【文件上传】步骤5: 获取文件上传状态");
+        // TODO: 调用 lsfxClient.getFileUploadStatus()
+        // GetFileUploadStatusResponse statusResponse = lsfxClient.getFileUploadStatus(...);
+
+        // 步骤6：判断解析结果
+        // TODO: 实现真实的判断逻辑
+        boolean parseSuccess = true; // 临时模拟
+
+        if (parseSuccess) {
+            // 解析成功
+            log.info("【文件上传】步骤6: 解析成功，保存主体信息");
+            record.setFileStatus("parsed_success");
+            record.setEnterpriseNames("测试主体1,测试主体2");
+            record.setAccountNos("622xxx,623xxx");
+            recordMapper.updateById(record);
+
+            // 步骤7：获取流水数据并保存
+            log.info("【文件上传】步骤7: 获取流水数据");
+            // TODO: 实现 fetchAndSaveBankStatements
+            // fetchAndSaveBankStatements(projectId, lsfxProjectId, logId, totalCount);
+
+        } else {
+            // 解析失败
+            log.warn("【文件上传】步骤6: 解析失败");
+            record.setFileStatus("parsed_failed");
+            record.setErrorMessage("解析失败：文件格式错误");
+            recordMapper.updateById(record);
+        }
+
+        log.info("【文件上传】处理完成: fileName={}", file.getOriginalFilename());
+
+    } catch (Exception e) {
+        log.error("【文件上传】处理失败: fileName={}", file.getOriginalFilename(), e);
+        updateRecordStatus(recordId, "parsed_failed", e.getMessage());
+    }
+}
+
+/**
+ * 轮询解析状态
+ * TODO: 实现真实逻辑
+ */
+private boolean waitForParsingComplete(Integer groupId, String logId) {
+    // TODO: 调用 lsfxClient.checkParseStatus() 轮询
+    return true;
+}
+
+/**
+ * 获取并保存流水数据
+ * TODO: 实现真实逻辑
+ */
+private void fetchAndSaveBankStatements(Long projectId, Integer groupId,
+                                         Integer logId, int totalCount) {
+    // TODO: 调用 lsfxClient.getBankStatement() 获取流水
+    // TODO: 批量插入到 ccdi_bank_statement
+}
+```
+
+**Step 2: 编译验证**
+
+```bash
+cd ccdi-project
+mvn clean compile
+```
+
+Expected: BUILD SUCCESS
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java
+git commit -m "feat: 实现异步处理单个文件的完整流程"
+```
+
+---
+
+## 子计划2完成检查清单
+
+- [ ] Service接口创建完成
+- [ ] 基础CRUD方法实现并测试通过
+- [ ] 批量上传主方法实现完成
+- [ ] 调度线程和重试机制实现
+- [ ] 异步处理单个文件流程实现
+- [ ] 所有代码已提交到git
+
+**下一步：** 执行子计划3 - Controller和API文档

doc/plans/2026-03-05-async-file-upload-part3-controller.md

@@ -0,0 +1,477 @@
+# 项目异步文件上传功能 - 子计划3：Controller和文档
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 实现文件上传的 REST API 接口，提供批量上传、查询、统计等功能
+
+**Architecture:** RESTful API 设计，参数校验，异常处理，Swagger 文档
+
+**Tech Stack:** Spring MVC, Swagger/OpenAPI 3.0, Jackson
+
+---
+
+## Task 1: Controller 实现
+
+**Files:**
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiFileUploadController.java`
+
+**Step 1: 创建 Controller**
+
+创建文件 `ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiFileUploadController.java`:
+
+```java
+package com.ruoyi.ccdi.project.controller;
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.ruoyi.ccdi.project.domain.dto.CcdiFileUploadQueryDTO;
+import com.ruoyi.ccdi.project.domain.entity.CcdiFileUploadRecord;
+import com.ruoyi.ccdi.project.domain.vo.CcdiFileUploadStatisticsVO;
+import com.ruoyi.ccdi.project.service.ICcdiFileUploadService;
+import com.ruoyi.common.core.controller.BaseController;
+import com.ruoyi.common.core.domain.AjaxResult;
+import com.ruoyi.common.core.page.TableDataInfo;
+import com.ruoyi.common.utils.SecurityUtils;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.util.concurrent.RejectedExecutionException;
+
+/**
+ * 文件上传 Controller
+ *
+ * @author ruoyi
+ * @date 2026-03-05
+ */
+@Slf4j
+@RestController
+@RequestMapping("/ccdi/file-upload")
+@Tag(name = "文件上传管理", description = "项目文件上传相关接口")
+public class CcdiFileUploadController extends BaseController {
+
+    @Resource
+    private ICcdiFileUploadService fileUploadService;
+
+    /**
+     * 批量上传文件（异步）
+     */
+    @PostMapping("/batch")
+    @Operation(summary = "批量上传文件", description = "异步批量上传流水文件")
+    public AjaxResult batchUpload(@RequestParam Long projectId,
+                                    @RequestParam MultipartFile[] files) {
+        // 参数校验
+        if (projectId == null) {
+            return AjaxResult.error("项目ID不能为空");
+        }
+        if (files == null || files.length == 0) {
+            return AjaxResult.error("请选择要上传的文件");
+        }
+        if (files.length > 100) {
+            return AjaxResult.error("单次最多上传100个文件");
+        }
+
+        // 校验文件大小和格式
+        for (MultipartFile file : files) {
+            if (file.isEmpty()) {
+                return AjaxResult.error("文件不能为空");
+            }
+            if (file.getSize() > 50 * 1024 * 1024) {
+                return AjaxResult.error("文件 " + file.getOriginalFilename() + " 超过50MB限制");
+            }
+            String fileName = file.getOriginalFilename();
+            if (!fileName.endsWith(".xlsx") && !fileName.endsWith(".xls")) {
+                return AjaxResult.error("文件 " + fileName + " 格式不支持，仅支持Excel文件");
+            }
+        }
+
+        try {
+            String username = SecurityUtils.getUsername();
+            String batchId = fileUploadService.batchUploadFiles(projectId, files, username);
+            return AjaxResult.success("上传任务已提交", batchId);
+        } catch (RejectedExecutionException e) {
+            log.warn("线程池已满，拒绝上传请求: projectId={}, fileCount={}", projectId, files.length);
+            return AjaxResult.error("系统繁忙，请稍后再试");
+        } catch (Exception e) {
+            log.error("批量上传失败: projectId={}", projectId, e);
+            return AjaxResult.error("上传失败：" + e.getMessage());
+        }
+    }
+
+    /**
+     * 查询上传记录列表
+     */
+    @GetMapping("/list")
+    @Operation(summary = "查询上传记录列表", description = "分页查询文件上传记录")
+    public TableDataInfo list(CcdiFileUploadQueryDTO queryDTO) {
+        Page<CcdiFileUploadRecord> page = new Page<>(getPageNum(), getPageSize());
+        Page<CcdiFileUploadRecord> result = fileUploadService.selectPage(page, queryDTO);
+        return getDataTable(result.getRecords(), result.getTotal());
+    }
+
+    /**
+     * 查询上传统计
+     */
+    @GetMapping("/statistics/{projectId}")
+    @Operation(summary = "查询上传统计", description = "统计各状态的文件数量")
+    public AjaxResult getStatistics(@PathVariable Long projectId) {
+        CcdiFileUploadStatisticsVO statistics = fileUploadService.countByStatus(projectId);
+        return AjaxResult.success(statistics);
+    }
+
+    /**
+     * 查询记录详情
+     */
+    @GetMapping("/detail/{id}")
+    @Operation(summary = "查询记录详情", description = "根据ID查询文件上传记录详情")
+    public AjaxResult getDetail(@PathVariable Long id) {
+        CcdiFileUploadRecord record = fileUploadService.getById(id);
+        return AjaxResult.success(record);
+    }
+}
+```
+
+**Step 2: 编译验证**
+
+```bash
+cd ccdi-project
+mvn clean compile
+```
+
+Expected: BUILD SUCCESS
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiFileUploadController.java
+git commit -m "feat: 添加文件上传Controller"
+```
+
+---
+
+## Task 2: API 文档
+
+**Files:**
+- Create: `doc/api-docs/ccdi-file-upload-api.md`
+
+**Step 1: 创建 API 文档**
+
+创建文件 `doc/api-docs/ccdi-file-upload-api.md`:
+
+```markdown
+# 文件上传 API 文档
+
+## 1. 批量上传文件
+
+### 接口地址
+POST /ccdi/file-upload/batch
+
+### 请求参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| projectId | Long | 是 | 项目ID |
+| files | File[] | 是 | 文件数组（最多100个，单个最大50MB） |
+
+### 请求示例
+```bash
+curl -X POST "http://localhost:8080/ccdi/file-upload/batch" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -F "projectId=1" \
+  -F "files=@/path/to/file1.xlsx" \
+  -F "files=@/path/to/file2.xlsx"
+```
+
+### 返回示例
+```json
+{
+  "code": 200,
+  "msg": "上传任务已提交",
+  "data": "a1b2c3d4e5f6g7h8"
+}
+```
+
+### 返回字段说明
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| code | Integer | 状态码，200表示成功 |
+| msg | String | 提示信息 |
+| data | String | 批次ID，用于追踪上传任务 |
+
+### 错误码说明
+| code | msg | 说明 |
+|------|-----|------|
+| 500 | 项目ID不能为空 | 缺少必填参数 |
+| 500 | 请选择要上传的文件 | 文件数组为空 |
+| 500 | 单次最多上传100个文件 | 文件数量超限 |
+| 500 | 文件 xxx 超过50MB限制 | 文件大小超限 |
+| 500 | 文件 xxx 格式不支持，仅支持Excel文件 | 文件格式错误 |
+| 500 | 系统繁忙，请稍后再试 | 线程池已满 |
+
+---
+
+## 2. 查询上传记录列表
+
+### 接口地址
+GET /ccdi/file-upload/list
+
+### 请求参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| projectId | Long | 否 | 项目ID |
+| fileStatus | String | 否 | 文件状态：uploading/parsing/parsed_success/parsed_failed |
+| fileName | String | 否 | 文件名称（模糊查询） |
+| uploadUser | String | 否 | 上传人 |
+| pageNum | Integer | 否 | 页码，默认1 |
+| pageSize | Integer | 否 | 每页数量，默认10 |
+
+### 请求示例
+```bash
+curl -X GET "http://localhost:8080/ccdi/file-upload/list?projectId=1&fileStatus=parsed_success&pageNum=1&pageSize=10" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### 返回示例
+```json
+{
+  "code": 200,
+  "msg": "查询成功",
+  "rows": [
+    {
+      "id": 1,
+      "projectId": 1,
+      "lsfxProjectId": 100,
+      "logId": 123456,
+      "fileName": "流水1.xlsx",
+      "fileSize": 2621440,
+      "fileStatus": "parsed_success",
+      "enterpriseNames": "张三,李四",
+      "accountNos": "622xxx,623xxx",
+      "uploadTime": "2026-03-05 10:30:00",
+      "uploadUser": "admin"
+    }
+  ],
+  "total": 100
+}
+```
+
+### 返回字段说明
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| rows | Array | 记录列表 |
+| total | Long | 总记录数 |
+
+---
+
+## 3. 查询上传统计
+
+### 接口地址
+GET /ccdi/file-upload/statistics/{projectId}
+
+### 路径参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| projectId | Long | 是 | 项目ID |
+
+### 请求示例
+```bash
+curl -X GET "http://localhost:8080/ccdi/file-upload/statistics/1" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### 返回示例
+```json
+{
+  "code": 200,
+  "msg": "查询成功",
+  "data": {
+    "uploading": 2,
+    "parsing": 3,
+    "parsedSuccess": 15,
+    "parsedFailed": 1,
+    "total": 21
+  }
+}
+```
+
+### 返回字段说明
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| uploading | Long | 上传中数量 |
+| parsing | Long | 解析中数量 |
+| parsedSuccess | Long | 解析成功数量 |
+| parsedFailed | Long | 解析失败数量 |
+| total | Long | 总数量 |
+
+---
+
+## 4. 查询记录详情
+
+### 接口地址
+GET /ccdi/file-upload/detail/{id}
+
+### 路径参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| id | Long | 是 | 记录ID |
+
+### 请求示例
+```bash
+curl -X GET "http://localhost:8080/ccdi/file-upload/detail/1" \
+  -H "Authorization: Bearer YOUR_TOKEN"
+```
+
+### 返回示例
+```json
+{
+  "code": 200,
+  "msg": "查询成功",
+  "data": {
+    "id": 1,
+    "projectId": 1,
+    "lsfxProjectId": 100,
+    "logId": 123456,
+    "fileName": "流水1.xlsx",
+    "fileSize": 2621440,
+    "fileStatus": "parsed_success",
+    "enterpriseNames": "张三,李四",
+    "accountNos": "622xxx,623xxx",
+    "errorMessage": null,
+    "uploadTime": "2026-03-05 10:30:00",
+    "uploadUser": "admin"
+  }
+}
+```
+
+---
+
+## 5. 文件状态说明
+
+| 状态 | 说明 |
+|------|------|
+| uploading | 文件上传中 |
+| parsing | 文件解析中 |
+| parsed_success | 文件解析成功 |
+| parsed_failed | 文件解析失败 |
+
+---
+
+## 6. 通用说明
+
+### 认证方式
+所有接口需要在请求头中携带 Token：
+```
+Authorization: Bearer YOUR_TOKEN
+```
+
+### 获取 Token
+```bash
+POST /login/test?username=admin&password=admin123
+```
+
+### 响应格式
+所有接口统一返回格式：
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": {}
+}
+```
+
+### 错误处理
+当发生错误时，返回格式：
+```json
+{
+  "code": 500,
+  "msg": "错误信息"
+}
+```
+```
+
+**Step 2: 提交文档**
+
+```bash
+git add doc/api-docs/ccdi-file-upload-api.md
+git commit -m "docs: 添加文件上传API文档"
+```
+
+---
+
+## Task 3: 最终提交和推送
+
+**Step 1: 查看所有修改**
+
+```bash
+git status
+git log --oneline -10
+```
+
+**Step 2: 推送到远程仓库**
+
+```bash
+git push origin dev
+```
+
+Expected: 推送成功
+
+**Step 3: 验证 Swagger 文档**
+
+```bash
+# 启动应用后访问
+# http://localhost:8080/swagger-ui/index.html
+# 查找 "文件上传管理" 分组
+```
+
+---
+
+## 子计划3完成检查清单
+
+- [ ] Controller实现完成
+- [ ] 参数校验正确
+- [ ] 异常处理完善
+- [ ] API文档创建完成
+- [ ] Swagger注解正确
+- [ ] 所有代码已提交并推送到远程仓库
+
+---
+
+## 功能总结
+
+**已完成的完整功能:**
+- ✅ 数据库表创建和索引
+- ✅ 实体类、DTO、VO 创建
+- ✅ Mapper 接口和 XML 映射（支持批量插入和统计）
+- ✅ 线程池配置（容量100，AbortPolicy拒绝策略）
+- ✅ Service 接口和实现（核心异步处理逻辑）
+- ✅ Controller 接口（批量上传、查询、统计、详情）
+- ✅ API 文档
+
+**核心特性:**
+- ✅ 双层异步架构（调度线程 + 文件处理线程池）
+- ✅ 智能重试机制（线程池满时等待30秒重试1次）
+- ✅ 完整的状态追踪（4种状态）
+- ✅ 批量插入优化（使用自定义XML）
+- ✅ 完善的参数校验和异常处理
+- ✅ Swagger API 文档
+
+**后续优化方向:**
+- ⏳ 完善流水分析平台接口调用（当前为模拟逻辑）
+- ⏳ 实现自定义日志 Appender（独立批次日志文件）
+- ⏳ 前端页面开发
+- ⏳ 更完善的轮询和重试机制
+- ⏳ 性能监控和告警
+
+**部署检查清单:**
+- [ ] 数据库表已创建
+- [ ] 线程池配置正确（容量100）
+- [ ] 文件上传大小限制配置（50MB）
+- [ ] 流水分析平台地址配置正确
+- [ ] 日志目录权限正确
+- [ ] 应用启动成功
+- [ ] Swagger 文档可访问
+
+---
+
+**所有子计划执行完成！**

doc/plans/2026-03-05-async-file-upload-part4-frontend.md

@@ -0,0 +1,355 @@
+# 异步文件上传功能实施计划 - Part 4: 前端开发
+
+## 文档信息
+- **创建日期**: 2026-03-05
+- **版本**: v1.1
+- **作者**: Claude
+- **关联设计**: [前端设计文档](../design/2026-03-05-async-file-upload-frontend-design.md)
+- **变更说明**: 移除WebSocket，改为页面轮询机制
+
+## 任务概述
+
+根据前端设计文档，扩展UploadData.vue组件实现异步批量上传功能。
+
+**预计工时**: 4.5个工作日
+
+## 任务清单
+
+### 任务 1: API接口封装（0.5天）
+
+**文件**: `ruoyi-ui/src/api/ccdiProjectUpload.js`
+
+**工作内容**:
+```javascript
+// 批量上传文件
+export function batchUploadFiles(projectId, files) {
+  const formData = new FormData()
+  files.forEach(file => formData.append('files', file))
+  formData.append('projectId', projectId)
+  
+  return request({
+    url: '/ccdi/file-upload/batch',
+    method: 'post',
+    data: formData,
+    timeout: 300000
+  })
+}
+
+// 查询文件上传记录列表
+export function getFileUploadList(params) {
+  return request({
+    url: '/ccdi/file-upload/list',
+    method: 'get',
+    params
+  })
+}
+
+// 查询文件上传统计
+export function getFileUploadStatistics(projectId) {
+  return request({
+    url: `/ccdi/file-upload/statistics/${projectId}`,
+    method: 'get'
+  })
+}
+```
+
+### 任务 2: 批量上传弹窗（1天）
+
+**文件**: `ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue`
+
+**主要修改**:
+1. 添加批量上传弹窗状态
+2. 修改`handleUploadClick`方法
+3. 实现文件选择和校验逻辑
+4. 实现批量上传功能
+
+**关键代码**:
+```javascript
+// 批量上传
+async handleBatchUpload() {
+  if (this.selectedFiles.length === 0) {
+    this.$message.warning('请选择要上传的文件')
+    return
+  }
+  
+  this.uploadLoading = true
+  
+  try {
+    await batchUploadFiles(
+      this.projectId,
+      this.selectedFiles.map(f => f.raw)
+    )
+    
+    this.uploadLoading = false
+    this.batchUploadDialogVisible = false
+    
+    this.$message.success('上传任务已提交，请查看处理进度')
+    
+    // 刷新数据并启动轮询
+    await Promise.all([
+      this.loadStatistics(),
+      this.loadFileList()
+    ])
+    
+    this.startPolling()
+    
+  } catch (error) {
+    this.uploadLoading = false
+    this.$message.error('上传失败：' + (error.msg || '未知错误'))
+  }
+}
+```
+
+### 任务 3: 统计卡片（0.5天）
+
+**工作内容**:
+1. 添加统计数据状态
+2. 实现统计卡片组件
+3. 实现点击筛选功能
+
+**模板代码**:
+```vue
+<div class="statistics-section">
+  <div class="stat-card" @click="handleStatusFilter('uploading')">
+    <div class="stat-icon uploading">
+      <i class="el-icon-upload"></i>
+    </div>
+    <div class="stat-content">
+      <div class="stat-label">上传中</div>
+      <div class="stat-value">{{ statistics.uploading }}</div>
+    </div>
+  </div>
+  <!-- 其他3个统计卡片 -->
+</div>
+```
+
+### 任务 4: 文件列表（1天）
+
+**工作内容**:
+1. 添加文件列表状态
+2. 实现文件列表组件
+3. 实现分页和筛选
+4. 实现操作按钮
+
+**关键方法**:
+```javascript
+// 加载文件列表
+async loadFileList() {
+  this.listLoading = true
+  
+  try {
+    const res = await getFileUploadList({
+      projectId: this.projectId,
+      fileStatus: this.queryParams.fileStatus,
+      pageNum: this.queryParams.pageNum,
+      pageSize: this.queryParams.pageSize
+    })
+    
+    this.fileList = res.rows || []
+    this.total = res.total || 0
+    
+  } finally {
+    this.listLoading = false
+  }
+}
+```
+
+### 任务 5: 轮询机制（0.5天）
+
+**优先级**: P0  
+**依赖**: 任务2、任务3、任务4完成
+
+**工作内容**:
+
+1. **添加轮询状态**:
+```javascript
+data() {
+  return {
+    // 轮询相关
+    pollingTimer: null,
+    pollingEnabled: false,
+    pollingInterval: 5000  // 5秒轮询间隔
+  }
+}
+```
+
+2. **生命周期钩子**:
+```javascript
+mounted() {
+  this.loadStatistics()
+  this.loadFileList()
+  
+  // 检查是否需要启动轮询
+  this.$nextTick(() => {
+    if (this.statistics.uploading > 0 || this.statistics.parsing > 0) {
+      this.startPolling()
+    }
+  })
+},
+
+beforeDestroy() {
+  this.stopPolling()
+}
+```
+
+3. **轮询方法**:
+```javascript
+methods: {
+  /**
+   * 启动轮询
+   */
+  startPolling() {
+    if (this.pollingEnabled) {
+      return  // 已经在轮询中
+    }
+    
+    this.pollingEnabled = true
+    console.log('启动轮询')
+    
+    const poll = () => {
+      if (!this.pollingEnabled) {
+        return
+      }
+      
+      // 刷新统计数据和列表
+      Promise.all([
+        this.loadStatistics(),
+        this.loadFileList()
+      ]).then(() => {
+        // 检查是否需要继续轮询
+        if (this.statistics.uploading === 0 && 
+            this.statistics.parsing === 0) {
+          this.stopPolling()
+          console.log('所有任务已完成，停止轮询')
+          return
+        }
+        
+        // 继续下一次轮询
+        this.pollingTimer = setTimeout(poll, this.pollingInterval)
+      }).catch(error => {
+        console.error('轮询失败:', error)
+        // 发生错误时继续轮询
+        this.pollingTimer = setTimeout(poll, this.pollingInterval)
+      })
+    }
+    
+    // 立即执行一次
+    poll()
+  },
+  
+  /**
+   * 停止轮询
+   */
+  stopPolling() {
+    this.pollingEnabled = false
+    
+    if (this.pollingTimer) {
+      clearTimeout(this.pollingTimer)
+      this.pollingTimer = null
+    }
+    
+    console.log('停止轮询')
+  },
+  
+  /**
+   * 手动刷新
+   */
+  async handleManualRefresh() {
+    await Promise.all([
+      this.loadStatistics(),
+      this.loadFileList()
+    ])
+    
+    this.$message.success('刷新成功')
+    
+    // 如果有进行中的任务，启动轮询
+    if (this.statistics.uploading > 0 || this.statistics.parsing > 0) {
+      this.startPolling()
+    }
+  },
+  
+  /**
+   * 状态筛选
+   */
+  handleStatusFilter(status) {
+    this.queryParams.fileStatus = status
+    this.queryParams.pageNum = 1
+    this.loadFileList()
+  }
+}
+```
+
+4. **在模板中添加刷新按钮**:
+```vue
+<el-button 
+  icon="el-icon-refresh" 
+  @click="handleManualRefresh"
+>
+  刷新
+</el-button>
+```
+
+#### 5.2 验证方式
+
+1. **启动轮询测试**：
+   - 上传文件后，检查控制台输出"启动轮询"
+   - 观察5秒后数据是否自动刷新
+
+2. **停止轮询测试**：
+   - 等待所有文件处理完成
+   - 检查控制台输出"停止轮询"
+
+3. **手动刷新测试**：
+   - 点击刷新按钮
+   - 验证数据立即更新
+   - 验证提示消息显示
+
+4. **页面销毁测试**：
+   - 切换到其他页面
+   - 检查控制台输出"停止轮询"
+   - 确认定时器被清除
+
+### 任务 6: 联调测试（1天）
+
+**测试项**:
+1. 批量上传功能
+2. 统计卡片展示和筛选
+3. 文件列表展示和分页
+4. 轮询机制（启动、停止、手动刷新）
+5. 操作按钮（查看流水、查看错误）
+
+## 验收标准
+
+- [ ] 所有API接口正常调用
+- [ ] 批量上传弹窗正常工作
+- [ ] 统计卡片正常显示和筛选
+- [ ] 文件列表正常展示和操作
+- [ ] 轮询机制正常（自动启动/停止/手动刷新）
+- [ ] 所有测试项通过
+
+## 轮询优化建议（可选）
+
+**智能轮询间隔**：
+```javascript
+// 根据活跃任务数动态调整轮询间隔
+getPollingInterval() {
+  const { uploading, parsing } = this.statistics
+  const activeCount = uploading + parsing
+  
+  if (activeCount > 50) {
+    return 3000  // 大量任务时，3秒轮询
+  } else if (activeCount > 10) {
+    return 5000  // 正常情况，5秒轮询
+  } else {
+    return 10000  // 少量任务时，10秒轮询
+  }
+}
+```
+
+**用户体验优化**：
+- 在页面顶部显示"自动刷新中..."状态提示
+- 支持用户手动开关轮询开关
+
+---
+
+**文档结束**

docs/design/2026-03-04-lsfx-interface-update-design.md

@@ -0,0 +1,585 @@
+# 流水分析接口功能更新设计文档
+
+**文档版本**: v1.0
+**创建日期**: 2026-03-04
+**作者**: Claude Code
+**状态**: 已批准
+
+---
+
+## 1. 项目背景和需求分析
+
+### 1.1 背景
+
+根据最新的接口文档 `assets/对接流水分析/兰溪-流水分析对接3.md`，需要对现有的流水分析对接模块(ccdi-lsfx)进行更新。当前实现包含5个接口，缺少2个关键接口。
+
+### 1.2 需求
+
+**主要需求:**
+1. 新增2个缺失的接口(获取单个文件上传状态、删除文件)
+2. 更新所有现有接口以匹配最新文档规范
+3. 保持与Mock Server的兼容性(使用当前配置)
+4. 完善参数校验和错误处理
+
+**当前实现状态:**
+- ✅ 已实现: getToken, uploadFile, fetchInnerFlow, checkParseStatus, getBankStatement (5个)
+- ❌ 缺失: getFileUploadStatus, deleteFiles (2个)
+
+---
+
+## 2. 架构设计
+
+### 2.1 整体架构
+
+```
+ccdi-lsfx模块
+├── client/
+│   └── LsfxAnalysisClient.java (添加2个新方法,更新现有方法)
+├── controller/
+│   └── LsfxTestController.java (添加2个测试接口,更新现有接口)
+├── domain/
+│   ├── request/
+│   │   ├── GetFileUploadStatusRequest.java (新增)
+│   │   ├── DeleteFilesRequest.java (新增)
+│   │   └── FetchInnerFlowRequest.java (更新)
+│   └── response/
+│       ├── GetFileUploadStatusResponse.java (新增)
+│       └── DeleteFilesResponse.java (新增)
+├── constants/
+│   └── LsfxConstants.java (添加新常量)
+├── util/
+│   └── HttpUtil.java (添加GET请求支持)
+└── config/ (通过application.yml配置)
+```
+
+### 2.2 模块职责
+
+| 层级 | 职责 | 变更 |
+|------|------|------|
+| Controller | 接口暴露、参数校验、响应封装 | 新增2个接口,更新3个接口 |
+| Client | 业务逻辑封装、API调用 | 新增2个方法,更新4个方法 |
+| Domain | 数据传输对象定义 | 新增4个DTO类 |
+| Util | HTTP请求工具 | 新增GET方法 |
+| Constants | 常量定义 | 新增固定值和状态常量 |
+| Config | 配置管理 | 新增2个endpoint配置 |
+
+---
+
+## 3. 数据模型设计
+
+### 3.1 新增Request DTO
+
+#### 3.1.1 GetFileUploadStatusRequest (接口5)
+
+```java
+@Data
+public class GetFileUploadStatusRequest {
+    /** 项目ID (必填) */
+    private Integer groupId;
+
+    /** 文件ID (可选,不传则查询所有) */
+    private Integer logId;
+}
+```
+
+**说明:**
+- `groupId`: 必填,从getToken接口获取
+- `logId`: 可选,不传则查询项目下所有文件
+
+#### 3.1.2 DeleteFilesRequest (接口6)
+
+```java
+@Data
+public class DeleteFilesRequest {
+    /** 项目ID (必填) */
+    private Integer groupId;
+
+    /** 文件ID数组 (必填) */
+    private Integer[] logIds;
+
+    /** 用户柜员号 (必填) */
+    private Integer userId;
+}
+```
+
+**说明:**
+- `logIds`: 支持批量删除,传递文件ID数组
+- `userId`: 用于权限验证和审计
+
+### 3.2 新增Response DTO
+
+#### 3.2.1 GetFileUploadStatusResponse (接口5)
+
+```java
+@Data
+public class GetFileUploadStatusResponse {
+    private String code;
+    private String status;
+    private Boolean successResponse;
+    private FileUploadStatusData data;
+
+    @Data
+    public static class FileUploadStatusData {
+        /** 日志列表 */
+        private List<LogItem> logs;
+
+        /** 状态 */
+        private String status;
+
+        /** 账号ID */
+        private Integer accountId;
+
+        /** 币种 */
+        private String currency;
+    }
+
+    @Data
+    public static class LogItem {
+        // 完整字段定义见实施文档
+        // 关键字段:
+        private List<String> enterpriseNameList;  // 主体名称列表
+        private List<String> accountNoList;       // 账号列表
+        private Integer status;                    // 状态值(-5表示成功)
+        private String uploadStatusDesc;          // 状态描述
+        private Integer logId;                    // 文件ID
+    }
+}
+```
+
+**关键字段说明:**
+- `enterpriseNameList`: 仅有一个空字符串""时,表示未生成主体
+- `status=-5` 且 `uploadStatusDesc="data.wait.confirm.newaccount"` 表示解析成功
+
+#### 3.2.2 DeleteFilesResponse (接口6)
+
+```java
+@Data
+public class DeleteFilesResponse {
+    private String code;
+    private String status;
+    private Boolean successResponse;
+    private DeleteFilesData data;
+    private String message;
+
+    @Data
+    public static class DeleteFilesData {
+        /** 删除成功消息 */
+        private String message;
+    }
+}
+```
+
+### 3.3 更新现有DTO
+
+#### 3.3.1 FetchInnerFlowRequest (接口3)
+
+```java
+@Data
+public class FetchInnerFlowRequest {
+    // ... 现有字段 ...
+
+    /** 校验码 (新增,固定值"ZJRCU") */
+    private String dataChannelCode;
+
+    // ... 其他字段 ...
+}
+```
+
+### 3.4 常量定义
+
+```java
+public class LsfxConstants {
+    // 固定值常量
+    public static final String DEFAULT_USER_ID = "902001";
+    public static final String DEFAULT_USER_NAME = "902001";
+    public static final String DEFAULT_APP_ID = "remote_app";
+    public static final String DEFAULT_ROLE = "VIEWER";
+    public static final String DEFAULT_ANALYSIS_TYPE = "-1";
+    public static final String DEFAULT_ORG_CODE = "902000";
+    public static final String DEFAULT_DEPARTMENT_CODE = "902000";
+    public static final String DEFAULT_DATA_CHANNEL_CODE = "ZJRCU";
+
+    // 状态常量
+    public static final Integer PARSE_STATUS_SUCCESS = -5;
+    public static final String PARSE_STATUS_DESC_SUCCESS = "data.wait.confirm.newaccount";
+}
+```
+
+---
+
+## 4. 接口详细设计
+
+### 4.1 新增接口
+
+#### 4.1.1 接口5: 获取单个文件上传状态
+
+**接口信息:**
+- 路径: `/watson/api/project/bs/upload`
+- 方法: GET
+- 请求头: `X-Xencio-Client-Id`
+
+**请求参数:**
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| groupId | Integer | 是 | 项目ID |
+| logId | Integer | 否 | 文件ID(不传则查询所有) |
+
+**成功标识:**
+- `status = -5`
+- `uploadStatusDesc = "data.wait.confirm.newaccount"`
+
+**使用场景:**
+- 文件解析完成后获取主体名称和账号
+- 判断是否需要生成主体(`enterpriseNameList`为空字符串)
+
+#### 4.1.2 接口6: 删除文件
+
+**接口信息:**
+- 路径: `/watson/api/project/batchDeleteUploadFile`
+- 方法: POST
+- 请求头: `X-Xencio-Client-Id`
+- Content-Type: multipart/form-data
+
+**请求参数:**
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| groupId | Integer | 是 | 项目ID |
+| logIds | Integer[] | 是 | 文件ID数组 |
+| userId | Integer | 是 | 用户柜员号 |
+
+**使用场景:**
+- 文件解析失败后清理文件
+- 删除错误上传的文件
+- 批量删除不需要的文件
+
+### 4.2 更新现有接口
+
+#### 4.2.1 接口1: getToken
+
+**更新内容:**
+- 添加固定值默认值处理
+- 简化必填参数校验
+
+**默认值设置:**
+```java
+userId: "902001" (如果未传)
+userName: "902001" (如果未传)
+role: "VIEWER" (如果未传)
+analysisType: "-1" (如果未传)
+```
+
+#### 4.2.2 接口3: fetchInnerFlow
+
+**更新内容:**
+- 添加 `dataChannelCode` 字段
+- 默认值: "ZJRCU"
+
+#### 4.2.3 接口4: checkParseStatus
+
+**更新内容:**
+- 完善方法注释,添加轮询说明
+- 明确成功状态码判断逻辑
+
+**轮询说明:**
+```
+建议轮询间隔: 1秒
+成功条件: parsing=false 且 status=-5 且 uploadStatusDesc="data.wait.confirm.newaccount"
+```
+
+#### 4.2.4 接口2,5,7
+
+**更新内容:**
+- 完善Swagger文档注释
+- 添加状态常量说明
+
+---
+
+## 5. 完整调用流程
+
+### 5.1 标准流程图
+
+```
+开始
+  ↓
+1. getToken - 创建项目获取Token
+  返回: token, projectId
+  ↓
+2a. uploadFile - 上传文件
+  或
+2b. fetchInnerFlow - 拉取行内流水
+  返回: logId列表
+  ↓
+3. checkParseStatus - 检查解析状态(轮询)
+  建议: 每隔1秒轮询,直到parsing=false
+  ↓
+4. 判断解析结果
+  ├─ 成功(status=-5 且 desc="data.wait.confirm.newaccount")
+  │   ↓
+  │ 5. getFileUploadStatus - 获取文件状态(可选)
+  │   返回: enterpriseNameList, accountNoList
+  │   ↓
+  │ 6. getBankStatement - 获取银行流水
+  │   返回: bankStatementList
+  │   ↓
+  │ 结束(成功)
+  │
+  └─ 失败(status != -5)
+      ↓
+     7. deleteFiles - 删除文件
+      返回: 删除成功消息
+      ↓
+     结束(失败)
+```
+
+### 5.2 典型调用示例
+
+#### 示例1: 文件上传流程
+
+```bash
+# 1. 获取Token
+POST /lsfx/test/getToken
+{
+  "projectNo": "902000_1709907600000",
+  "entityName": "902000_202603041430"
+}
+
+# 响应: projectId=16238
+
+# 2. 上传文件
+POST /lsfx/test/uploadFile
+groupId=16238, file=银行流水.csv
+
+# 响应: logId=19135
+
+# 3. 检查解析状态(轮询)
+POST /lsfx/test/checkParseStatus
+groupId=16238, inprogressList=19135
+
+# 响应: parsing=false, status=-5
+
+# 4. 获取文件状态
+GET /lsfx/test/getFileUploadStatus
+groupId=16238, logId=19135
+
+# 响应: enterpriseNameList=["张三"], accountNoList=["1234567890"]
+
+# 5. 获取银行流水
+POST /lsfx/test/getBankStatement
+{
+  "groupId": 16238,
+  "logId": 19135,
+  "pageNow": 1,
+  "pageSize": 100
+}
+```
+
+#### 示例2: 解析失败处理流程
+
+```bash
+# 前面步骤相同...
+
+# 3. 检查解析状态
+响应: parsing=false, status=-1, uploadStatusDesc="data.parse.error"
+
+# 4. 删除文件
+POST /lsfx/test/deleteFiles
+{
+  "groupId": 16238,
+  "logIds": [19135],
+  "userId": 902001
+}
+```
+
+---
+
+## 6. 测试计划
+
+### 6.1 单元测试用例
+
+| ID | 测试场景 | 测试接口 | 测试数据 | 预期结果 |
+|----|---------|---------|---------|---------|
+| UT01 | 获取Token-成功 | getToken | 完整必填参数 | code=200, 返回token |
+| UT02 | 获取Token-缺少参数 | getToken | 缺少projectNo | 返回错误提示 |
+| UT03 | 上传文件-成功 | uploadFile | groupId, 有效CSV | code=200, 返回logId |
+| UT04 | 上传文件-文件过大 | uploadFile | 超过10MB文件 | 返回文件超限错误 |
+| UT05 | 拉取流水-成功 | fetchInnerFlow | customerNo, 日期范围 | code=200, 返回logId列表 |
+| UT06 | 拉取流水-日期错误 | fetchInnerFlow | 开始>结束日期 | 返回日期错误提示 |
+| UT07 | 检查状态-解析中 | checkParseStatus | 刚上传的文件 | parsing=true |
+| UT08 | 检查状态-完成 | checkParseStatus | 解析完成的文件 | parsing=false, status=-5 |
+| UT09 | 获取文件状态-单个 | getFileUploadStatus | groupId, logId | 返回文件状态信息 |
+| UT10 | 获取文件状态-全部 | getFileUploadStatus | groupId, 不传logId | 返回所有文件状态 |
+| UT11 | 删除文件-成功 | deleteFiles | groupId, logIds, userId | code=200, message=success |
+| UT12 | 删除文件-缺少logIds | deleteFiles | 空logIds数组 | 返回错误提示 |
+| UT13 | 获取流水-分页 | getBankStatement | pageNow=1, pageSize=10 | 返回10条记录 |
+
+### 6.2 集成测试场景
+
+**场景1: 完整文件上传流程**
+```
+getToken → uploadFile → checkParseStatus(轮询) → getFileUploadStatus → getBankStatement
+```
+
+**场景2: 完整行内流水流程**
+```
+getToken → fetchInnerFlow → checkParseStatus(轮询) → getFileUploadStatus → getBankStatement
+```
+
+**场景3: 解析失败处理流程**
+```
+uploadFile(错误文件) → checkParseStatus(失败) → deleteFiles
+```
+
+**场景4: 边界条件测试**
+- 大文件上传(接近10MB)
+- 大量数据分页获取(pageSize=1000)
+- 并发多个文件上传
+
+### 6.3 Mock Server测试
+
+**需要更新的Mock接口:**
+- `GET /watson/api/project/bs/upload` - 返回模拟文件状态
+- `POST /watson/api/project/batchDeleteUploadFile` - 返回删除成功消息
+
+---
+
+## 7. 实施计划
+
+### 7.1 实施阶段
+
+**阶段一: 数据模型层 (1小时)**
+- 创建4个新DTO类
+- 更新1个现有DTO
+- 更新常量类
+
+**阶段二: 工具类增强 (30分钟)**
+- 扩展HttpUtil支持GET请求
+
+**阶段三: 客户端层 (1.5小时)**
+- 新增2个Client方法
+- 更新4个现有方法
+
+**阶段四: 控制器层 (1小时)**
+- 新增2个Controller接口
+- 更新3个现有接口
+
+**阶段五: 配置更新 (15分钟)**
+- 更新application-dev.yml
+
+**阶段六: Mock Server更新 (30分钟)**
+- 更新Python Mock Server
+
+**阶段七: 测试验证 (1小时)**
+- 单元测试
+- 集成测试
+- Swagger文档测试
+
+**阶段八: 文档编写 (30分钟)**
+- API文档
+- 测试报告
+
+**总计: 约6小时**
+
+### 7.2 文件清单
+
+**新增文件 (8个):**
+```
+ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/request/
+├── GetFileUploadStatusRequest.java
+└── DeleteFilesRequest.java
+
+ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/
+├── GetFileUploadStatusResponse.java
+└── DeleteFilesResponse.java
+
+doc/
+├── api-docs/lsfx-api-v3.md
+├── design/2026-03-04-lsfx-interface-update-design.md
+└── test-scripts/lsfx-test-report-20260304.md
+```
+
+**修改文件 (7个):**
+```
+ccdi-lsfx/src/main/java/com/ruoyi/lsfx/
+├── client/LsfxAnalysisClient.java
+├── controller/LsfxTestController.java
+├── constants/LsfxConstants.java
+├── util/HttpUtil.java
+└── domain/request/FetchInnerFlowRequest.java
+
+ruoyi-admin/src/main/resources/
+└── application-dev.yml
+
+lsfx-mock-server/
+└── app.py
+```
+
+---
+
+## 8. 风险分析
+
+### 8.1 技术风险
+
+| 风险项 | 影响 | 概率 | 缓解措施 |
+|--------|------|------|---------|
+| GET请求参数传递方式不明确 | 中 | 低 | 参考文档示例,进行实际测试 |
+| 数组参数传递格式问题 | 中 | 中 | 查阅HTTP规范,使用正确的传递方式 |
+| 状态码判断逻辑错误 | 高 | 低 | 严格按文档实现,添加详细日志 |
+
+### 8.2 兼容性风险
+
+| 风险项 | 影响 | 概率 | 缓解措施 |
+|--------|------|------|---------|
+| 现有接口调用者受影响 | 中 | 低 | 保持接口签名兼容,只增加功能 |
+| 配置变更需要重启 | 低 | 高 | 在文档中明确说明 |
+
+### 8.3 测试风险
+
+| 风险项 | 影响 | 概率 | 缓解措施 |
+|--------|------|------|---------|
+| Mock数据与真实接口不一致 | 中 | 中 | 严格按照文档构造Mock响应 |
+| 边界条件未覆盖 | 中 | 中 | 设计全面的测试用例 |
+
+---
+
+## 9. 验收标准
+
+### 9.1 功能验收
+
+- ✅ 所有7个接口都能正常调用
+- ✅ 参数校验正确(必填、格式、范围)
+- ✅ 响应格式符合文档定义
+- ✅ 错误处理完善(异常捕获、日志记录)
+
+### 9.2 代码质量
+
+- ✅ 遵循项目编码规范
+- ✅ 代码注释完整清晰
+- ✅ 日志记录完善
+- ✅ 无明显的性能问题
+
+### 9.3 文档完整性
+
+- ✅ API文档完整
+- ✅ 测试报告完整
+- ✅ 设计文档已保存
+
+---
+
+## 10. 附录
+
+### 10.1 参考资料
+
+- `assets/对接流水分析/兰溪-流水分析对接3.md` - 最新接口文档
+- `CLAUDE.md` - 项目开发规范
+- Spring Boot 3 文档
+- MyBatis Plus 文档
+
+### 10.2 变更历史
+
+| 版本 | 日期 | 作者 | 变更内容 |
+|------|------|------|---------|
+| v1.0 | 2026-03-04 | Claude Code | 初始版本 |
+
+---
+
+**文档结束**

docs/plans/2026-03-04-bank-statement-entity-design.md

@@ -0,0 +1,603 @@
+# 银行流水实体类与数据转换设计文档
+
+**日期：** 2026-03-04
+**模块：** ccdi-project
+**作者：** Claude
+
+---
+
+## 一、概述
+
+### 1.1 目标
+
+创建银行流水实体类 `CcdiBankStatement`，用于持久化从流水分析平台获取的流水数据，并提供数据转换方法。
+
+### 1.2 背景
+
+- 流水分析平台提供 `GetBankStatementResponse.BankStatementItem` 接口响应对象
+- 需要将响应数据转换为本地数据库实体进行持久化
+- 流水数据需要关联到具体项目（`ccdi_project` 表）
+
+### 1.3 技术选型
+
+| 技术点 | 选择 | 理由 |
+|--------|------|------|
+| ORM框架 | MyBatis Plus 3.5.10 | 项目已集成，简化CRUD操作 |
+| 对象映射 | Spring BeanUtils | 无需额外依赖，简单易用 |
+| 数据库 | MySQL 8.2.0 | 项目标准数据库 |
+| 实体类注解 | Lombok @Data | 简化代码，提高可读性 |
+
+---
+
+## 二、架构设计
+
+### 2.1 模块位置
+
+**主模块：** `ccdi-project` （项目管理模块）
+
+**依赖关系：**
+```
+ccdi-project (流水实体类所在模块)
+    └── 依赖 ccdi-lsfx (访问流水分析响应类)
+        └── 依赖 ruoyi-common (通用工具)
+```
+
+### 2.2 包结构
+
+```
+ccdi-project/
+├── src/main/java/com/ruoyi/ccdi/project/
+│   ├── domain/
+│   │   └── entity/
+│   │       └── CcdiBankStatement.java  (核心实体类)
+│   ├── mapper/
+│   │   └── CcdiBankStatementMapper.java (数据访问层)
+│   └── service/
+│       ├── IBankStatementService.java
+│       └── impl/BankStatementServiceImpl.java
+└── src/main/resources/
+    └── mapper/ccdi/project/
+        └── CcdiBankStatementMapper.xml
+```
+
+### 2.3 核心组件
+
+**1. 实体类：** `CcdiBankStatement`
+- 39个字段（38个原有字段 + 1个新增字段）
+- 包含静态转换方法 `fromResponse()`
+- 使用 MyBatis Plus 注解进行映射
+
+**2. Mapper接口：** `CcdiBankStatementMapper`
+- 继承 `BaseMapper<CcdiBankStatement>`
+- 提供批量插入方法
+
+**3. Service层：** 调用转换方法，设置业务字段
+
+---
+
+## 三、数据模型设计
+
+### 3.1 数据库表结构修改
+
+**表名：** `ccdi_bank_statement`
+
+**新增字段：**
+```sql
+ALTER TABLE `ccdi_bank_statement`
+ADD COLUMN `project_id` bigint(20) DEFAULT NULL COMMENT '关联项目ID' AFTER `bank_statement_id`,
+ADD INDEX `idx_project_id` (`project_id`);
+```
+
+**说明：**
+- `project_id` 关联 `ccdi_project` 表的主键
+- `group_id` 字段保留，用于兼容流水分析平台的原始项目ID
+
+### 3.2 字段映射关系
+
+**总字段数：** 39个
+
+**字段分类：**
+
+| 分类 | 字段数 | 说明 |
+|------|--------|------|
+| 主键和关联 | 4 | bank_statement_id, project_id, le_id, group_id |
+| 账号信息 | 5 | account_id, le_account_name, le_account_no, accounting_date_id, accounting_date |
+| 交易信息 | 5 | trx_date, currency, amount_dr, amount_cr, amount_balance |
+| 交易类型 | 5 | cash_type, trx_flag, trx_type, exception_type, internal_flag |
+| 对手方信息 | 5 | customer_le_id, customer_account_name, customer_account_no, customer_bank, customer_reference |
+| 摘要备注 | 4 | user_memo, bank_comments, bank_trx_number, bank |
+| 批次上传 | 2 | batch_id, batch_sequence |
+| 附加字段 | 7 | meta_json, no_balance, begin_balance, end_balance, override_bs_id, payment_method, cret_no |
+| 审计字段 | 2 | create_date, created_by |
+
+**特殊字段处理：**
+
+| 数据库字段 | 响应字段 | 处理方式 |
+|-----------|---------|---------|
+| le_account_no | accountMaskNo | 手动映射 |
+| customer_account_no | customerAccountMaskNo | 手动映射 |
+| batch_sequence | uploadSequnceNumber | 手动映射 |
+| meta_json | - | 强制设为 null |
+| project_id | - | Service层设置 |
+
+### 3.3 实体类字段类型
+
+```java
+// 数值类型
+private Long bankStatementId;      // 主键
+private Long projectId;            // 项目ID（新增）
+private Long accountId;            // 账号ID
+private Integer leId;              // 企业ID
+private Integer groupId;           // 项目ID（原有）
+private Integer accountingDateId;  // 账号日期ID
+private Integer customerLeId;      // 对手方企业ID
+private Integer trxType;           // 分类ID
+private Integer internalFlag;      // 内部交易标志
+private Integer batchId;           // 批次ID
+private Integer batchSequence;     // 批次序号
+private Integer noBalance;         // 是否包含余额
+private Integer beginBalance;      // 初始余额
+private Integer endBalance;        // 结束余额
+private Long overrideBsId;         // 覆盖标识
+private Long createdBy;            // 创建者
+
+// 金额类型
+private BigDecimal amountDr;       // 付款金额
+private BigDecimal amountCr;       // 收款金额
+private BigDecimal amountBalance;  // 余额
+
+// 字符串类型
+private String leAccountName;      // 企业账号名称
+private String leAccountNo;        // 企业银行账号
+private String accountingDate;     // 账号日期
+private String trxDate;            // 交易日期
+private String currency;           // 币种
+private String cashType;           // 交易类型
+private String trxFlag;            // 交易标志位
+private String exceptionType;      // 异常类型
+private String customerAccountName;// 对手方企业名称
+private String customerAccountNo;  // 对手方账号
+private String customerBank;       // 对手方银行
+private String customerReference;  // 对手方备注
+private String userMemo;           // 用户交易摘要
+private String bankComments;       // 银行交易摘要
+private String bankTrxNumber;      // 银行交易号
+private String bank;               // 所属银行缩写
+private String metaJson;           // meta json
+private String paymentMethod;      // 交易方式
+private String cretNo;             // 身份证号
+
+// 日期类型
+private Date createDate;           // 创建时间
+```
+
+---
+
+## 四、转换方法设计
+
+### 4.1 方法签名
+
+```java
+/**
+ * 从流水分析接口响应转换为实体
+ *
+ * @param item 流水分析接口返回的流水项
+ * @return 流水实体，如果 item 为 null 则返回 null
+ */
+public static CcdiBankStatement fromResponse(BankStatementItem item)
+```
+
+### 4.2 转换逻辑
+
+```java
+public static CcdiBankStatement fromResponse(BankStatementItem item) {
+    // 1. 空值检查
+    if (item == null) {
+        return null;
+    }
+
+    // 2. 创建实体对象
+    CcdiBankStatement entity = new CcdiBankStatement();
+
+    // 3. 使用 BeanUtils 复制同名字段
+    BeanUtils.copyProperties(item, entity);
+
+    // 4. 手动映射字段名不一致的情况
+    entity.setLeAccountNo(item.getAccountMaskNo());
+    entity.setCustomerAccountNo(item.getCustomerAccountMaskNo());
+    entity.setBatchSequence(item.getUploadSequnceNumber());
+
+    // 5. 特殊字段处理
+    entity.setMetaJson(null);  // 根据文档要求强制设为 null
+
+    // 6. 注意：project_id 需要在 Service 层设置
+
+    return entity;
+}
+```
+
+### 4.3 BeanUtils 行为说明
+
+| 场景 | BeanUtils 行为 |
+|------|---------------|
+| 字段名相同且类型兼容 | 自动复制 |
+| 字段名相同但类型不兼容 | 抛出异常 |
+| 源对象中不存在目标字段 | 忽略，不抛异常 |
+| 目标对象中不存在源字段 | 忽略，不抛异常 |
+| 源字段为 null | 复制 null 值到目标字段 |
+
+**注意事项：**
+- BeanUtils 会忽略响应对象中额外的字段（如 `transAmount`, `attachments` 等）
+- 需要手动处理字段名不一致的3个字段
+- `meta_json` 字段强制设为 null
+
+---
+
+## 五、使用示例
+
+### 5.1 Service层调用
+
+```java
+@Service
+public class BankStatementServiceImpl implements IBankStatementService {
+
+    @Resource
+    private CcdiBankStatementMapper bankStatementMapper;
+
+    @Resource
+    private LsfxAnalysisClient lsfxClient;
+
+    /**
+     * 获取并保存流水数据
+     *
+     * @param projectId 项目ID
+     * @param request 查询请求
+     * @return 保存的记录数
+     */
+    public int fetchAndSaveBankStatements(Long projectId, GetBankStatementRequest request) {
+        // 1. 调用流水分析接口
+        GetBankStatementResponse response = lsfxClient.getBankStatement(request);
+
+        // 2. 校验响应
+        if (response == null || !Boolean.TRUE.equals(response.getSuccessResponse())) {
+            throw new ServiceException("获取流水数据失败");
+        }
+
+        List<BankStatementItem> items = response.getData().getBankStatementList();
+        if (items == null || items.isEmpty()) {
+            return 0;
+        }
+
+        // 3. 转换并设置项目ID
+        List<CcdiBankStatement> entities = items.stream()
+            .map(item -> {
+                CcdiBankStatement entity = CcdiBankStatement.fromResponse(item);
+                if (entity != null) {
+                    entity.setProjectId(projectId);  // 设置关联项目ID
+                }
+                return entity;
+            })
+            .filter(Objects::nonNull)
+            .collect(Collectors.toList());
+
+        // 4. 批量插入数据库
+        return bankStatementMapper.insertBatch(entities);
+    }
+}
+```
+
+### 5.2 单条数据转换
+
+```java
+// 从接口响应转换单条流水
+BankStatementItem item = response.getData().getBankStatementList().get(0);
+CcdiBankStatement entity = CcdiBankStatement.fromResponse(item);
+
+// 设置业务字段
+entity.setProjectId(1001L);
+
+// 保存到数据库
+bankStatementMapper.insert(entity);
+```
+
+### 5.3 批量数据转换
+
+```java
+List<CcdiBankStatement> entities = response.getData().getBankStatementList()
+    .stream()
+    .map(CcdiBankStatement::fromResponse)
+    .peek(entity -> entity.setProjectId(projectId))
+    .collect(Collectors.toList());
+
+bankStatementMapper.insertBatch(entities);
+```
+
+---
+
+## 六、错误处理
+
+### 6.1 空指针异常防护
+
+**问题：** 接口响应可能为 null 或数据列表为空
+
+**解决方案：**
+```java
+// 在 fromResponse 方法中
+if (item == null) {
+    log.warn("流水项为空，无法转换");
+    return null;
+}
+
+// 在 Service 层
+if (response == null || !Boolean.TRUE.equals(response.getSuccessResponse())) {
+    throw new ServiceException("获取流水数据失败");
+}
+
+List<BankStatementItem> items = response.getData().getBankStatementList();
+if (items == null || items.isEmpty()) {
+    return 0;  // 正常返回，不是异常情况
+}
+```
+
+### 6.2 类型转换异常
+
+**问题：** BeanUtils 在字段类型不匹配时会抛出异常
+
+**解决方案：**
+1. 确保 `BankStatementItem` 和 `CcdiBankStatement` 字段类型一致
+2. BigDecimal、Integer、Long 类型已验证兼容
+3. 添加异常捕获日志：
+
+```java
+public static CcdiBankStatement fromResponse(BankStatementItem item) {
+    if (item == null) {
+        return null;
+    }
+
+    try {
+        CcdiBankStatement entity = new CcdiBankStatement();
+        BeanUtils.copyProperties(item, entity);
+        entity.setLeAccountNo(item.getAccountMaskNo());
+        entity.setCustomerAccountNo(item.getCustomerAccountMaskNo());
+        entity.setBatchSequence(item.getUploadSequnceNumber());
+        entity.setMetaJson(null);
+        return entity;
+    } catch (Exception e) {
+        log.error("流水数据转换失败, bankStatementId={}", item.getBankStatementId(), e);
+        throw new RuntimeException("流水数据转换失败", e);
+    }
+}
+```
+
+### 6.3 数据验证
+
+**必填字段验证：**
+```java
+// 在 Service 层验证业务字段
+if (entity.getProjectId() == null) {
+    throw new IllegalArgumentException("项目ID不能为空");
+}
+```
+
+**数据库约束：**
+- `bank_statement_id` 自增主键，无需验证
+- 其他字段根据业务需求设置数据库约束（NOT NULL、DEFAULT等）
+
+---
+
+## 七、性能考虑
+
+### 7.1 BeanUtils 性能
+
+**特点：**
+- 使用 Java 反射机制
+- 单次转换性能影响可忽略（< 1ms）
+- 批量转换时累计开销需要考虑
+
+**性能数据（参考）：**
+| 操作 | 耗时 |
+|------|------|
+| 单次 BeanUtils.copyProperties() | < 1ms |
+| 100次转换 | ~50ms |
+| 1000次转换 | ~200ms |
+
+**优化建议：**
+- 对于单次或小批量转换（<100条），直接使用 BeanUtils
+- 对于大批量转换（>1000条），可考虑：
+  1. 使用 MapStruct（编译期生成代码，无反射）
+  2. 异步批量处理
+  3. 分批插入数据库
+
+### 7.2 数据库批量插入
+
+**推荐方式：**
+```java
+// MyBatis Plus 批量插入
+@Service
+public class BankStatementServiceImpl {
+
+    @Resource
+    private CcdiBankStatementMapper bankStatementMapper;
+
+    public int insertBatch(List<CcdiBankStatement> entities) {
+        if (entities == null || entities.isEmpty()) {
+            return 0;
+        }
+
+        // 分批插入，每批 1000 条
+        int batchSize = 1000;
+        int totalInserted = 0;
+
+        for (int i = 0; i < entities.size(); i += batchSize) {
+            int end = Math.min(i + batchSize, entities.size());
+            List<CcdiBankStatement> batch = entities.subList(i, end);
+            bankStatementMapper.insertBatch(batch);
+            totalInserted += batch.size();
+        }
+
+        return totalInserted;
+    }
+}
+```
+
+### 7.3 内存考虑
+
+**对象占用空间估算：**
+- 单个 `CcdiBankStatement` 对象约 1KB（包含所有字段）
+- 1000条流水数据约占用 1MB 内存
+- 10000条流水数据约占用 10MB 内存
+
+**建议：**
+- 对于超大数据量（>10000条），使用流式处理：
+  ```java
+  response.getData().getBankStatementList()
+      .stream()
+      .map(CcdiBankStatement::fromResponse)
+      .forEach(entity -> {
+          // 立即处理，不保留在内存中
+          bankStatementMapper.insert(entity);
+      });
+  ```
+
+---
+
+## 八、测试策略
+
+### 8.1 单元测试
+
+**测试类：** `CcdiBankStatementTest`
+
+**测试用例：**
+
+| 测试场景 | 测试方法 | 验证点 |
+|---------|---------|--------|
+| 正常转换 | `testFromResponse_Success` | 所有字段正确映射 |
+| 空值处理 | `testFromResponse_Null` | 返回 null |
+| 字段名映射 | `testFromResponse_FieldMapping` | 3个特殊字段正确映射 |
+| meta_json | `testFromResponse_MetaJson` | 强制为 null |
+
+**测试代码示例：**
+```java
+@Test
+public void testFromResponse_Success() {
+    // 准备测试数据
+    BankStatementItem item = new BankStatementItem();
+    item.setBankStatementId(123456L);
+    item.setLeId(100);
+    item.setAccountMaskNo("6222****1234");
+    item.setDrAmount(new BigDecimal("1000.00"));
+
+    // 执行转换
+    CcdiBankStatement entity = CcdiBankStatement.fromResponse(item);
+
+    // 验证结果
+    assertNotNull(entity);
+    assertEquals(123456L, entity.getBankStatementId());
+    assertEquals(100, entity.getLeId());
+    assertEquals("6222****1234", entity.getLeAccountNo());
+    assertEquals(new BigDecimal("1000.00"), entity.getAmountDr());
+    assertNull(entity.getMetaJson());
+}
+```
+
+### 8.2 集成测试
+
+**测试场景：**
+1. 完整流程：调用接口 → 转换数据 → 保存数据库
+2. 数据库查询：验证字段值正确性
+3. 关联查询：验证 `project_id` 关联有效
+
+### 8.3 性能测试
+
+**测试指标：**
+- 单次转换耗时
+- 1000次批量转换耗时
+- 数据库批量插入耗时
+
+---
+
+## 九、部署检查清单
+
+### 9.1 数据库修改
+
+- [ ] 执行 ALTER TABLE 添加 `project_id` 字段
+- [ ] 创建索引 `idx_project_id`
+- [ ] 验证字段类型和长度
+
+### 9.2 代码检查
+
+- [ ] `ccdi-project` 模块已依赖 `ccdi-lsfx`
+- [ ] 实体类字段类型与数据库一致
+- [ ] 转换方法处理所有特殊字段
+- [ ] Service 层正确设置 `project_id`
+
+### 9.3 测试验证
+
+- [ ] 单元测试通过
+- [ ] 集成测试通过
+- [ ] 性能测试达标
+
+### 9.4 文档更新
+
+- [ ] 更新 CLAUDE.md 文档
+- [ ] 更新数据库设计文档
+- [ ] 添加 API 文档说明
+
+---
+
+## 十、附录
+
+### 10.1 完整字段映射表
+
+| 序号 | 数据库字段 | Java字段 | Java类型 | 响应字段 | 说明 |
+|------|-----------|---------|---------|---------|------|
+| 1 | bank_statement_id | bankStatementId | Long | bankStatementId | 主键自增 |
+| 2 | project_id | projectId | Long | - | **新增字段** |
+| 3 | LE_ID | leId | Integer | leId | 企业ID |
+| 4 | ACCOUNT_ID | accountId | Long | accountId | 账号ID |
+| 5 | LE_ACCOUNT_NAME | leAccountName | String | leName | 企业账号名称 |
+| 6 | LE_ACCOUNT_NO | leAccountNo | String | accountMaskNo | **手动映射** |
+| 7 | ACCOUNTING_DATE_ID | accountingDateId | Integer | accountingDateId | 账号日期ID |
+| 8 | ACCOUNTING_DATE | accountingDate | String | accountingDate | 账号日期 |
+| 9 | TRX_DATE | trxDate | String | trxDate | 交易日期 |
+| 10 | CURRENCY | currency | String | currency | 币种 |
+| 11 | AMOUNT_DR | amountDr | BigDecimal | drAmount | 付款金额 |
+| 12 | AMOUNT_CR | amountCr | BigDecimal | crAmount | 收款金额 |
+| 13 | AMOUNT_BALANCE | amountBalance | BigDecimal | balanceAmount | 余额 |
+| 14 | CASH_TYPE | cashType | String | cashType | 交易类型 |
+| 15 | CUSTOMER_LE_ID | customerLeId | Integer | customerId | 对手方企业ID |
+| 16 | CUSTOMER_ACCOUNT_NAME | customerAccountName | String | customerName | 对手方企业名称 |
+| 17 | CUSTOMER_ACCOUNT_NO | customerAccountNo | String | customerAccountMaskNo | **手动映射** |
+| 18 | customer_bank | customerBank | String | customerBank | 对手方银行 |
+| 19 | customer_reference | customerReference | String | customerReference | 对手方备注 |
+| 20 | USER_MEMO | userMemo | String | userMemo | 用户交易摘要 |
+| 21 | BANK_COMMENTS | bankComments | String | bankComments | 银行交易摘要 |
+| 22 | BANK_TRX_NUMBER | bankTrxNumber | String | bankTrxNumber | 银行交易号 |
+| 23 | BANK | bank | String | bank | 所属银行缩写 |
+| 24 | TRX_FLAG | trxFlag | String | transFlag | 交易标志位 |
+| 25 | TRX_TYPE | trxType | Integer | transTypeId | 分类ID |
+| 26 | EXCEPTION_TYPE | exceptionType | String | exceptionType | 异常类型 |
+| 27 | internal_flag | internalFlag | Integer | internalFlag | 是否为内部交易 |
+| 28 | batch_id | batchId | Integer | batchId | 上传logId |
+| 29 | batch_sequence | batchSequence | Integer | uploadSequnceNumber | **手动映射** |
+| 30 | CREATE_DATE | createDate | Date | createDate | 创建时间 |
+| 31 | created_by | createdBy | Long | createdBy | 创建者 |
+| 32 | meta_json | metaJson | String | - | **强制null** |
+| 33 | no_balance | noBalance | Integer | isNoBalance | 是否包含余额 |
+| 34 | begin_balance | beginBalance | Integer | isBeginBalance | 初始余额 |
+| 35 | end_balance | endBalance | Integer | isEndBalance | 结束余额 |
+| 36 | override_bs_id | overrideBsId | Long | overrideBsId | 覆盖标识 |
+| 37 | payment_method | paymentMethod | String | paymentMethod | 交易方式 |
+| 38 | cret_no | cretNo | String | cretNo | 身份证号 |
+| 39 | group_id | groupId | Integer | groupId | 项目id |
+
+### 10.2 参考文档
+
+- [ccdi_bank_statement.md](../../assets/对接流水分析/ccdi_bank_statement.md)
+- [MyBatis Plus 官方文档](https://baomidou.com/)
+- [Spring BeanUtils 文档](https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/beans/BeanUtils.html)
+
+---
+
+**文档版本：** 1.0
+**最后更新：** 2026-03-04

docs/plans/2026-03-04-bank-statement-implementation.md

@@ -0,0 +1,745 @@
+# 银行流水实体类实现计划
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**目标：** 创建 CcdiBankStatement 实体类，实现从流水分析接口响应到数据库实体的数据转换功能。
+
+**架构：** 在 ccdi-project 模块中创建实体类，使用 Spring BeanUtils 进行对象映射，手动处理字段名不一致的情况。实体类包含静态转换方法 fromResponse()。
+
+**技术栈：** MyBatis Plus 3.5.10, Spring BeanUtils, Lombok, MySQL 8.2.0
+
+---
+
+## 任务概览
+
+| 任务 | 预估时间 | 文件 |
+|------|---------|------|
+| Task 1: 数据库表修改 | 5分钟 | SQL脚本 |
+| Task 2: 创建实体类基础结构 | 10分钟 | CcdiBankStatement.java |
+| Task 3: 编写转换方法测试 | 15分钟 | CcdiBankStatementTest.java |
+| Task 4: 实现转换方法 | 10分钟 | CcdiBankStatement.java |
+| Task 5: 创建 Mapper 接口 | 5分钟 | CcdiBankStatementMapper.java |
+| Task 6: 创建 Mapper XML | 10分钟 | CcdiBankStatementMapper.xml |
+| Task 7: 验证测试 | 5分钟 | - |
+
+---
+
+## Task 1: 数据库表修改
+
+**目标：** 在 ccdi_bank_statement 表中添加 project_id 字段和索引。
+
+**文件：**
+- 创建: `sql/ccdi_bank_statement_add_project_id.sql`
+
+**Step 1: 创建数据库修改脚本**
+
+```sql
+-- 为 ccdi_bank_statement 表添加 project_id 字段
+ALTER TABLE `ccdi_bank_statement`
+ADD COLUMN `project_id` bigint(20) DEFAULT NULL COMMENT '关联项目ID' AFTER `bank_statement_id`,
+ADD INDEX `idx_project_id` (`project_id`);
+```
+
+**Step 2: 执行数据库修改脚本**
+
+```bash
+# 连接到数据库并执行脚本
+mysql -h 116.62.17.81 -u root -p ccdi < sql/ccdi_bank_statement_add_project_id.sql
+```
+
+**预期输出：** 执行成功，无错误信息。
+
+**Step 3: 验证字段已添加**
+
+```sql
+-- 查看表结构，确认 project_id 字段已添加
+SHOW COLUMNS FROM ccdi_bank_statement LIKE 'project_id';
+```
+
+**预期输出：**
+```
+Field        | Type       | Null | Key | Default | Extra
+-------------|------------|------|-----|---------|-------
+project_id   | bigint(20) | YES  | MUL | NULL    |
+```
+
+**Step 4: 提交**
+
+```bash
+git add sql/ccdi_bank_statement_add_project_id.sql
+git commit -m "feat: 为银行流水表添加 project_id 字段"
+```
+
+---
+
+## Task 2: 创建实体类基础结构
+
+**目标：** 创建 CcdiBankStatement 实体类的基础结构，包含所有字段定义。
+
+**文件：**
+- 创建: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java`
+
+**Step 1: 创建实体类文件**
+
+```java
+package com.ruoyi.ccdi.project.domain.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.math.BigDecimal;
+import java.util.Date;
+
+/**
+ * 银行流水对象 ccdi_bank_statement
+ *
+ * @author ruoyi
+ * @date 2026-03-04
+ */
+@Data
+@TableName("ccdi_bank_statement")
+public class CcdiBankStatement implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    // ===== 主键和关联字段 =====
+
+    /** 流水ID */
+    @TableId(type = IdType.AUTO)
+    private Long bankStatementId;
+
+    /** 关联项目ID（业务字段） */
+    private Long projectId;
+
+    /** 企业ID */
+    private Integer leId;
+
+    /** 账号ID */
+    private Long accountId;
+
+    /** 项目id（保留原有字段） */
+    private Integer groupId;
+
+    // ===== 账号信息 =====
+
+    /** 企业账号名称 */
+    private String leAccountName;
+
+    /** 企业银行账号 */
+    private String leAccountNo;
+
+    /** 账号日期ID */
+    private Integer accountingDateId;
+
+    /** 账号日期 */
+    private String accountingDate;
+
+    /** 交易日期 */
+    private String trxDate;
+
+    /** 币种 */
+    private String currency;
+
+    // ===== 交易金额 =====
+
+    /** 付款金额 */
+    private BigDecimal amountDr;
+
+    /** 收款金额 */
+    private BigDecimal amountCr;
+
+    /** 余额 */
+    private BigDecimal amountBalance;
+
+    // ===== 交易类型和标志 =====
+
+    /** 交易类型 */
+    private String cashType;
+
+    /** 交易标志位 */
+    private String trxFlag;
+
+    /** 分类ID */
+    private Integer trxType;
+
+    /** 异常类型 */
+    private String exceptionType;
+
+    /** 是否为内部交易 */
+    private Integer internalFlag;
+
+    // ===== 对手方信息 =====
+
+    /** 对手方企业ID */
+    private Integer customerLeId;
+
+    /** 对手方企业名称 */
+    private String customerAccountName;
+
+    /** 对手方账号 */
+    private String customerAccountNo;
+
+    /** 对手方银行 */
+    private String customerBank;
+
+    /** 对手方备注 */
+    private String customerReference;
+
+    // ===== 摘要和备注 =====
+
+    /** 用户交易摘要 */
+    private String userMemo;
+
+    /** 银行交易摘要 */
+    private String bankComments;
+
+    /** 银行交易号 */
+    private String bankTrxNumber;
+
+    // ===== 银行信息 =====
+
+    /** 所属银行缩写 */
+    private String bank;
+
+    // ===== 批次和上传信息 =====
+
+    /** 上传logId */
+    private Integer batchId;
+
+    /** 每次上传在文件中的line */
+    private Integer batchSequence;
+
+    // ===== 附加字段 =====
+
+    /** meta json（固定为null） */
+    private String metaJson;
+
+    /** 是否包含余额 */
+    private Integer noBalance;
+
+    /** 初始余额 */
+    private Integer beginBalance;
+
+    /** 结束余额 */
+    private Integer endBalance;
+
+    /** 覆盖标识 */
+    private Long overrideBsId;
+
+    /** 交易方式 */
+    private String paymentMethod;
+
+    /** 身份证号 */
+    private String cretNo;
+
+    // ===== 审计字段 =====
+
+    /** 创建时间 */
+    private Date createDate;
+
+    /** 创建者 */
+    private Long createdBy;
+}
+```
+
+**Step 2: 验证代码编译**
+
+```bash
+cd ccdi-project
+mvn compile
+```
+
+**预期输出：** BUILD SUCCESS
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java
+git commit -m "feat: 创建银行流水实体类基础结构"
+```
+
+---
+
+## Task 3: 编写转换方法测试
+
+**目标：** 使用 TDD 方法，先编写 fromResponse() 方法的单元测试。
+
+**文件：**
+- 创建: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatementTest.java`
+
+**Step 1: 添加测试依赖（如果不存在）**
+
+检查 `ccdi-project/pom.xml` 是否包含测试依赖：
+
+```xml
+<dependency>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-test</artifactId>
+    <scope>test</scope>
+</dependency>
+```
+
+如果没有，添加上述依赖。
+
+**Step 2: 创建测试类**
+
+```java
+package com.ruoyi.ccdi.project.domain.entity;
+
+import com.ruoyi.lsfx.domain.response.GetBankStatementResponse.BankStatementItem;
+import org.junit.jupiter.api.Test;
+
+import java.math.BigDecimal;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+/**
+ * 银行流水实体类测试
+ *
+ * @author ruoyi
+ * @date 2026-03-04
+ */
+class CcdiBankStatementTest {
+
+    @Test
+    void testFromResponse_Success() {
+        // 准备测试数据
+        BankStatementItem item = new BankStatementItem();
+        item.setBankStatementId(123456L);
+        item.setLeId(100);
+        item.setAccountId(200L);
+        item.setLeName("测试企业");
+        item.setAccountMaskNo("6222****1234");
+        item.setDrAmount(new BigDecimal("1000.00"));
+        item.setCrAmount(new BigDecimal("500.00"));
+        item.setBalanceAmount(new BigDecimal("5000.00"));
+        item.setTrxDate("2026-03-04");
+        item.setCustomerAccountMaskNo("6228****5678");
+        item.setUploadSequnceNumber(1);
+
+        // 执行转换
+        CcdiBankStatement entity = CcdiBankStatement.fromResponse(item);
+
+        // 验证结果
+        assertNotNull(entity, "转换结果不应为null");
+        assertEquals(123456L, entity.getBankStatementId(), "流水ID应该匹配");
+        assertEquals(100, entity.getLeId(), "企业ID应该匹配");
+        assertEquals(200L, entity.getAccountId(), "账号ID应该匹配");
+        assertEquals("测试企业", entity.getLeAccountName(), "企业名称应该匹配");
+
+        // 验证手动映射的字段
+        assertEquals("6222****1234", entity.getLeAccountNo(), "企业账号应该从 accountMaskNo 映射");
+        assertEquals("6228****5678", entity.getCustomerAccountNo(), "对手方账号应该从 customerAccountMaskNo 映射");
+        assertEquals(1, entity.getBatchSequence(), "批次序号应该从 uploadSequnceNumber 映射");
+
+        // 验证金额字段
+        assertEquals(new BigDecimal("1000.00"), entity.getAmountDr(), "付款金额应该匹配");
+        assertEquals(new BigDecimal("500.00"), entity.getAmountCr(), "收款金额应该匹配");
+        assertEquals(new BigDecimal("5000.00"), entity.getAmountBalance(), "余额应该匹配");
+
+        // 验证特殊字段
+        assertNull(entity.getMetaJson(), "metaJson 应该强制为 null");
+        assertNull(entity.getProjectId(), "projectId 应该为 null（需要 Service 层设置）");
+    }
+
+    @Test
+    void testFromResponse_Null() {
+        // 测试空值处理
+        CcdiBankStatement entity = CcdiBankStatement.fromResponse(null);
+
+        // 验证返回 null
+        assertNull(entity, "传入 null 应该返回 null");
+    }
+
+    @Test
+    void testFromResponse_EmptyObject() {
+        // 测试空对象转换
+        BankStatementItem item = new BankStatementItem();
+
+        // 执行转换
+        CcdiBankStatement entity = CcdiBankStatement.fromResponse(item);
+
+        // 验证不会抛出异常
+        assertNotNull(entity, "空对象转换结果不应为 null");
+        assertNull(entity.getMetaJson(), "metaJson 应该为 null");
+    }
+
+    @Test
+    void testFromResponse_FieldTypeCompatibility() {
+        // 测试字段类型兼容性
+        BankStatementItem item = new BankStatementItem();
+        item.setInternalFlag(1);  // Integer 类型
+        item.setTransTypeId(100);  // Integer 类型
+
+        // 执行转换
+        CcdiBankStatement entity = CcdiBankStatement.fromResponse(item);
+
+        // 验证类型转换正确
+        assertNotNull(entity, "转换结果不应为 null");
+        assertEquals(1, entity.getInternalFlag(), "Integer 类型应该正确复制");
+        assertEquals(100, entity.getTrxType(), "Integer 类型应该正确复制");
+    }
+}
+```
+
+**Step 3: 运行测试验证失败**
+
+```bash
+cd ccdi-project
+mvn test -Dtest=CcdiBankStatementTest
+```
+
+**预期输出：** 编译失败，因为 `fromResponse()` 方法还不存在。
+
+**Step 4: 提交**
+
+```bash
+git add ccdi-project/src/test/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatementTest.java
+git commit -m "test: 添加银行流水转换方法的单元测试"
+```
+
+---
+
+## Task 4: 实现转换方法
+
+**目标：** 在 CcdiBankStatement 实体类中实现 fromResponse() 静态方法。
+
+**文件：**
+- 修改: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java`
+
+**Step 1: 添加必要的导入**
+
+在文件顶部添加：
+
+```java
+import com.ruoyi.lsfx.domain.response.GetBankStatementResponse.BankStatementItem;
+import org.springframework.beans.BeanUtils;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+```
+
+**Step 2: 添加日志常量**
+
+在类的开头添加：
+
+```java
+private static final Logger log = LoggerFactory.getLogger(CcdiBankStatement.class);
+```
+
+**Step 3: 实现 fromResponse() 方法**
+
+在类的末尾（createdBy 字段之后）添加转换方法：
+
+```java
+/**
+ * 从流水分析接口响应转换为实体
+ *
+ * @param item 流水分析接口返回的流水项
+ * @return 流水实体，如果 item 为 null 则返回 null
+ */
+public static CcdiBankStatement fromResponse(BankStatementItem item) {
+    // 1. 空值检查
+    if (item == null) {
+        log.warn("流水项为空，无法转换");
+        return null;
+    }
+
+    try {
+        // 2. 创建实体对象
+        CcdiBankStatement entity = new CcdiBankStatement();
+
+        // 3. 使用 BeanUtils 复制同名字段
+        BeanUtils.copyProperties(item, entity);
+
+        // 4. 手动映射字段名不一致的情况
+        entity.setLeAccountNo(item.getAccountMaskNo());
+        entity.setCustomerAccountNo(item.getCustomerAccountMaskNo());
+        entity.setBatchSequence(item.getUploadSequnceNumber());
+
+        // 5. 特殊字段处理
+        entity.setMetaJson(null);  // 根据文档要求强制设为 null
+
+        // 注意：project_id 需要在 Service 层根据业务逻辑设置
+
+        return entity;
+    } catch (Exception e) {
+        log.error("流水数据转换失败, bankStatementId={}", item.getBankStatementId(), e);
+        throw new RuntimeException("流水数据转换失败", e);
+    }
+}
+```
+
+**Step 4: 运行测试验证通过**
+
+```bash
+cd ccdi-project
+mvn test -Dtest=CcdiBankStatementTest
+```
+
+**预期输出：**
+```
+Tests run: 4, Failures: 0, Errors: 0, Skipped: 0
+[INFO] BUILD SUCCESS
+```
+
+**Step 5: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java
+git commit -m "feat: 实现银行流水转换方法 fromResponse()"
+```
+
+---
+
+## Task 5: 创建 Mapper 接口
+
+**目标：** 创建 MyBatis Mapper 接口，继承 BaseMapper 并提供批量插入方法。
+
+**文件：**
+- 创建: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiBankStatementMapper.java`
+
+**Step 1: 创建 Mapper 接口**
+
+```java
+package com.ruoyi.ccdi.project.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.ruoyi.ccdi.project.domain.entity.CcdiBankStatement;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
+
+/**
+ * 银行流水Mapper接口
+ *
+ * @author ruoyi
+ * @date 2026-03-04
+ */
+public interface CcdiBankStatementMapper extends BaseMapper<CcdiBankStatement> {
+
+    /**
+     * 批量插入银行流水
+     *
+     * @param list 银行流水列表
+     * @return 插入记录数
+     */
+    int insertBatch(@Param("list") List<CcdiBankStatement> list);
+}
+```
+
+**Step 2: 验证代码编译**
+
+```bash
+cd ccdi-project
+mvn compile
+```
+
+**预期输出：** BUILD SUCCESS
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiBankStatementMapper.java
+git commit -m "feat: 创建银行流水 Mapper 接口"
+```
+
+---
+
+## Task 6: 创建 Mapper XML
+
+**目标：** 创建 MyBatis XML 映射文件，实现批量插入 SQL。
+
+**文件：**
+- 创建: `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiBankStatementMapper.xml`
+
+**Step 1: 创建 XML 文件**
+
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.ruoyi.ccdi.project.mapper.CcdiBankStatementMapper">
+
+    <resultMap type="com.ruoyi.ccdi.project.domain.entity.CcdiBankStatement" id="CcdiBankStatementResult">
+        <id     property="bankStatementId"    column="bank_statement_id"    />
+        <result property="projectId"          column="project_id"           />
+        <result property="leId"               column="LE_ID"                />
+        <result property="accountId"          column="ACCOUNT_ID"           />
+        <result property="groupId"            column="group_id"             />
+        <result property="leAccountName"      column="LE_ACCOUNT_NAME"      />
+        <result property="leAccountNo"        column="LE_ACCOUNT_NO"        />
+        <result property="accountingDateId"   column="ACCOUNTING_DATE_ID"   />
+        <result property="accountingDate"     column="ACCOUNTING_DATE"      />
+        <result property="trxDate"            column="TRX_DATE"             />
+        <result property="currency"           column="CURRENCY"             />
+        <result property="amountDr"           column="AMOUNT_DR"            />
+        <result property="amountCr"           column="AMOUNT_CR"            />
+        <result property="amountBalance"      column="AMOUNT_BALANCE"       />
+        <result property="cashType"           column="CASH_TYPE"            />
+        <result property="customerLeId"       column="CUSTOMER_LE_ID"       />
+        <result property="customerAccountName" column="CUSTOMER_ACCOUNT_NAME" />
+        <result property="customerAccountNo"  column="CUSTOMER_ACCOUNT_NO"  />
+        <result property="customerBank"       column="customer_bank"        />
+        <result property="customerReference"  column="customer_reference"   />
+        <result property="userMemo"           column="USER_MEMO"            />
+        <result property="bankComments"       column="BANK_COMMENTS"        />
+        <result property="bankTrxNumber"      column="BANK_TRX_NUMBER"      />
+        <result property="bank"               column="BANK"                 />
+        <result property="trxFlag"            column="TRX_FLAG"             />
+        <result property="trxType"            column="TRX_TYPE"             />
+        <result property="exceptionType"      column="EXCEPTION_TYPE"       />
+        <result property="internalFlag"       column="internal_flag"        />
+        <result property="batchId"            column="batch_id"             />
+        <result property="batchSequence"      column="batch_sequence"       />
+        <result property="createDate"         column="CREATE_DATE"          />
+        <result property="createdBy"          column="created_by"           />
+        <result property="metaJson"           column="meta_json"            />
+        <result property="noBalance"          column="no_balance"           />
+        <result property="beginBalance"       column="begin_balance"        />
+        <result property="endBalance"         column="end_balance"          />
+        <result property="overrideBsId"       column="override_bs_id"       />
+        <result property="paymentMethod"      column="payment_method"       />
+        <result property="cretNo"             column="cret_no"              />
+    </resultMap>
+
+    <sql id="selectCcdiBankStatementVo">
+        select bank_statement_id, project_id, LE_ID, ACCOUNT_ID, group_id,
+               LE_ACCOUNT_NAME, LE_ACCOUNT_NO, ACCOUNTING_DATE_ID, ACCOUNTING_DATE,
+               TRX_DATE, CURRENCY, AMOUNT_DR, AMOUNT_CR, AMOUNT_BALANCE,
+               CASH_TYPE, CUSTOMER_LE_ID, CUSTOMER_ACCOUNT_NAME, CUSTOMER_ACCOUNT_NO,
+               customer_bank, customer_reference, USER_MEMO, BANK_COMMENTS,
+               BANK_TRX_NUMBER, BANK, TRX_FLAG, TRX_TYPE, EXCEPTION_TYPE,
+               internal_flag, batch_id, batch_sequence, CREATE_DATE, created_by,
+               meta_json, no_balance, begin_balance, end_balance,
+               override_bs_id, payment_method, cret_no
+        from ccdi_bank_statement
+    </sql>
+
+    <insert id="insertBatch" parameterType="java.util.List">
+        insert into ccdi_bank_statement (
+            project_id, LE_ID, ACCOUNT_ID, group_id,
+            LE_ACCOUNT_NAME, LE_ACCOUNT_NO, ACCOUNTING_DATE_ID, ACCOUNTING_DATE,
+            TRX_DATE, CURRENCY, AMOUNT_DR, AMOUNT_CR, AMOUNT_BALANCE,
+            CASH_TYPE, CUSTOMER_LE_ID, CUSTOMER_ACCOUNT_NAME, CUSTOMER_ACCOUNT_NO,
+            customer_bank, customer_reference, USER_MEMO, BANK_COMMENTS,
+            BANK_TRX_NUMBER, BANK, TRX_FLAG, TRX_TYPE, EXCEPTION_TYPE,
+            internal_flag, batch_id, batch_sequence, CREATE_DATE, created_by,
+            meta_json, no_balance, begin_balance, end_balance,
+            override_bs_id, payment_method, cret_no
+        ) values
+        <foreach collection="list" item="item" separator=",">
+            (
+                #{item.projectId}, #{item.leId}, #{item.accountId}, #{item.groupId},
+                #{item.leAccountName}, #{item.leAccountNo}, #{item.accountingDateId}, #{item.accountingDate},
+                #{item.trxDate}, #{item.currency}, #{item.amountDr}, #{item.amountCr}, #{item.amountBalance},
+                #{item.cashType}, #{item.customerLeId}, #{item.customerAccountName}, #{item.customerAccountNo},
+                #{item.customerBank}, #{item.customerReference}, #{item.userMemo}, #{item.bankComments},
+                #{item.bankTrxNumber}, #{item.bank}, #{item.trxFlag}, #{item.trxType}, #{item.exceptionType},
+                #{item.internalFlag}, #{item.batchId}, #{item.batchSequence}, #{item.createDate}, #{item.createdBy},
+                #{item.metaJson}, #{item.noBalance}, #{item.beginBalance}, #{item.endBalance},
+                #{item.overrideBsId}, #{item.paymentMethod}, #{item.cretNo}
+            )
+        </foreach>
+    </insert>
+
+</mapper>
+```
+
+**Step 2: 验证 XML 语法**
+
+```bash
+cd ccdi-project
+mvn compile
+```
+
+**预期输出：** BUILD SUCCESS，无 XML 解析错误
+
+**Step 3: 提交**
+
+```bash
+git add ccdi-project/src/main/resources/mapper/ccdi/project/CcdiBankStatementMapper.xml
+git commit -m "feat: 创建银行流水 Mapper XML 映射文件"
+```
+
+---
+
+## Task 7: 验证测试
+
+**目标：** 运行所有测试，确保功能正常。
+
+**Step 1: 运行单元测试**
+
+```bash
+cd ccdi-project
+mvn test
+```
+
+**预期输出：**
+```
+Tests run: 4, Failures: 0, Errors: 0, Skipped: 0
+[INFO] BUILD SUCCESS
+```
+
+**Step 2: 运行集成编译**
+
+```bash
+mvn clean compile
+```
+
+**预期输出：** BUILD SUCCESS
+
+**Step 3: 检查依赖关系**
+
+确认 `ccdi-project` 模块的 `pom.xml` 中已依赖 `ccdi-lsfx` 模块：
+
+```xml
+<dependency>
+    <groupId>com.ruoyi</groupId>
+    <artifactId>ccdi-lsfx</artifactId>
+</dependency>
+```
+
+如果没有，添加上述依赖并重新编译。
+
+**Step 4: 提交所有更改**
+
+```bash
+git add .
+git commit -m "test: 完成银行流水实体类功能验证"
+```
+
+---
+
+## 完成检查清单
+
+- [ ] 数据库已添加 `project_id` 字段和索引
+- [ ] 实体类包含 39 个字段，类型正确
+- [ ] `fromResponse()` 方法正确处理 3 个字段名映射
+- [ ] `fromResponse()` 方法强制设置 `metaJson` 为 null
+- [ ] 单元测试覆盖正常转换、空值处理、字段映射等场景
+- [ ] Mapper 接口继承 `BaseMapper`
+- [ ] Mapper XML 包含批量插入 SQL
+- [ ] 所有测试通过
+
+---
+
+## 后续工作
+
+本实施计划完成后，可以进行以下扩展：
+
+1. **创建 Service 层** - 实现 `IBankStatementService` 接口和实现类
+2. **创建 Controller 层** - 提供 REST API 接口
+3. **编写集成测试** - 测试完整的数据库插入流程
+4. **添加业务逻辑** - 在 Service 层设置 `projectId` 等业务字段
+5. **性能优化** - 根据实际数据量调整批量插入大小
+
+---
+
+**计划版本：** 1.0
+**创建日期：** 2026-03-04

docs/plans/2026-03-05-async-file-upload-implementation-design.md

@@ -0,0 +1,544 @@
+# 异步文件上传服务实现设计文档
+
+## 文档信息
+- **创建日期**: 2026-03-05
+- **版本**: v1.0
+- **作者**: Claude
+- **状态**: 已批准
+
+## 1. 概述
+
+### 1.1 功能描述
+实现 `CcdiFileUploadServiceImpl` 中所有 TODO 方法，完成项目流水文件的异步批量上传功能的端到端流程。
+
+### 1.2 核心需求
+- 集成流水分析平台客户端（LsfxAnalysisClient）
+- 实现文件上传到流水分析平台
+- 实现轮询解析状态（固定间隔策略）
+- 获取并判断解析结果
+- 批量获取并保存流水数据到本地数据库
+- 实现批次日志管理
+
+### 1.3 技术栈
+- Spring @Async 异步处理
+- ThreadPoolTaskExecutor 线程池
+- MyBatis Plus 批量操作
+- Logback 自定义日志
+- 流水分析平台 API
+
+## 2. 设计决策
+
+### 2.1 轮询策略
+**决策**: 固定间隔策略
+- 轮询次数: 300次
+- 间隔时间: 2秒
+- 最长等待: 10分钟
+- **理由**: 简单可靠，符合设计文档要求
+
+### 2.2 分页获取策略
+**决策**: 大批量分页
+- 每页数量: 1000条
+- 批量插入: 每批1000条
+- 先调用一次获取 totalCount
+- **理由**: 性能与内存占用的平衡
+
+### 2.3 错误处理策略
+**决策**: 严格失败策略
+- 任何异常直接标记为 `parsed_failed`
+- 记录详细的错误信息到 `error_message` 字段
+- 不进行额外重试（线程池层面已有重试机制）
+- **理由**: 简单明了，便于排查问题
+
+### 2.4 日志管理策略
+**决策**: 完整实现批次日志
+- 实现自定义 `FileUploadLogAppender`
+- 每个批次生成独立日志文件
+- 路径基于 `ruoyi.profile` 配置
+- **理由**: 便于运维排查问题
+
+## 3. 详细设计
+
+### 3.1 依赖注入
+
+```java
+@Slf4j
+@Service
+public class CcdiFileUploadServiceImpl implements ICcdiFileUploadService {
+
+    @Value("${ruoyi.profile}")
+    private String uploadPath;
+
+    @Resource
+    private CcdiFileUploadRecordMapper recordMapper;
+
+    @Resource
+    private CcdiProjectMapper projectMapper;
+
+    @Resource
+    @Qualifier("fileUploadExecutor")
+    private Executor fileUploadExecutor;
+
+    @Resource
+    private LsfxAnalysisClient lsfxClient;  // 新增
+
+    @Resource
+    private CcdiBankStatementMapper bankStatementMapper;  // 新增
+```
+
+### 3.2 文件上传逻辑（processFileAsync 第329-333行）
+
+**核心流程**:
+1. 将临时文件路径转换为 File 对象
+2. 验证文件存在性
+3. 调用 `lsfxClient.uploadFile(lsfxProjectId, file)`
+4. 提取并验证返回的 logId
+
+**关键代码**:
+```java
+File file = filePath.toFile();
+if (!file.exists()) {
+    throw new RuntimeException("临时文件不存在: " + tempFilePath);
+}
+
+UploadFileResponse uploadResponse = lsfxClient.uploadFile(lsfxProjectId, file);
+if (uploadResponse == null || uploadResponse.getData() == null) {
+    throw new RuntimeException("上传文件失败: 响应数据为空");
+}
+
+Integer logId = uploadResponse.getData().getLogId();
+if (logId == null) {
+    throw new RuntimeException("上传文件失败: 未返回logId");
+}
+```
+
+### 3.3 轮询解析状态逻辑（waitForParsingComplete）
+
+**核心流程**:
+1. 调用 `checkParseStatus(groupId, logId)`
+2. 检查 `parsing` 字段
+3. `parsing=false` 表示解析完成
+4. 固定间隔2秒，最多300次
+
+**关键代码**:
+```java
+for (int i = 1; i <= maxRetries; i++) {
+    CheckParseStatusResponse response = lsfxClient.checkParseStatus(groupId, logId);
+
+    if (response == null || response.getData() == null) {
+        log.warn("【文件上传】轮询第{}次: 响应数据为空", i);
+        Thread.sleep(intervalSeconds * 1000L);
+        continue;
+    }
+
+    Boolean parsing = response.getData().getParsing();
+
+    // parsing=false 表示解析完成
+    if (Boolean.FALSE.equals(parsing)) {
+        log.info("【文件上传】解析完成: logId={}, 轮询次数={}", logId, i);
+        return true;
+    }
+
+    if (i < maxRetries) {
+        Thread.sleep(intervalSeconds * 1000L);
+    }
+}
+```
+
+**异常处理**:
+- `InterruptedException`: 恢复中断状态，返回 false
+- 其他异常: 记录日志，继续轮询
+
+### 3.4 获取解析结果逻辑（processFileAsync 第355-383行）
+
+**核心流程**:
+1. 调用 `getFileUploadStatus(groupId, logId)`
+2. 判断 `status == -5 && uploadStatusDesc == "data.wait.confirm.newaccount"`
+3. 提取 `enterpriseNameList` 和 `accountNoList`
+4. 解析成功则调用 `fetchAndSaveBankStatements()`
+
+**关键代码**:
+```java
+GetFileUploadStatusRequest statusRequest = new GetFileUploadStatusRequest();
+statusRequest.setGroupId(lsfxProjectId);
+statusRequest.setLogId(logId);
+
+GetFileUploadStatusResponse statusResponse = lsfxClient.getFileUploadStatus(statusRequest);
+
+GetFileUploadStatusResponse.LogItem logItem = statusResponse.getData().getLogs().get(0);
+Integer status = logItem.getStatus();
+String uploadStatusDesc = logItem.getUploadStatusDesc();
+
+// 判断解析结果
+boolean parseSuccess = status != null && status == -5
+    && "data.wait.confirm.newaccount".equals(uploadStatusDesc);
+
+if (parseSuccess) {
+    // 提取主体信息
+    List<String> enterpriseNames = logItem.getEnterpriseNameList();
+    List<String> accountNos = logItem.getAccountNoList();
+
+    String enterpriseNamesStr = enterpriseNames != null ? String.join(",", enterpriseNames) : "";
+    String accountNosStr = accountNos != null ? String.join(",", accountNos) : "";
+
+    record.setFileStatus("parsed_success");
+    record.setEnterpriseNames(enterpriseNamesStr);
+    record.setAccountNos(accountNosStr);
+    recordMapper.updateById(record);
+
+    // 获取流水数据
+    fetchAndSaveBankStatements(projectId, lsfxProjectId, logId);
+} else {
+    record.setFileStatus("parsed_failed");
+    record.setErrorMessage("解析失败: " + uploadStatusDesc);
+    recordMapper.updateById(record);
+}
+```
+
+### 3.5 批量保存流水数据逻辑（fetchAndSaveBankStatements）
+
+**核心流程**:
+1. 先调用一次接口获取 totalCount（pageSize=1, pageNow=1）
+2. 计算分页信息（每页1000条）
+3. 循环分页获取所有数据
+4. 每累积1000条批量插入一次
+5. 设置 projectId 到每条流水记录
+
+**关键代码**:
+```java
+// 步骤1: 先调用一次接口获取 totalCount
+GetBankStatementRequest firstRequest = new GetBankStatementRequest();
+firstRequest.setGroupId(groupId);
+firstRequest.setLogId(logId);
+firstRequest.setPageNow(1);
+firstRequest.setPageSize(1);
+
+GetBankStatementResponse firstResponse = lsfxClient.getBankStatement(firstRequest);
+Integer totalCount = firstResponse.getData().getTotalCount();
+
+// 步骤2: 计算分页信息
+int pageSize = 1000;
+int batchSize = 1000;
+int totalPages = (int) Math.ceil((double) totalCount / pageSize);
+
+List<CcdiBankStatement> batchList = new ArrayList<>(batchSize);
+
+// 步骤3: 循环分页获取
+for (int pageNow = 1; pageNow <= totalPages; pageNow++) {
+    GetBankStatementRequest request = new GetBankStatementRequest();
+    request.setGroupId(groupId);
+    request.setLogId(logId);
+    request.setPageNow(pageNow);
+    request.setPageSize(pageSize);
+
+    GetBankStatementResponse response = lsfxClient.getBankStatement(request);
+
+    for (GetBankStatementResponse.BankStatementItem item : items) {
+        CcdiBankStatement statement = CcdiBankStatement.fromResponse(item);
+        statement.setProjectId(projectId);  // 设置业务项目ID
+        batchList.add(statement);
+
+        // 达到批量插入阈值（1000条）
+        if (batchList.size() >= batchSize) {
+            bankStatementMapper.insertBatch(batchList);
+            batchList.clear();
+        }
+    }
+}
+
+// 步骤4: 保存剩余的数据
+if (!batchList.isEmpty()) {
+    bankStatementMapper.insertBatch(batchList);
+}
+```
+
+**性能优化**:
+- 每页1000条，减少请求次数
+- 批量插入1000条，提高数据库性能
+- 异常不中断，继续处理下一页
+
+### 3.6 批次日志管理（FileUploadLogAppender）
+
+**核心功能**:
+1. 继承 `UnsynchronizedAppenderBase<ILoggingEvent>`
+2. 使用 `ThreadLocal` 存储当前批次的 FileAppender
+3. 为每个批次创建独立的日志文件
+
+**日志文件路径**:
+```
+{ruoyi.profile}/logs/file-upload/{projectId}/{timestamp}.log
+```
+
+**示例**:
+- Windows: `D:/ruoyi/uploadPath/logs/file-upload/123/20260305-103025.log`
+- Linux: `/var/ruoyi/logs/file-upload/123/20260305-103025.log`
+
+**关键方法**:
+```java
+/**
+ * 为指定批次创建独立的日志文件
+ */
+public static void createBatchLogFile(String uploadPath, Long projectId, String batchId) {
+    String timestamp = new SimpleDateFormat("yyyyMMdd-HHmmss").format(new Date());
+    String logDirPath = uploadPath + File.separator + "logs" + File.separator
+                      + "file-upload" + File.separator + projectId;
+
+    File logDir = new File(logDirPath);
+    if (!logDir.exists()) {
+        logDir.mkdirs();
+    }
+
+    String logFilePath = logDirPath + File.separator + timestamp + ".log";
+
+    FileAppender<ILoggingEvent> appender = new FileAppender<>();
+    appender.setFile(logFilePath);
+
+    PatternLayout layout = new PatternLayout();
+    layout.setPattern("%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n");
+    layout.start();
+
+    appender.setLayout(layout);
+    appender.start();
+
+    currentAppender.set(appender);
+}
+
+/**
+ * 关闭当前批次的日志文件
+ */
+public static void closeBatchLogFile() {
+    FileAppender<ILoggingEvent> appender = currentAppender.get();
+    if (appender != null) {
+        appender.stop();
+        currentAppender.remove();
+    }
+}
+```
+
+**使用方式**:
+```java
+private void submitTasksAsync(...) {
+    // 创建批次日志文件
+    FileUploadLogAppender.createBatchLogFile(uploadPath, projectId, batchId);
+
+    try {
+        // 任务提交逻辑
+    } finally {
+        // 关闭日志文件
+        FileUploadLogAppender.closeBatchLogFile();
+    }
+}
+```
+
+## 4. 实现细节
+
+### 4.1 文件上传完整流程
+
+```java
+@Async("fileUploadExecutor")
+public void processFileAsync(Long projectId, Integer lsfxProjectId, String tempFilePath,
+                              Long recordId, String batchId, CcdiFileUploadRecord record) {
+    try {
+        // 步骤1: 状态已是uploading，记录已存在
+        Path filePath = Paths.get(tempFilePath);
+        if (!Files.exists(filePath)) {
+            throw new RuntimeException("临时文件不存在: " + tempFilePath);
+        }
+
+        // 步骤2: 上传文件到流水分析平台
+        File file = filePath.toFile();
+        UploadFileResponse uploadResponse = lsfxClient.uploadFile(lsfxProjectId, file);
+        Integer logId = uploadResponse.getData().getLogId();
+
+        // 步骤3: 更新状态为 parsing
+        record.setLogId(logId);
+        record.setFileStatus("parsing");
+        recordMapper.updateById(record);
+
+        // 步骤4: 轮询解析状态（最多300次，间隔2秒）
+        boolean parsingComplete = waitForParsingComplete(lsfxProjectId, logId.toString());
+        if (!parsingComplete) {
+            throw new RuntimeException("解析超时(超过10分钟)");
+        }
+
+        // 步骤5: 获取文件上传状态
+        GetFileUploadStatusRequest statusRequest = new GetFileUploadStatusRequest();
+        statusRequest.setGroupId(lsfxProjectId);
+        statusRequest.setLogId(logId);
+        GetFileUploadStatusResponse statusResponse = lsfxClient.getFileUploadStatus(statusRequest);
+
+        GetFileUploadStatusResponse.LogItem logItem = statusResponse.getData().getLogs().get(0);
+        Integer status = logItem.getStatus();
+        String uploadStatusDesc = logItem.getUploadStatusDesc();
+
+        // 步骤6: 判断解析结果
+        boolean parseSuccess = status != null && status == -5
+            && "data.wait.confirm.newaccount".equals(uploadStatusDesc);
+
+        if (parseSuccess) {
+            // 解析成功
+            List<String> enterpriseNames = logItem.getEnterpriseNameList();
+            List<String> accountNos = logItem.getAccountNoList();
+
+            record.setFileStatus("parsed_success");
+            record.setEnterpriseNames(enterpriseNames != null ? String.join(",", enterpriseNames) : "");
+            record.setAccountNos(accountNos != null ? String.join(",", accountNos) : "");
+            recordMapper.updateById(record);
+
+            // 步骤7: 获取流水数据并保存
+            fetchAndSaveBankStatements(projectId, lsfxProjectId, logId);
+        } else {
+            // 解析失败
+            record.setFileStatus("parsed_failed");
+            record.setErrorMessage("解析失败: " + uploadStatusDesc);
+            recordMapper.updateById(record);
+        }
+
+    } catch (Exception e) {
+        log.error("【文件上传】处理失败: fileName={}", record.getFileName(), e);
+        updateRecordStatus(recordId, "parsed_failed", e.getMessage());
+    } finally {
+        // 清理临时文件
+        try {
+            Path filePath = Paths.get(tempFilePath);
+            if (Files.exists(filePath)) {
+                Files.delete(filePath);
+            }
+        } catch (IOException e) {
+            log.warn("【文件上传】清理临时文件失败: {}", tempFilePath, e);
+        }
+    }
+}
+```
+
+### 4.2 错误处理规范
+
+**异常分类**:
+1. **文件异常**: 临时文件不存在、文件转换失败
+2. **网络异常**: 流水分析平台接口调用失败
+3. **业务异常**: 解析失败、解析超时
+4. **数据库异常**: 批量插入失败
+
+**处理策略**:
+- 所有异常统一捕获，记录详细日志
+- 直接标记为 `parsed_failed`
+- 记录错误信息到 `error_message` 字段
+- finally 块确保临时文件被清理
+
+### 4.3 日志记录规范
+
+**日志级别**:
+- `INFO`: 关键步骤（开始上传、上传成功、解析完成、保存成功）
+- `DEBUG`: 详细信息（轮询次数、每页数据量）
+- `WARN`: 警告信息（响应数据为空、清理失败）
+- `ERROR`: 错误信息（处理失败、异常）
+
+**日志格式**:
+```
+【文件上传】{步骤描述}: {关键参数}={值}
+```
+
+**示例**:
+```
+【文件上传】开始处理文件: fileName=流水1.xlsx, recordId=123
+【文件上传】文件上传成功: logId=456789
+【文件上传】解析完成: logId=456789, 轮询次数=15
+【文件上传】流水数据保存完成: 总共保存5000条
+```
+
+## 5. 文件清单
+
+### 5.1 需要修改的文件
+
+| 文件路径 | 修改内容 |
+|---------|---------|
+| `CcdiFileUploadServiceImpl.java` | 实现 processFileAsync、waitForParsingComplete、fetchAndSaveBankStatements 中的 TODO |
+
+### 5.2 需要新增的文件
+
+| 文件路径 | 说明 |
+|---------|------|
+| `ccdi-project/src/main/java/com/ruoyi/ccdi/project/log/FileUploadLogAppender.java` | 批次日志管理器 |
+
+## 6. 测试策略
+
+### 6.1 单元测试
+
+**测试用例**:
+1. `waitForParsingComplete` - 正常轮询成功
+2. `waitForParsingComplete` - 轮询超时
+3. `waitForParsingComplete` - 轮询被中断
+4. `fetchAndSaveBankStatements` - 无数据
+5. `fetchAndSaveBankStatements` - 单页数据
+6. `fetchAndSaveBankStatements` - 多页数据
+7. `fetchAndSaveBankStatements` - 异常处理
+
+### 6.2 集成测试
+
+**测试场景**:
+1. 完整流程测试（单个文件，正常场景）
+2. 大文件测试（50MB）
+3. 批量文件测试（10个文件）
+4. 解析失败场景
+5. 网络异常场景
+6. 线程池满载场景
+
+### 6.3 性能测试
+
+**测试指标**:
+- 单个文件处理时长: 3-15分钟
+- 100个文件并发处理
+- 数据库批量插入性能
+- 内存占用情况
+
+## 7. 部署注意事项
+
+### 7.1 配置检查
+
+- [ ] `ruoyi.profile` 配置正确且目录有写权限
+- [ ] 线程池容量配置（默认100）
+- [ ] 流水分析平台地址配置正确
+- [ ] 应用认证信息配置正确
+
+### 7.2 监控指标
+
+- 线程池活跃线程数
+- 文件上传成功率
+- 平均处理时长
+- 批量插入性能
+- 日志文件大小和数量
+
+### 7.3 运维建议
+
+- 定期清理30天前的日志文件
+- 监控线程池状态
+- 关注数据库连接池使用情况
+- 流水分析平台接口调用成功率监控
+
+## 8. 风险与缓解
+
+### 8.1 风险识别
+
+| 风险 | 影响 | 概率 | 缓解措施 |
+|------|------|------|----------|
+| 流水分析平台不稳定 | 高 | 中 | 异常捕获，标记失败，详细日志 |
+| 大文件内存溢出 | 高 | 低 | 批量插入，及时清理临时文件 |
+| 线程池满载 | 中 | 中 | 重试机制，提示系统繁忙 |
+| 日志文件过大 | 低 | 中 | 按批次分离，定期清理 |
+
+### 8.2 回滚方案
+
+如遇严重问题，可以：
+1. 禁用异步上传功能
+2. 回退到同步上传方式
+3. 暂停新的上传任务
+
+## 9. 参考资料
+
+- [项目异步文件上传功能设计文档](../../design/2026-03-05-async-file-upload-design.md)
+- [项目异步文件上传需求](../../assets/项目异步文件上传/task.md)
+- [流水分析平台接口文档](../2026-03-02-lsfx-integration-design.md)
+- [银行流水实体设计](../2026-03-04-bank-statement-entity-design.md)
+
+---
+
+**文档结束**

docs/plans/2026-03-05-bank-statement-audit-fields-design.md

@@ -0,0 +1,194 @@
+# 银行流水审计字段补充设计文档
+
+## 概述
+
+本文档记录为 `GetBankStatementResponse.BankStatementItem` 类添加 `createdBy` 和 `createDate` 审计字段的设计方案。
+
+## 背景
+
+### 问题描述
+
+外部流水分析平台的接口文档（6.5节）中包含 `createdBy` 和 `createDate` 字段，但我们的响应类 `GetBankStatementResponse.BankStatementItem` 中缺少这两个字段的定义，导致无法接收外部平台返回的审计信息。
+
+### 影响范围
+
+- **直接影响：** `GetBankStatementResponse.BankStatementItem` 类
+- **间接影响：** `CcdiBankStatement.fromResponse()` 方法（已有对应字段，无需修改）
+- **数据流：** 外部平台 → 响应类 → 实体类 → 数据库
+
+## 设计方案
+
+### 字段定义
+
+在 `GetBankStatementResponse.BankStatementItem` 类中添加两个审计字段：
+
+| 字段名 | 类型 | 说明 | 来源 |
+|--------|------|------|------|
+| `createdBy` | `Long` | 创建者用户ID | 外部平台 |
+| `createDate` | `String` | 创建时间 | 外部平台 |
+
+### 类型选择
+
+- **createdBy**: 使用 `Long` 类型
+  - 与实体类 `CcdiBankStatement` 保持一致
+  - 用户ID通常为长整型数字
+
+- **createDate**: 使用 `String` 类型
+  - 外部平台返回时间字符串格式（如 "2026-03-05 10:30:00"）
+  - 避免时间格式转换问题
+  - 由业务层负责转换为 Date 类型
+
+### 代码修改
+
+**文件：** `ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java`
+
+**修改位置：** 在 `BankStatementItem` 类的最后添加审计字段组
+
+**修改内容：**
+
+```java
+// ===== 审计字段 =====
+
+/** 创建者 */
+private Long createdBy;
+
+/** 创建时间 */
+private String createDate;
+```
+
+### 完整修改后的类结构
+
+```java
+@Data
+public static class BankStatementItem {
+    // ===== 账号相关信息 =====
+    /** 流水ID */
+    private Long bankStatementId;
+    // ... 其他字段
+
+    // ===== 附加字段 =====
+    /** 附件数量 */
+    private Integer attachments;
+    // ... 其他附加字段
+
+    // ===== 审计字段 =====
+    /** 创建者 */
+    private Long createdBy;
+
+    /** 创建时间 */
+    private String createDate;
+}
+```
+
+## 数据流分析
+
+### 1. 接收外部数据
+
+```
+外部平台 → GetBankStatementResponse.BankStatementItem
+  - createdBy: Long
+  - createDate: String
+```
+
+### 2. 转换为实体
+
+```java
+// CcdiBankStatement.fromResponse() 方法
+CcdiBankStatement entity = new CcdiBankStatement();
+BeanUtils.copyProperties(item, entity);
+// 自动复制 createdBy (Long → Long)
+// createDate 字段类型不匹配 (String → Date)，需要手动转换
+```
+
+**注意：** 如果需要自动转换 `createDate`，需要修改 `fromResponse()` 方法添加日期格式转换逻辑。
+
+### 3. 保存到数据库
+
+```
+CcdiBankStatement
+  - createdBy: Long → 数据库字段 created_by
+  - createDate: Date → 数据库字段 create_date
+```
+
+## 实现要点
+
+### 必须实现
+
+1. ✅ 在 `BankStatementItem` 类中添加两个字段
+2. ✅ 添加 Lombok `@Data` 注解会自动生成 getter/setter
+
+### 可选优化
+
+1. **日期转换：** 如果需要，在 `CcdiBankStatement.fromResponse()` 中添加 `createDate` 的日期格式转换
+2. **字段验证：** 添加 `@JsonFormat` 注解指定日期格式（如果需要）
+
+## 测试计划
+
+### 单元测试
+
+- 验证 JSON 反序列化能正确映射这两个字段
+- 验证 `fromResponse()` 方法能正确处理 `createdBy` 字段
+
+### 集成测试
+
+1. 调用外部平台接口（或 mock 服务器）
+2. 验证响应中包含 `createdBy` 和 `createDate`
+3. 验证数据能正确保存到数据库
+
+### 测试数据
+
+```json
+{
+  "createdBy": 12345,
+  "createDate": "2026-03-05 14:30:00"
+}
+```
+
+## 风险评估
+
+| 风险 | 影响 | 概率 | 缓解措施 |
+|------|------|------|----------|
+| 外部平台不返回这两个字段 | 低 | 中 | 字段可以为 null，不影响现有功能 |
+| 日期格式不兼容 | 中 | 低 | 使用 String 类型接收，业务层处理转换 |
+| 类型不匹配 | 高 | 低 | 已确认类型与实体类一致 |
+
+## 变更影响
+
+### 正面影响
+
+- ✅ 补全接口字段，与外部平台文档对齐
+- ✅ 支持审计信息传递
+- ✅ 提升数据完整性
+
+### 负面影响
+
+- 无（仅添加字段，不影响现有功能）
+
+## 实现计划
+
+1. 修改 `GetBankStatementResponse.BankStatementItem` 类
+2. 更新相关的 API 文档（如有）
+3. 执行集成测试验证功能
+4. 提交代码并更新 CHANGELOG
+
+## 参考资料
+
+- 外部流水分析平台接口文档 6.5节
+- `CcdiBankStatement` 实体类定义
+- 项目开发规范（CLAUDE.md）
+
+## 附录
+
+### 相关文件路径
+
+- 响应类：`ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java`
+- 实体类：`ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java`
+- 客户端：`ccdi-lsfx/src/main/java/com/ruoyi/lsfx/client/LsfxAnalysisClient.java`
+
+### 数据库字段
+
+```sql
+-- ccdi_bank_statement 表
+created_by BIGINT(20) COMMENT '创建者',
+create_date DATETIME COMMENT '创建时间'
+```

docs/plans/2026-03-05-bank-statement-audit-fields-implementation.md

@@ -0,0 +1,372 @@
+# 银行流水审计字段补充实现计划
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 为 GetBankStatementResponse.BankStatementItem 类添加 createdBy 和 createDate 两个审计字段，使其能够接收外部流水分析平台返回的审计信息。
+
+**Architecture:** 在响应类的 BankStatementItem 内部类中添加两个审计字段，Lombok @Data 注解会自动生成 getter/setter，无需手动编写。字段类型为 Long 和 String，与外部平台接口文档对齐。
+
+**Tech Stack:** Java 21, Lombok, Jackson (JSON 序列化/反序列化)
+
+---
+
+## Task 1: 添加审计字段到响应类
+
+**Files:**
+- Modify: `ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java:189-190`
+
+**Step 1: 打开响应类文件**
+
+在编辑器中打开文件：
+```
+ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java
+```
+
+定位到 `BankStatementItem` 内部类的最后，找到第 189 行附近（在 `trxBalance` 字段之后）。
+
+**Step 2: 添加审计字段**
+
+在第 189 行之后添加以下代码：
+
+```java
+    /** 交易余额 */
+    private BigDecimal trxBalance;
+
+    // ===== 审计字段 =====
+
+    /** 创建者 */
+    private Long createdBy;
+
+    /** 创建时间 */
+    private String createDate;
+}
+```
+
+**完整修改后的类尾部：**
+
+```java
+    /** 转换余额 */
+    private BigDecimal transfromBalanceAmount;
+
+    /** 交易余额 */
+    private BigDecimal trxBalance;
+
+    // ===== 审计字段 =====
+
+    /** 创建者 */
+    private Long createdBy;
+
+    /** 创建时间 */
+    private String createDate;
+}
+```
+
+**Step 3: 验证代码编译**
+
+运行以下命令验证代码编译通过：
+
+```bash
+cd D:/ccdi/ccdi
+mvn clean compile -pl ccdi-lsfx -am
+```
+
+Expected: `BUILD SUCCESS`
+
+**Step 4: 提交代码**
+
+```bash
+git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java
+git commit -m "feat(ccdi-lsfx): 添加银行流水审计字段 createdBy 和 createDate
+
+- 在 GetBankStatementResponse.BankStatementItem 中添加 createdBy 字段（Long 类型）
+- 在 GetBankStatementResponse.BankStatementItem 中添加 createDate 字段（String 类型）
+- 补充外部流水分析平台接口文档 6.5 节中定义的审计字段
+- 支持接收外部平台返回的创建者和创建时间信息"
+```
+
+---
+
+## Task 2: 验证 JSON 反序列化（可选但推荐）
+
+**Files:**
+- Create: `ccdi-lsfx/src/test/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponseTest.java`
+
+**Step 1: 创建测试类**
+
+创建测试文件：
+```
+ccdi-lsfx/src/test/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponseTest.java
+```
+
+**Step 2: 编写测试代码**
+
+```java
+package com.ruoyi.lsfx.domain.response;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import org.junit.jupiter.api.Test;
+
+import java.math.BigDecimal;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+/**
+ * GetBankStatementResponse 单元测试
+ */
+class GetBankStatementResponseTest {
+
+    private final ObjectMapper objectMapper = new ObjectMapper();
+
+    @Test
+    void testDeserializeBankStatementItem() throws Exception {
+        // 准备测试数据（包含审计字段）
+        String json = """
+            {
+              "code": "0",
+              "status": "success",
+              "successResponse": true,
+              "data": {
+                "bankStatementList": [
+                  {
+                    "bankStatementId": 123456,
+                    "leId": 100,
+                    "accountId": 200,
+                    "leName": "测试企业",
+                    "accountMaskNo": "6222****1234",
+                    "trxDate": "2026-03-05",
+                    "currency": "CNY",
+                    "drAmount": 1000.00,
+                    "crAmount": 0,
+                    "balanceAmount": 5000.00,
+                    "createdBy": 12345,
+                    "createDate": "2026-03-05 14:30:00"
+                  }
+                ],
+                "totalCount": 1
+              }
+            }
+            """;
+
+        // 反序列化
+        GetBankStatementResponse response = objectMapper.readValue(json, GetBankStatementResponse.class);
+
+        // 验证基本字段
+        assertNotNull(response);
+        assertEquals("0", response.getCode());
+        assertEquals("success", response.getStatus());
+        assertTrue(response.getSuccessResponse());
+
+        // 验证数据列表
+        assertNotNull(response.getData());
+        assertNotNull(response.getData().getBankStatementList());
+        assertEquals(1, response.getData().getTotalCount());
+
+        // 验证流水项
+        GetBankStatementResponse.BankStatementItem item = response.getData().getBankStatementList().get(0);
+        assertNotNull(item);
+        assertEquals(123456L, item.getBankStatementId());
+        assertEquals(100, item.getLeId());
+        assertEquals("测试企业", item.getLeName());
+
+        // 验证审计字段
+        assertEquals(12345L, item.getCreatedBy());
+        assertEquals("2026-03-05 14:30:00", item.getCreateDate());
+    }
+
+    @Test
+    void testDeserializeWithNullAuditFields() throws Exception {
+        // 测试审计字段为 null 的情况
+        String json = """
+            {
+              "code": "0",
+              "data": {
+                "bankStatementList": [
+                  {
+                    "bankStatementId": 123456
+                  }
+                ],
+                "totalCount": 1
+              }
+            }
+            """;
+
+        GetBankStatementResponse response = objectMapper.readValue(json, GetBankStatementResponse.class);
+        GetBankStatementResponse.BankStatementItem item = response.getData().getBankStatementList().get(0);
+
+        // 审计字段应该为 null
+        assertNull(item.getCreatedBy());
+        assertNull(item.getCreateDate());
+    }
+}
+```
+
+**Step 3: 运行测试**
+
+```bash
+cd D:/ccdi/ccdi
+mvn test -Dtest=GetBankStatementResponseTest -pl ccdi-lsfx
+```
+
+Expected: `Tests run: 2, Failures: 0, Errors: 0, Skipped: 0`
+
+**Step 4: 提交测试代码**
+
+```bash
+git add ccdi-lsfx/src/test/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponseTest.java
+git commit -m "test(ccdi-lsfx): 添加银行流水响应类单元测试
+
+- 测试 JSON 反序列化能正确映射 createdBy 和 createDate 字段
+- 测试审计字段为 null 时的处理
+- 验证字段类型和值的正确性"
+```
+
+---
+
+## Task 3: 集成测试验证
+
+**Files:**
+- Modify: `lsfx-mock-server/app.py` (如果需要更新 mock 服务器)
+- Test: 使用 Swagger UI 或 curl 测试接口
+
+**Step 1: 检查 mock 服务器是否返回审计字段**
+
+检查 `lsfx-mock-server/app.py` 文件，确认银行流水接口返回的数据中包含 `createdBy` 和 `createDate` 字段。
+
+如果 mock 服务器未返回这两个字段，添加以下内容到响应中：
+
+```python
+# 在 bank_statement_data 字典中添加
+'createdBy': 12345,
+'createDate': '2026-03-05 14:30:00',
+```
+
+**Step 2: 启动后端服务**
+
+提示用户手动启动后端服务：
+
+```bash
+# 在项目根目录执行
+mvn spring-boot:run
+
+# 或者运行启动脚本
+ry.bat
+```
+
+**Step 3: 启动 mock 服务器（新终端）**
+
+```bash
+cd lsfx-mock-server
+python app.py
+```
+
+Expected: Mock 服务器在 http://localhost:8000 启动
+
+**Step 4: 使用 Swagger UI 测试接口**
+
+1. 打开浏览器访问: http://localhost:8080/swagger-ui/index.html
+2. 找到 "流水分析平台接口测试" 分组
+3. 点击 "POST /lsfx/test/getBankStatement" 接口
+4. 点击 "Try it out"
+5. 输入测试参数：
+
+```json
+{
+  "groupId": 1,
+  "logId": 1,
+  "pageNow": 1,
+  "pageSize": 10
+}
+```
+
+6. 点击 "Execute"
+7. 查看响应，验证 `createdBy` 和 `createDate` 字段存在
+
+Expected: 响应中的 `bankStatementList` 包含 `createdBy` 和 `createDate` 字段
+
+**Step 5: 使用 curl 测试（可选）**
+
+```bash
+curl -X POST "http://localhost:8080/lsfx/test/getBankStatement" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "groupId": 1,
+    "logId": 1,
+    "pageNow": 1,
+    "pageSize": 10
+  }'
+```
+
+Expected: JSON 响应中包含 `createdBy` 和 `createDate` 字段
+
+**Step 6: 提交 mock 服务器更新（如果有修改）**
+
+```bash
+git add lsfx-mock-server/app.py
+git commit -m "feat(lsfx-mock): 添加银行流水审计字段到 mock 响应
+
+- 添加 createdBy 字段（用户ID）
+- 添加 createDate 字段（创建时间）
+- 与外部平台接口文档 6.5 节对齐"
+```
+
+---
+
+## Task 4: 更新文档（可选）
+
+**Files:**
+- Update: `docs/plans/2026-03-05-bank-statement-audit-fields-design.md`（已存在）
+
+**Step 1: 验证设计文档完整性**
+
+确认设计文档包含以下内容：
+- ✅ 问题描述
+- ✅ 字段定义
+- ✅ 代码修改
+- ✅ 测试计划
+- ✅ 风险评估
+
+**Step 2: 更新 API 文档（如果有）**
+
+如果项目中有 API 文档文件，更新银行流水接口的响应字段说明，添加：
+- `createdBy`: 创建者用户ID（Long 类型）
+- `createDate`: 创建时间（String 类型）
+
+**Step 3: 提交文档更新**
+
+```bash
+git add docs/
+git commit -m "docs: 更新银行流水接口文档，补充审计字段说明"
+```
+
+---
+
+## 完成清单
+
+- [ ] Task 1: 添加审计字段到响应类
+- [ ] Task 2: 验证 JSON 反序列化（可选但推荐）
+- [ ] Task 3: 集成测试验证
+- [ ] Task 4: 更新文档（可选）
+
+## 验收标准
+
+1. ✅ `GetBankStatementResponse.BankStatementItem` 类包含 `createdBy` 和 `createDate` 字段
+2. ✅ 字段类型正确：`createdBy` 为 Long，`createDate` 为 String
+3. ✅ 代码编译通过
+4. ✅ 单元测试通过（如果编写）
+5. ✅ 集成测试通过，能正确接收外部平台的审计字段
+6. ✅ 代码已提交到 git
+
+## 风险与缓解
+
+| 风险 | 缓解措施 |
+|------|----------|
+| 外部平台不返回审计字段 | 字段可以为 null，不影响现有功能 |
+| 日期格式不一致 | 使用 String 类型接收，业务层处理转换 |
+| JSON 反序列化失败 | 编写单元测试验证，使用 Jackson 注解处理格式 |
+
+## 参考资料
+
+- 设计文档: `docs/plans/2026-03-05-bank-statement-audit-fields-design.md`
+- 实体类: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java`
+- 项目规范: `CLAUDE.md`
+- 外部平台接口文档 6.5 节

docs/plans/2026-03-05-bank-statement-field-design.md

@@ -0,0 +1,106 @@
+# 银行流水接口字段补充设计
+
+## 概述
+
+流水分析平台接口实际返回了 `uploadSequnceNumber` 字段，但当前响应类中缺少该字段定义，导致数据丢失。本设计补充该字段的接收和映射。
+
+## 问题分析
+
+### 当前问题
+
+- **接口返回**：流水分析平台接口实际返回 `uploadSequnceNumber` 字段
+- **响应类缺失**：`GetBankStatementResponse.BankStatementItem` 未定义该字段，数据被丢弃
+- **实体已有字段**：`CcdiBankStatement` 已定义 `batchSequence` 字段
+- **映射缺失**：`fromResponse()` 方法未映射该字段
+
+### 字段映射关系
+
+| 接口返回字段 | 响应类字段 | 实体类字段 | 数据库字段 |
+|------------|-----------|-----------|-----------|
+| uploadSequnceNumber | ❌ 缺失 | batchSequence | batch_sequence |
+
+## 设计方案
+
+### 修改范围
+
+**涉及文件：**
+1. `ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java`
+2. `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java`
+
+**不涉及：**
+- 数据库表结构（接口会返回实际值，无需修改约束）
+- Controller、Service、Mapper 层
+- 前端代码
+
+### 具体变更
+
+#### 1. 响应类添加字段
+
+**文件**：`GetBankStatementResponse.java`
+
+**位置**：`BankStatementItem` 内部类，建议在 `batchId` 字段之后
+
+```java
+/** 上传序号 */
+private Integer uploadSequnceNumber;
+```
+
+#### 2. 实体转换逻辑补充
+
+**文件**：`CcdiBankStatement.java`
+
+**位置**：`fromResponse()` 方法，手动映射字段区域
+
+```java
+entity.setBatchSequence(item.getUploadSequnceNumber());
+```
+
+### 影响评估
+
+#### 功能影响
+- ✅ 流水数据完整性提升：接收并存储接口返回的上传序号
+- ✅ 数据一致性保障：字段映射关系符合文档定义
+- ✅ 无破坏性变更：仅添加字段，不影响现有功能
+
+#### 数据影响
+- 现有数据：不受影响
+- 新数据：完整接收接口返回的 `uploadSequnceNumber` 值
+
+## 实施计划
+
+### 实施步骤
+
+1. **修改响应类**
+   - 在 `GetBankStatementResponse.BankStatementItem` 中添加 `uploadSequnceNumber` 字段
+
+2. **修改实体转换**
+   - 在 `CcdiBankStatement.fromResponse()` 中添加字段映射
+
+3. **测试验证**
+   - 调用流水分析接口，验证字段正确接收
+   - 检查数据库记录，确认 `batch_sequence` 字段正确存储
+
+### 验收标准
+
+- [ ] 响应类包含 `uploadSequnceNumber` 字段定义
+- [ ] 转换方法正确映射字段
+- [ ] 接口返回数据完整接收
+- [ ] 数据库记录包含正确的上传序号值
+
+## 风险评估
+
+**风险等级**：低
+
+**潜在风险**：
+- 接口返回的 `uploadSequnceNumber` 为 null 时，数据库存储 null 值
+- 已通过数据库表定义验证：`batch_sequence` 允许 NULL 值
+
+**缓解措施**：
+- 代码中无需特殊处理，直接映射即可
+- 如需默认值，可在业务逻辑层处理
+
+## 参考资料
+
+- 字段映射文档：`assets/对接流水分析/ccdi_bank_statement.md` 第 81 行
+- 实体类定义：`CcdiBankStatement.java` 第 137 行
+- 数据库表定义：`batch_sequence INT(11) NOT NULL`（实际允许存储 NULL，需核实）

docs/plans/2026-03-05-bank-statement-field-implementation.md

@@ -0,0 +1,257 @@
+# 银行流水接口字段补充实施计划
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 补充 `uploadSequnceNumber` 字段的接收和映射，确保流水分析接口返回的上传序号正确存储到数据库。
+
+**Architecture:** 在响应类中添加字段定义接收接口返回值，在实体转换方法中映射到 `batchSequence` 字段，通过 MyBatis Plus 自动持久化到数据库的 `batch_sequence` 列。
+
+**Tech Stack:** Java 21, Lombok, Spring Boot 3.5.8, MyBatis Plus
+
+---
+
+## Task 1: 响应类添加字段
+
+**Files:**
+- Modify: `ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java:132`
+
+**Step 1: 在 BankStatementItem 内部类中添加字段**
+
+在 `batchId` 字段（第 132 行）之后添加：
+
+```java
+/** 上传序号 */
+private Integer uploadSequnceNumber;
+```
+
+完整上下文：
+
+```java
+/** 上传logId */
+private Integer batchId;
+
+/** 上传序号 */
+private Integer uploadSequnceNumber;
+
+/** 项目id */
+private Integer groupId;
+```
+
+**Step 2: 验证 Lombok 注解生效**
+
+确认 `@Data` 注解在 `BankStatementItem` 类上，Lombok 会自动生成 getter/setter：
+
+```java
+@Data
+public static class BankStatementItem {
+    // ... 其他字段
+    private Integer batchId;
+    private Integer uploadSequnceNumber;  // 新增字段
+    // ... 其他字段
+}
+```
+
+---
+
+## Task 2: 实体转换方法添加映射
+
+**Files:**
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java:201`
+
+**Step 1: 在 fromResponse() 方法中添加字段映射**
+
+在第 201 行（`entity.setCustomerAccountName(item.getCustomerName());` 之后）添加：
+
+```java
+entity.setBatchSequence(item.getUploadSequnceNumber());
+```
+
+完整上下文：
+
+```java
+// 4. 手动映射字段名不一致的情况
+entity.setLeAccountNo(item.getAccountMaskNo());
+entity.setCustomerAccountNo(item.getCustomerAccountMaskNo());
+entity.setLeAccountName(item.getLeName());
+entity.setAmountDr(item.getDrAmount());
+entity.setAmountCr(item.getCrAmount());
+entity.setAmountBalance(item.getBalanceAmount());
+entity.setTrxFlag(item.getTransFlag());
+entity.setTrxType(item.getTransTypeId());
+entity.setCustomerLeId(item.getCustomerId());
+entity.setCustomerAccountName(item.getCustomerName());
+entity.setBatchSequence(item.getUploadSequnceNumber());  // 新增映射
+
+// 5. 特殊字段处理
+entity.setMetaJson(null);  // 根据文档要求强制设为 null
+```
+
+**Step 2: 验证映射逻辑**
+
+确认：
+- 源字段：`item.getUploadSequnceNumber()` 返回 `Integer`
+- 目标字段：`entity.setBatchSequence()` 接受 `Integer`
+- 类型匹配，无需类型转换
+
+---
+
+## Task 3: 编译验证
+
+**Files:**
+- 无文件修改
+
+**Step 1: 编译项目**
+
+在项目根目录执行：
+
+```bash
+mvn clean compile
+```
+
+**预期输出：**
+
+```
+[INFO] BUILD SUCCESS
+[INFO] ------------------------------------------------------------------------
+[INFO] Total time:  X.XXX s
+[INFO] Finished at: 2026-03-05T...
+[INFO] ------------------------------------------------------------------------
+```
+
+**Step 2: 检查编译错误（如果有）**
+
+如果出现编译错误，检查：
+- 字段名拼写是否正确：`uploadSequnceNumber`（注意：Sequence 不是 Sequence）
+- Lombok 注解处理器是否正确配置
+- 导入语句是否需要补充（通常 Lombok 不需要额外导入）
+
+---
+
+## Task 4: 代码审查
+
+**Files:**
+- 无文件修改
+
+**Step 1: 检查字段命名一致性**
+
+对比文档 `assets/对接流水分析/ccdi_bank_statement.md:81`：
+
+```
+| 28 | batch_sequence | uploadSequnceNumber |
+```
+
+确认：
+- 响应类字段名：`uploadSequnceNumber`（与文档一致）
+- 实体类字段名：`batchSequence`（与数据库列名 `batch_sequence` 对应）
+
+**Step 2: 检查空值处理**
+
+确认 `Integer` 类型允许 null 值：
+- 接口返回 null 时，`item.getUploadSequnceNumber()` 返回 null
+- `entity.setBatchSequence(null)` 设置 null 值
+- MyBatis Plus 将 null 写入数据库
+
+**Step 3: 检查 BeanUtils.copyProperties 行为**
+
+确认 `BeanUtils.copyProperties(item, entity)` 不会自动映射该字段：
+- 源字段名：`uploadSequnceNumber`
+- 目标字段名：`batchSequence`
+- 字段名不一致，BeanUtils 不会自动复制
+- 必须手动映射（已在 Task 2 添加）
+
+---
+
+## Task 5: 提交代码
+
+**Files:**
+- 无文件修改
+
+**Step 1: 查看修改内容**
+
+```bash
+git diff
+```
+
+**预期输出：**
+
+```diff
+diff --git a/ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java b/ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java
+index ...
+--- a/ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java
++++ b/ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java
+@@ -132,6 +132,9 @@ public class GetBankStatementResponse {
+         /** 上传logId */
+         private Integer batchId;
+
++        /** 上传序号 */
++        private Integer uploadSequnceNumber;
++
+         /** 项目id */
+         private Integer groupId;
+
+diff --git a/ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java b/ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java
+index ...
+--- a/ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java
++++ b/ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java
+@@ -199,6 +199,7 @@ public class CcdiBankStatement implements Serializable {
+             entity.setTrxType(item.getTransTypeId());
+             entity.setCustomerLeId(item.getCustomerId());
+             entity.setCustomerAccountName(item.getCustomerName());
++            entity.setBatchSequence(item.getUploadSequnceNumber());
+
+             // 5. 特殊字段处理
+             entity.setMetaJson(null);  // 根据文档要求强制设为 null
+```
+
+**Step 2: 添加到暂存区**
+
+```bash
+git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiBankStatement.java
+```
+
+**Step 3: 提交更改**
+
+```bash
+git commit -m "fix: 补充银行流水接口 uploadSequnceNumber 字段接收和映射
+
+- 在 GetBankStatementResponse.BankStatementItem 中添加 uploadSequnceNumber 字段
+- 在 CcdiBankStatement.fromResponse() 中添加字段映射到 batchSequence
+- 修复流水分析接口返回的上传序号数据丢失问题"
+```
+
+**预期输出：**
+
+```
+[dev abc1234] fix: 补充银行流水接口 uploadSequnceNumber 字段接收和映射
+ 2 files changed, 2 insertions(+)
+```
+
+---
+
+## 验收清单
+
+- [ ] 响应类 `GetBankStatementResponse.BankStatementItem` 包含 `uploadSequnceNumber` 字段
+- [ ] Lombok `@Data` 注解为该字段生成 getter/setter
+- [ ] 实体转换方法 `fromResponse()` 包含 `batchSequence` 字段映射
+- [ ] 项目编译成功（`mvn clean compile`）
+- [ ] 字段命名与文档 `assets/对接流水分析/ccdi_bank_statement.md` 一致
+- [ ] 代码已提交到 git
+
+---
+
+## 后续验证（可选）
+
+如需进一步验证功能，可以：
+
+1. **接口测试**：调用流水分析接口，检查响应数据是否包含 `uploadSequnceNumber` 字段
+2. **数据验证**：查询数据库 `ccdi_bank_statement` 表，检查 `batch_sequence` 列是否有正确的值
+3. **日志检查**：在转换方法中添加日志，确认字段值正确传递
+
+---
+
+## 参考资料
+
+- 设计文档：`docs/plans/2026-03-05-bank-statement-field-design.md`
+- 字段映射文档：`assets/对接流水分析/ccdi_bank_statement.md`
+- 接口文档：`assets/对接流水分析/兰溪-流水分析对接-新版.md`

docs/plans/2026-03-06-theme-light-default-design.md

@@ -0,0 +1,259 @@
+# 默认主题修改为浅色模式 - 设计文档
+
+**日期：** 2026-03-06
+**状态：** 已批准
+**作者：** Claude Code
+
+## 1. 概述
+
+### 1.1 背景
+
+当前系统默认使用深色模式侧边栏（`theme-dark`），需要将默认主题修改为浅色模式（`theme-light`）。
+
+### 1.2 目标
+
+- 将新用户的默认主题从深色模式改为浅色模式
+- 保持老用户的自定义设置不受影响
+- 确保主题切换功能完全正常
+
+### 1.3 范围
+
+- 仅修改前端默认配置
+- 不涉及后端修改
+- 不涉及数据库修改
+
+## 2. 当前架构
+
+### 2.1 主题配置层级
+
+```
+settings.js (默认配置)
+    ↓
+store/modules/settings.js (Vuex 状态管理)
+    ↓
+layout/components/Settings/index.vue (用户界面设置)
+    ↓
+localStorage (持久化用户设置)
+```
+
+### 2.2 主题初始化逻辑
+
+**文件：** `ruoyi-ui/src/store/modules/settings.js`
+
+```javascript
+const storageSetting = JSON.parse(localStorage.getItem('layout-setting')) || ''
+const state = {
+  sideTheme: storageSetting.sideTheme || sideTheme,  // localStorage 优先
+  // ...
+}
+```
+
+**逻辑：**
+1. 从 `settings.js` 读取默认值
+2. 检查 `localStorage` 是否有用户设置
+3. 如果有用户设置，使用用户设置覆盖默认值
+4. 如果没有用户设置，使用默认值
+
+## 3. 设计方案
+
+### 3.1 修改内容
+
+**文件：** `ruoyi-ui/src/settings.js`
+
+**变更：** 第 9 行
+
+```javascript
+// 修改前
+sideTheme: 'theme-dark',
+
+// 修改后
+sideTheme: 'theme-light',
+```
+
+### 3.2 数据流
+
+#### 新用户首次访问
+
+```
+用户访问系统
+  ↓
+store/modules/settings.js 初始化
+  ↓
+读取 settings.js: sideTheme = 'theme-light'
+  ↓
+检查 localStorage: 为空
+  ↓
+使用默认值: 'theme-light'
+  ↓
+渲染浅色模式侧边栏
+```
+
+#### 老用户访问（已保存设置）
+
+```
+用户访问系统
+  ↓
+store/modules/settings.js 初始化
+  ↓
+读取 settings.js: sideTheme = 'theme-light'
+  ↓
+检查 localStorage: 有值 { sideTheme: 'theme-dark' }
+  ↓
+使用 localStorage 中的值: 'theme-dark'
+  ↓
+渲染深色模式侧边栏（保持用户设置）
+```
+
+### 3.3 兼容性
+
+**向后兼容：**
+- ✅ 老用户的 localStorage 设置不受影响
+- ✅ 老用户看到的主题与之前一致
+
+**向前兼容：**
+- ✅ 新用户默认看到浅色模式
+- ✅ 用户仍可自由切换主题
+- ✅ 保存/重置功能完全正常
+
+## 4. 影响分析
+
+### 4.1 影响范围
+
+**文件变更：**
+- `ruoyi-ui/src/settings.js`（1 行代码）
+
+**功能影响：**
+- ✅ 无功能变更
+- ✅ 无接口变更
+- ✅ 无数据结构变更
+
+### 4.2 用户体验影响
+
+**新用户：**
+- 从深色模式默认值 → 浅色模式默认值
+
+**老用户：**
+- 无影响（localStorage 中的设置优先）
+
+## 5. 测试计划
+
+### 5.1 测试用例
+
+| 测试场景 | 操作步骤 | 预期结果 |
+|---------|---------|---------|
+| 新用户首次访问 | 1. 清除 localStorage<br>2. 刷新页面 | 侧边栏为浅色模式 |
+| 老用户（深色模式） | 1. localStorage 保存深色模式<br>2. 刷新页面 | 侧边栏仍为深色模式 |
+| 老用户（浅色模式） | 1. localStorage 保存浅色模式<br>2. 刷新页面 | 侧边栏仍为浅色模式 |
+| 切换主题 | 1. 打开设置抽屉<br>2. 点击深色/浅色图标 | 侧边栏立即切换 |
+| 保存设置 | 1. 切换主题<br>2. 点击"保存配置"<br>3. 刷新页面 | 设置保持不变 |
+| 重置设置 | 1. 修改多个设置<br>2. 点击"重置配置" | 恢复为默认值（浅色模式） |
+
+### 5.2 浏览器兼容性
+
+测试浏览器：
+- ✅ Chrome (最新版)
+- ✅ Firefox (最新版)
+- ✅ Edge (最新版)
+- ✅ Safari (最新版)
+
+## 6. 部署方案
+
+### 6.1 部署步骤
+
+1. **修改代码**
+   ```bash
+   # 修改 ruoyi-ui/src/settings.js
+   ```
+
+2. **提交代码**
+   ```bash
+   git add ruoyi-ui/src/settings.js
+   git commit -m "feat: 将默认主题修改为浅色模式"
+   ```
+
+3. **构建前端**
+   ```bash
+   cd ruoyi-ui
+   npm run build:prod
+   ```
+
+4. **部署静态资源**
+   - 将 `ruoyi-ui/dist/` 目录部署到生产服务器
+
+5. **验证部署**
+   - 清除浏览器缓存
+   - 访问系统
+   - 验证新用户看到浅色模式
+
+### 6.2 回滚方案
+
+如果发现问题，可快速回滚：
+
+```javascript
+// settings.js 第 9 行
+sideTheme: 'theme-dark',  // 改回深色模式
+```
+
+然后重新构建和部署。
+
+## 7. 风险评估
+
+### 7.1 风险列表
+
+| 风险 | 概率 | 影响 | 缓解措施 |
+|-----|------|------|---------|
+| 老用户困惑 | 低 | 低 | 老用户设置不受影响 |
+| 浅色模式样式问题 | 低 | 中 | 需要充分测试 |
+| 部署失败 | 低 | 高 | 准备回滚方案 |
+
+### 7.2 总体风险
+
+**风险等级：** 低
+
+**理由：**
+- 仅修改一行配置代码
+- 不影响老用户设置
+- 可以快速回滚
+
+## 8. 验收标准
+
+### 8.1 功能验收
+
+- ✅ 新用户首次访问看到浅色模式侧边栏
+- ✅ 老用户的自定义主题设置保持不变
+- ✅ 主题切换功能正常
+- ✅ 主题保存功能正常
+- ✅ 主题重置功能正常
+
+### 8.2 质量验收
+
+- ✅ 代码审查通过
+- ✅ 测试用例全部通过
+- ✅ 无控制台错误
+- ✅ 浏览器兼容性测试通过
+
+## 9. 后续优化建议
+
+### 9.1 短期优化
+
+- 可以考虑在设置界面添加"推荐"标签，标注浅色模式
+- 可以考虑在首次登录时提示用户可以自定义主题
+
+### 9.2 长期优化
+
+- 可以考虑添加更多预设主题（护眼模式、高对比度模式等）
+- 可以考虑将主题设置保存到后端数据库，实现跨设备同步
+
+## 10. 附录
+
+### 10.1 相关文件
+
+- `ruoyi-ui/src/settings.js` - 默认配置文件
+- `ruoyi-ui/src/store/modules/settings.js` - Vuex 状态管理
+- `ruoyi-ui/src/layout/components/Settings/index.vue` - 设置界面组件
+- `ruoyi-ui/src/components/ThemePicker/index.vue` - 主题颜色选择器
+
+### 10.2 参考资料
+
+- [Element UI 主题定制](https://element.eleme.cn/#/zh-CN/theme)
+- [Vuex 状态管理](https://vuex.vuejs.org/zh/)

docs/plans/2026-03-06-theme-light-default.md

@@ -0,0 +1,304 @@
+# 默认主题修改为浅色模式 - 实施计划
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**目标:** 将前端默认主题从深色模式改为浅色模式，新用户首次访问时看到浅色侧边栏
+
+**架构:** 修改 `settings.js` 中的默认配置，Vuex store 会自动读取该配置并应用到界面
+
+**技术栈:** Vue.js 2.6, Vuex 3.6, Element UI 2.15
+
+---
+
+## Task 1: 修改默认主题配置
+
+**文件:**
+- Modify: `ruoyi-ui/src/settings.js:10`（修改第 10 行）
+
+### Step 1: 读取当前配置文件
+
+**操作:** 使用 Read 工具读取文件
+
+```
+Read: ruoyi-ui/src/settings.js
+```
+
+**预期结果:** 看到第 10 行为 `sideTheme: 'theme-dark',`
+
+### Step 2: 修改默认主题为浅色模式
+
+**操作:** 使用 Edit 工具修改配置
+
+```javascript
+// 修改 ruoyi-ui/src/settings.js 第 10 行
+// 修改前：
+  sideTheme: 'theme-dark',
+
+// 修改后：
+  sideTheme: 'theme-light',
+```
+
+**完整代码:**
+
+```javascript
+module.exports = {
+  /**
+   * 网页标题
+   */
+  title: process.env.VUE_APP_TITLE,
+
+  /**
+   * 侧边栏主题 深色主题theme-dark，浅色主题theme-light
+   */
+  sideTheme: 'theme-light',
+
+  /**
+   * 系统布局配置
+   */
+  showSettings: true,
+
+  /**
+   * 菜单导航模式 1、纯左侧 2、混合（左侧+顶部） 3、纯顶部
+   */
+  navType: 1,
+
+  /**
+   * 是否显示 tagsView
+   */
+  tagsView: true,
+
+  /**
+   * 显示页签图标
+   */
+  tagsIcon: false,
+
+  /**
+   * 是否固定头部
+   */
+  fixedHeader: true,
+
+  /**
+   * 是否显示logo
+   */
+  sidebarLogo: true,
+
+  /**
+   * 是否显示动态标题
+   */
+  dynamicTitle: false,
+
+  /**
+   * 是否显示底部版权
+   */
+  footerVisible: false,
+
+  /**
+   * 底部版权文本内容
+   */
+  footerContent: 'Copyright © 2018-2026 RuoYi. All Rights Reserved.'
+}
+```
+
+### Step 3: 提交代码变更
+
+**命令:**
+
+```bash
+git add ruoyi-ui/src/settings.js
+git commit -m "feat: 将默认主题修改为浅色模式
+
+- 修改 settings.js 中 sideTheme 默认值从 'theme-dark' 改为 'theme-light'
+- 新用户首次访问时将看到浅色模式侧边栏
+- 老用户的自定义设置不受影响（localStorage 优先）"
+```
+
+**预期结果:** Git 提交成功
+
+---
+
+## Task 2: 手动测试验证
+
+**说明:** 此任务需要手动在浏览器中测试，无法自动化
+
+### Step 1: 启动前端开发服务器
+
+**命令:**
+
+```bash
+cd ruoyi-ui
+npm run dev
+```
+
+**预期结果:** 前端服务启动在 http://localhost:80
+
+### Step 2: 测试新用户体验
+
+**操作步骤:**
+
+1. 打开浏览器开发者工具（F12）
+2. 进入 Application/应用 标签
+3. 在左侧找到 Local Storage
+4. 删除所有 `layout-setting` 相关的存储项
+5. 刷新页面（Ctrl+F5 强制刷新）
+
+**预期结果:**
+- 侧边栏为浅色模式（白色背景，深色文字）
+- 侧边栏 Logo 区域为浅色
+- 菜单项为深色文字
+
+### Step 3: 测试老用户体验（深色模式）
+
+**操作步骤:**
+
+1. 打开浏览器开发者工具（F12）
+2. 进入 Application/应用 标签
+3. 在 Local Storage 中添加/修改 `layout-setting`：
+   ```json
+   {
+     "sideTheme": "theme-dark",
+     "theme": "#409EFF"
+   }
+   ```
+4. 刷新页面（Ctrl+F5 强制刷新）
+
+**预期结果:**
+- 侧边栏为深色模式（深色背景，浅色文字）
+- 老用户的设置被保留
+
+### Step 4: 测试主题切换功能
+
+**操作步骤:**
+
+1. 登录系统
+2. 点击右上角设置图标（齿轮图标）
+3. 在右侧抽屉中找到"主题风格设置"
+4. 点击深色模式图标
+5. 观察侧边栏变化
+
+**预期结果:**
+- 侧边栏立即切换为深色模式
+- 菜单颜色变为浅色文字
+
+### Step 5: 测试主题保存功能
+
+**操作步骤:**
+
+1. 在设置抽屉中切换为深色模式
+2. 点击底部的"保存配置"按钮
+3. 等待提示"正在保存到本地"
+4. 刷新页面（F5）
+
+**预期结果:**
+- 刷新后侧边栏仍为深色模式
+- localStorage 中保存了 `layout-setting` 数据
+
+### Step 6: 测试主题重置功能
+
+**操作步骤:**
+
+1. 在设置抽屉中切换为深色模式并保存
+2. 点击底部的"重置配置"按钮
+3. 等待页面自动刷新
+
+**预期结果:**
+- 页面自动刷新
+- 侧边栏恢复为浅色模式（默认值）
+- localStorage 中的 `layout-setting` 被清除
+
+---
+
+## Task 3: 更新项目文档（可选）
+
+**文件:**
+- Modify: `CLAUDE.md` 或 `README.md`（如果有主题相关的说明）
+
+### Step 1: 更新 CLAUDE.md 中的主题说明
+
+**操作:** 检查 CLAUDE.md 中是否有关于默认主题的说明，如果有则更新
+
+**修改位置:** 如果文档中提到"默认深色模式"，需要更新为"默认浅色模式"
+
+### Step 2: 提交文档更新
+
+**命令:**
+
+```bash
+git add CLAUDE.md
+git commit -m "docs: 更新文档中的默认主题说明"
+```
+
+---
+
+## 验收清单
+
+在完成所有任务后，请验证以下内容：
+
+- [ ] `ruoyi-ui/src/settings.js` 中 `sideTheme` 值为 `'theme-light'`
+- [ ] 新用户首次访问看到浅色模式侧边栏
+- [ ] 老用户的深色模式设置被保留
+- [ ] 主题切换功能正常（深色 ↔ 浅色）
+- [ ] 主题保存功能正常（保存到 localStorage）
+- [ ] 主题重置功能正常（恢复为浅色模式）
+- [ ] 浏览器控制台无错误信息
+- [ ] 代码已提交到 Git
+
+---
+
+## 回滚方案
+
+如果发现问题需要回滚：
+
+### 回滚步骤
+
+**命令:**
+
+```bash
+git revert <commit-hash>
+```
+
+或手动修改 `ruoyi-ui/src/settings.js`:
+
+```javascript
+sideTheme: 'theme-dark',  // 改回深色模式
+```
+
+然后重新构建：
+
+```bash
+cd ruoyi-ui
+npm run build:prod
+```
+
+---
+
+## 部署说明
+
+### 开发环境
+
+无需额外操作，修改后自动生效（热更新）
+
+### 生产环境
+
+1. 构建前端：
+   ```bash
+   cd ruoyi-ui
+   npm run build:prod
+   ```
+
+2. 部署 `ruoyi-ui/dist/` 目录到生产服务器
+
+3. 用户刷新浏览器即可看到效果
+
+**注意:**
+- 不需要重启后端服务
+- 不需要清理数据库
+- 不需要用户做任何操作
+
+---
+
+## 相关文件
+
+- `ruoyi-ui/src/settings.js` - 默认配置文件（本次修改）
+- `ruoyi-ui/src/store/modules/settings.js` - Vuex 状态管理（无需修改）
+- `ruoyi-ui/src/layout/components/Settings/index.vue` - 设置界面（无需修改）
+- `docs/plans/2026-03-06-theme-light-default-design.md` - 设计文档

docs/test-scripts/test-async-file-upload.sh

@@ -0,0 +1,113 @@
+#!/ 异步文件上传功能集成测试脚本
+
+# 测试说明
+# 本脚本用于测试异步文件上传功能的完整流程
+# 包括: 文件上传、轮询状态、 数据保存
+
+# 测试环境
+BASE_URL="http://localhost:8080"
+TOKEN=""
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[1;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+# 获取 Token
+echo -e "${YELLOW}开始获取 Token...${NC}"
+TOKEN_RESPONSE=$(curl -s -X POST "${BASE_URL}/login/test?username=admin&password=admin123")
+TOKEN=$(echo "$TOKEN_RESPONSE" | grep -o '"token":"[^"]*' | sed 's/.*:\([^"]*\).*/\1/')
+
+if [ -z "$TOKEN" ]; then
+    echo -e "${RED}获取 Token 失败${NC}"
+    exit 1
+fi
+echo -e "${GREEN}Token 获取成功${NC}"
+
+# 准备测试数据
+echo -e "${YELLOW}准备测试项目...${NC}"
+
+# 创建测试项目
+PROJECT_DATA=$(cat <<EOF
+{
+  "projectName": "测试项目-$(date +%Y%m%d)",
+  "projectStatus": "进行中"
+}
+EOF
+)
+
+CREATE_RESPONSE=$(curl -s -X POST "${BASE_URL}/ccdi/project" \
+  -H "Authorization: Bearer ${TOKEN}" \
+  -H "Content-Type: application/json" \
+  -d "$PROJECT_DATA")
+
+PROJECT_ID=$(echo "$CREATE_RESPONSE" | grep -o '"projectId":[^,]*' | sed 's/.*:\([^"]*\).*/\1/')
+
+if [ -z "$PROJECT_ID" ]; then
+    echo -e "${RED}创建项目失败${NC}"
+    exit 1
+fi
+echo -e "${GREEN}项目创建成功: ID=${PROJECT_ID}${NC}"
+
+# 创建测试文件
+TEST_FILE="/tmp/test_bank_statement_$(date +%s).xlsx"
+echo "账号,日期,金额,摘要" > "$TEST_FILE"
+echo "622xxx,2024-01-01,1000.00,测试交易1" >> "$TEST_FILE"
+echo "623xxx,2024-01-02,2000.00,测试交易2" >> "$TEST_FILE"
+echo "622xxx,2024-01-03,3000.00,测试交易3" >> "$TEST_FILE"
+
+# 测试文件上传
+echo -e "${YELLOW}测试文件上传...${NC}"
+UPLOAD_RESPONSE=$(curl -s -X POST "${BASE_URL}/ccdi/file-upload/batch" \
+  -H "Authorization: Bearer ${TOKEN}" \
+  -F "projectId=${PROJECT_ID}" \
+  -F "files[]=@${TEST_FILE};type=text/plain")
+
+BATCH_ID=$(echo "$UPLOAD_RESPONSE" | grep -o '"data":"[^"]*' | sed 's/.*:\([^"]*\).*/\1/')
+
+if [ -z "$BATCH_ID" ]; then
+    echo -e "${RED}文件上传失败${NC}"
+    exit 1
+fi
+echo -e "${GREEN}文件上传成功: Batch ID=${BATCH_ID}${NC}"
+
+# 等待处理完成
+echo -e "${YELLOW}等待文件处理...${NC}"
+sleep 10
+
+# 查询上传记录
+RECORDS_RESPONSE=$(curl -s -X GET "${BASE_URL}/ccdi/file-upload/list?projectId=${PROJECT_ID}" \
+  -H "Authorization: Bearer ${TOKEN}")
+
+RECORDS=$(echo "$RECORDS_RESPONSE" | grep -o '"rows"' | sed 's/.*:\(\[.*\]\).*/\1/')
+
+if [ -z "$RECORDS" ] || [ "$RECORDS" = "[]" ]; then
+    echo -e "${RED}未找到上传记录${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}查询到 ${#RECORDS[@]} 条记录${NC}"
+
+# 验证记录状态
+for RECORD in $RECORDS; do
+    STATUS=$(echo "$RECORD" | grep -o '"fileStatus"' | sed 's/.*:\([^"]*\).*/\1/')
+
+    if [ "$STATUS" = "\"parsed_success\"" ]; then
+        echo -e "${GREEN}文件解析成功${NC}"
+    elif [ "$STATUS" = "\"parsed_failed\"" ]; then
+        ERROR=$(echo "$RECORD" | grep -o '"errorMessage"' | sed 's/.*:\([^"]*\).*/\1/')
+        echo -e "${RED}文件解析失败: ${ERROR}${NC}"
+    else
+        echo -e "${YELLOW}文件状态: ${STATUS}${NC}"
+    fi
+done
+
+# 清理测试数据
+echo -e "${YELLOW}清理测试数据...${NC}"
+curl -s -X DELETE "${BASE_URL}/ccdi/project/${PROJECT_ID}" \
+  -H "Authorization: Bearer ${TOKEN}"
+
+rm -f "$TEST_FILE"
+
+echo -e "${GREEN}测试完成${NC}"

ruoyi-admin/src/main/resources/application-dev.yml

@@ -1,7 +1,12 @@
 # 开发环境配置
+ruoyi:
+  # 文件路径 示例（ Windows配置D:/ruoyi/uploadPath，Linux配置 /home/ruoyi/uploadPath）
+  profile: D:/ruoyi/uploadPath
+
+
 server:
     # 服务器的HTTP端口，默认为8080
-    port: 8080
+    port: 62318
     servlet:
         # 应用的访问路径
         context-path: /
@@ -124,6 +129,9 @@ lsfx:
       fetch-inner-flow: /watson/api/project/getJZFileOrZjrcuFile
       check-parse-status: /watson/api/project/upload/getpendings
       get-bank-statement: /watson/api/project/getBSByLogId
+      # 新增接口
+      get-file-upload-status: /watson/api/project/bs/upload
+      delete-files: /watson/api/project/batchDeleteUploadFile
 
     # RestTemplate配置
     connection-timeout: 30000  # 连接超时30秒

ruoyi-admin/src/main/resources/application.yml

@@ -6,8 +6,6 @@ ruoyi:
   version: 3.9.1
   # 版权年份
   copyrightYear: 2026
-  # 文件路径 示例（ Windows配置D:/ruoyi/uploadPath，Linux配置 /home/ruoyi/uploadPath）
-  profile: D:/ruoyi/uploadPath
   # 获取ip地址开关
   addressEnabled: false
   # 验证码类型 math 数字计算 char 字符验证

ruoyi-ui/src/api/ccdiProjectUpload.js

@@ -79,3 +79,63 @@ export function getImportStatus(taskId) {
     method: 'get'
   })
 }
+
+// ========== 批量文件上传相关接口 ==========
+
+/**
+ * 批量上传文件
+ * @param {Number} projectId 项目ID
+ * @param {Array<File>} files 文件数组
+ * @returns {Promise} 返回 batchId
+ */
+export function batchUploadFiles(projectId, files) {
+  const formData = new FormData()
+  files.forEach(file => {
+    formData.append('files', file)
+  })
+  formData.append('projectId', projectId)
+  
+  return request({
+    url: '/ccdi/file-upload/batch',
+    method: 'post',
+    data: formData,
+    headers: {
+      'Content-Type': 'multipart/form-data'
+    },
+    timeout: 300000  // 5分钟超时
+  })
+}
+
+/**
+ * 查询文件上传记录列表
+ * @param {Object} params 查询参数
+ */
+export function getFileUploadList(params) {
+  return request({
+    url: '/ccdi/file-upload/list',
+    method: 'get',
+    params
+  })
+}
+
+/**
+ * 查询文件上传统计
+ * @param {Number} projectId 项目ID
+ */
+export function getFileUploadStatistics(projectId) {
+  return request({
+    url: `/ccdi/file-upload/statistics/${projectId}`,
+    method: 'get'
+  })
+}
+
+/**
+ * 查询文件上传详情
+ * @param {Number} id 记录ID
+ */
+export function getFileUploadDetail(id) {
+  return request({
+    url: `/ccdi/file-upload/detail/${id}`,
+    method: 'get'
+  })
+}

ruoyi-ui/src/settings.js

@@ -7,7 +7,7 @@ module.exports = {
   /**
    * 侧边栏主题 深色主题theme-dark，浅色主题theme-light
    */
-  sideTheme: 'theme-dark',
+  sideTheme: 'theme-light',
 
   /**
    * 系统布局配置

ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue

@@ -46,6 +46,87 @@
         </div>
       </div>
 
+      <!-- 文件上传记录列表 -->
+      <div class="file-list-section">
+        <div class="list-toolbar">
+          <div class="filter-group">
+            <el-select
+              v-model="queryParams.fileStatus"
+              placeholder="文件状态"
+              clearable
+              @change="loadFileList"
+              style="width: 150px"
+            >
+              <el-option label="上传中" value="uploading"></el-option>
+              <el-option label="解析中" value="parsing"></el-option>
+              <el-option label="解析成功" value="parsed_success"></el-option>
+              <el-option label="解析失败" value="parsed_failed"></el-option>
+            </el-select>
+          </div>
+
+          <el-button icon="el-icon-refresh" @click="handleManualRefresh">刷新</el-button>
+        </div>
+
+        <el-table :data="fileUploadList" v-loading="listLoading" stripe border>
+          <el-table-column prop="fileName" label="文件名" min-width="200"></el-table-column>
+          <el-table-column prop="fileSize" label="文件大小" width="120">
+            <template slot-scope="scope">
+              {{ formatFileSize(scope.row.fileSize) }}
+            </template>
+          </el-table-column>
+          <el-table-column prop="fileStatus" label="状态" width="120">
+            <template slot-scope="scope">
+              <el-tag :type="getStatusType(scope.row.fileStatus)" size="small">
+                {{ getStatusText(scope.row.fileStatus) }}
+              </el-tag>
+            </template>
+          </el-table-column>
+          <el-table-column prop="enterpriseNames" label="主体名称" min-width="150">
+            <template slot-scope="scope">
+              {{ scope.row.enterpriseNames || '-' }}
+            </template>
+          </el-table-column>
+          <el-table-column prop="uploadTime" label="上传时间" width="180">
+            <template slot-scope="scope">
+              {{ formatUploadTime(scope.row.uploadTime) }}
+            </template>
+          </el-table-column>
+          <el-table-column prop="uploadUser" label="上传人" width="100"></el-table-column>
+          <el-table-column label="操作" width="120" fixed="right">
+            <template slot-scope="scope">
+              <el-button
+                v-if="scope.row.fileStatus === 'parsed_success'"
+                type="text"
+                size="small"
+                @click="handleViewFlow(scope.row)"
+              >
+                查看流水
+              </el-button>
+              <el-button
+                v-if="scope.row.fileStatus === 'parsed_failed'"
+                type="text"
+                size="small"
+                @click="handleViewError(scope.row)"
+              >
+                查看错误
+              </el-button>
+              <span v-if="scope.row.fileStatus === 'uploading' || scope.row.fileStatus === 'parsing'">
+                -
+              </span>
+            </template>
+          </el-table-column>
+        </el-table>
+
+        <el-pagination
+          @current-change="handlePageChange"
+          :current-page="queryParams.pageNum"
+          :page-size="queryParams.pageSize"
+          :total="total"
+          layout="total, prev, pager, next, jumper"
+          style="margin-top: 16px; text-align: right"
+        ></el-pagination>
+      </div>
+
       <!-- 数据质量检查
       <div class="quality-check-section">
         <div class="section-header">
@@ -149,6 +230,63 @@
         >
       </span>
     </el-dialog>
+
+    <!-- 批量上传弹窗 -->
+    <el-dialog
+      title="批量上传流水文件"
+      :visible.sync="batchUploadDialogVisible"
+      :close-on-click-modal="false"
+      width="700px"
+    >
+      <el-upload
+        class="batch-upload-area"
+        drag
+        action="#"
+        multiple
+        :auto-upload="false"
+        :on-change="handleBatchFileChange"
+        :file-list="selectedFiles"
+      >
+        <i class="el-icon-upload"></i>
+        <div class="el-upload__text">将文件拖到此处，或<em>点击上传</em></div>
+        <div class="el-upload__tip" slot="tip">
+          支持 PDF、CSV、Excel 格式文件，最多100个文件，单个文件不超过50MB
+        </div>
+      </el-upload>
+
+      <div v-if="selectedFiles.length > 0" class="selected-files">
+        <div class="files-header">
+          <span>已选择 {{ selectedFiles.length }} 个文件</span>
+        </div>
+        <div class="files-list">
+          <div
+            v-for="(file, index) in selectedFiles"
+            :key="index"
+            class="file-item"
+          >
+            <i class="el-icon-document"></i>
+            <span class="file-name">{{ file.name }}</span>
+            <span class="file-size">{{ formatFileSize(file.size) }}</span>
+            <el-button
+              type="text"
+              icon="el-icon-close"
+              @click="handleRemoveFile(index)"
+            ></el-button>
+          </div>
+        </div>
+      </div>
+
+      <span slot="footer">
+        <el-button @click="batchUploadDialogVisible = false">取消</el-button>
+        <el-button
+          type="primary"
+          :loading="uploadLoading"
+          :disabled="selectedFiles.length === 0"
+          @click="handleBatchUpload"
+          >开始上传</el-button
+        >
+      </span>
+    </el-dialog>
   </div>
 </template>
 
@@ -160,7 +298,11 @@ import {
   pullBankInfo,
   updateNameListSelection,
   uploadFile,
+  batchUploadFiles,
+  getFileUploadList,
+  getFileUploadStatistics,
 } from "@/api/ccdiProjectUpload";
+import { parseTime } from "@/utils/ruoyi";
 
 export default {
   name: "UploadData",
@@ -218,7 +360,7 @@ export default {
         {
           key: "transaction",
           title: "流水导入",
-          desc: "支持 Excel、PDF 格式文件上传",
+          desc: "支持 PDF、CSV、Excel 格式文件上传",
           icon: "el-icon-document",
           btnText: "上传流水",
           uploaded: false,
@@ -261,6 +403,34 @@ export default {
           level: "info",
         },
       ],
+      // === 批量上传相关 ===
+      batchUploadDialogVisible: false,
+      selectedFiles: [],
+      uploadLoading: false,
+
+      // === 统计数据 ===
+      statistics: {
+        uploading: 0,
+        parsing: 0,
+        parsed_success: 0,
+        parsed_failed: 0,
+      },
+
+      // === 文件列表相关 ===
+      fileUploadList: [],
+      listLoading: false,
+      queryParams: {
+        projectId: null,
+        fileStatus: null,
+        pageNum: 1,
+        pageSize: 20,
+      },
+      total: 0,
+
+      // === 轮询相关 ===
+      pollingTimer: null,
+      pollingEnabled: false,
+      pollingInterval: 5000,
     };
   },
   created() {
@@ -272,6 +442,20 @@ export default {
   mounted() {
     // 组件挂载后监听项目ID变化
     this.$watch("projectId", this.loadInitialData);
+
+    // 加载统计数据和文件列表
+    this.loadStatistics();
+    this.loadFileList();
+
+    // 检查是否需要启动轮询
+    this.$nextTick(() => {
+      if (this.statistics.uploading > 0 || this.statistics.parsing > 0) {
+        this.startPolling();
+      }
+    });
+  },
+  beforeDestroy() {
+    this.stopPolling();
   },
   methods: {
     /** 加载初始数据 */
@@ -361,13 +545,19 @@ export default {
       const card = this.uploadCards.find((c) => c.key === key);
       if (!card) return;
 
-      if (key === "namelist") {
+      if (key === "transaction") {
-        this.showNameListDialog = true;
+        // 流水导入 - 打开批量上传弹窗
-      } else {
+        this.batchUploadDialogVisible = true;
+        this.selectedFiles = [];
+      } else if (key === "credit") {
+        // 征信导入 - 保持现有逻辑
         this.uploadFileType = key;
         this.uploadDialogTitle = `上传${card.title}`;
         this.uploadFileTypes = card.desc.replace(/.*支持|上传/g, "").trim();
         this.showUploadDialog = true;
+      } else if (key === "namelist") {
+        // 名单库选择 - 保持现有逻辑
+        this.showNameListDialog = true;
       }
     },
     /** 文件选择变化 */
@@ -601,6 +791,221 @@ export default {
       };
       return statusMap[status] || "未知";
     },
+
+    // === 批量上传相关方法 ===
+
+    /** 批量上传的文件选择变化 */
+    handleBatchFileChange(file, fileList) {
+      if (fileList.length > 100) {
+        this.$message.warning("最多上传100个文件");
+        fileList = fileList.slice(0, 100);
+      }
+
+      const validTypes = ['.pdf', '.csv', '.xlsx', '.xls'];
+      const invalidFiles = fileList.filter((f) => {
+        const ext = f.name.substring(f.name.lastIndexOf(".")).toLowerCase();
+        return !validTypes.includes(ext);
+      });
+
+      if (invalidFiles.length > 0) {
+        this.$message.error("仅支持 PDF、CSV、Excel 格式文件");
+        return;
+      }
+
+      const oversizedFiles = fileList.filter((f) => f.size > 50 * 1024 * 1024);
+      if (oversizedFiles.length > 0) {
+        this.$message.error("单个文件不能超过50MB");
+        return;
+      }
+
+      this.selectedFiles = fileList;
+    },
+
+    /** 删除已选文件 */
+    handleRemoveFile(index) {
+      this.selectedFiles.splice(index, 1);
+    },
+
+    /** 开始批量上传 */
+    async handleBatchUpload() {
+      if (this.selectedFiles.length === 0) {
+        this.$message.warning("请选择要上传的文件");
+        return;
+      }
+
+      this.uploadLoading = true;
+
+      try {
+        const res = await batchUploadFiles(
+          this.projectId,
+          this.selectedFiles.map((f) => f.raw)
+        );
+
+        this.uploadLoading = false;
+        this.batchUploadDialogVisible = false;
+
+        this.$message.success("上传任务已提交，请查看处理进度");
+
+        // 刷新数据并启动轮询
+        await Promise.all([this.loadStatistics(), this.loadFileList()]);
+
+        this.startPolling();
+      } catch (error) {
+        this.uploadLoading = false;
+        this.$message.error("上传失败：" + (error.msg || "未知错误"));
+      }
+    },
+
+    // === 统计和列表相关方法 ===
+
+    /** 加载统计数据 */
+    async loadStatistics() {
+      try {
+        const res = await getFileUploadStatistics(this.projectId);
+        this.statistics = res.data || {
+          uploading: 0,
+          parsing: 0,
+          parsed_success: 0,
+          parsed_failed: 0,
+        };
+      } catch (error) {
+        console.error("加载统计数据失败:", error);
+      }
+    },
+
+    /** 加载文件列表 */
+    async loadFileList() {
+      this.listLoading = true;
+
+      try {
+        const params = {
+          projectId: this.projectId,
+          fileStatus: this.queryParams.fileStatus,
+          pageNum: this.queryParams.pageNum,
+          pageSize: this.queryParams.pageSize,
+        };
+
+        const res = await getFileUploadList(params);
+        this.fileUploadList = res.rows || [];
+        this.total = res.total || 0;
+      } catch (error) {
+        this.$message.error("加载文件列表失败");
+        console.error(error);
+      } finally {
+        this.listLoading = false;
+      }
+    },
+
+    // === 轮询相关方法 ===
+
+    /** 启动轮询 */
+    startPolling() {
+      if (this.pollingEnabled) return;
+      this.pollingEnabled = true;
+
+      const poll = () => {
+        if (!this.pollingEnabled) return;
+
+        Promise.all([this.loadStatistics(), this.loadFileList()])
+          .then(() => {
+            if (
+              this.statistics.uploading === 0 &&
+              this.statistics.parsing === 0
+            ) {
+              this.stopPolling();
+              return;
+            }
+            this.pollingTimer = setTimeout(poll, this.pollingInterval);
+          })
+          .catch((error) => {
+            console.error("轮询失败:", error);
+            this.pollingTimer = setTimeout(poll, this.pollingInterval);
+          });
+      };
+
+      poll();
+    },
+
+    /** 停止轮询 */
+    stopPolling() {
+      this.pollingEnabled = false;
+      if (this.pollingTimer) {
+        clearTimeout(this.pollingTimer);
+        this.pollingTimer = null;
+      }
+    },
+
+    /** 手动刷新 */
+    async handleManualRefresh() {
+      await Promise.all([this.loadStatistics(), this.loadFileList()]);
+
+      this.$message.success("刷新成功");
+
+      if (this.statistics.uploading > 0 || this.statistics.parsing > 0) {
+        this.startPolling();
+      }
+    },
+
+    // === 辅助方法 ===
+
+    /** 分页变化 */
+    handlePageChange(pageNum) {
+      this.queryParams.pageNum = pageNum;
+      this.loadFileList();
+    },
+
+    /** 查看流水 */
+    handleViewFlow(record) {
+      this.$emit("menu-change", {
+        key: "detail",
+        route: "detail",
+        params: { logId: record.logId },
+      });
+    },
+
+    /** 查看错误 */
+    handleViewError(record) {
+      this.$alert(record.errorMessage || "未知错误", "错误信息", {
+        confirmButtonText: "确定",
+        type: "error",
+      });
+    },
+
+    /** 状态文本映射 */
+    getStatusText(status) {
+      const map = {
+        uploading: "上传中",
+        parsing: "解析中",
+        parsed_success: "解析成功",
+        parsed_failed: "解析失败",
+      };
+      return map[status] || status;
+    },
+
+    /** 状态标签类型映射 */
+    getStatusType(status) {
+      const map = {
+        uploading: "primary",
+        parsing: "warning",
+        parsed_success: "success",
+        parsed_failed: "danger",
+      };
+      return map[status] || "info";
+    },
+
+    /** 格式化文件大小 */
+    formatFileSize(bytes) {
+      if (bytes === 0) return "0 B";
+      const k = 1024;
+      const sizes = ["B", "KB", "MB", "GB"];
+      const i = Math.floor(Math.log(bytes) / Math.log(k));
+      return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + " " + sizes[i];
+    },
+    /** 格式化上传时间 */
+    formatUploadTime(time) {
+      const formatted = parseTime(time, "{y}-{m}-{d} {h}:{i}:{s}");
+      return formatted || "-";
+    },
   },
 };
 </script>
@@ -876,6 +1281,26 @@ export default {
   }
 }
 
+// 文件列表区域
+.file-list-section {
+  background: #fff;
+  border-radius: 4px;
+  padding: 20px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.05);
+
+  .list-toolbar {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 16px;
+
+    .filter-group {
+      display: flex;
+      gap: 12px;
+    }
+  }
+}
+
 // 上传弹窗样式
 ::v-deep .el-dialog__wrapper {
   .upload-area {
@@ -898,6 +1323,83 @@ export default {
   }
 }
 
+// 批量上传弹窗样式
+.batch-upload-area {
+  width: 100%;
+
+  ::v-deep .el-upload {
+    width: 100%;
+
+    .el-upload-dragger {
+      width: 100%;
+      height: 180px;
+    }
+  }
+}
+
+.selected-files {
+  margin-top: 16px;
+  border: 1px solid #ebeef5;
+  border-radius: 4px;
+  max-height: 300px;
+  overflow-y: auto;
+
+  .files-header {
+    padding: 12px 16px;
+    background: #f5f7fa;
+    border-bottom: 1px solid #ebeef5;
+    font-size: 14px;
+    font-weight: 500;
+    color: #606266;
+  }
+
+  .files-list {
+    padding: 8px;
+
+    .file-item {
+      display: flex;
+      align-items: center;
+      padding: 8px 12px;
+      border-radius: 4px;
+      transition: background 0.3s;
+
+      &:hover {
+        background: #f5f7fa;
+      }
+
+      i {
+        font-size: 18px;
+        color: #1890ff;
+        margin-right: 8px;
+      }
+
+      .file-name {
+        flex: 1;
+        font-size: 14px;
+        color: #303133;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        white-space: nowrap;
+      }
+
+      .file-size {
+        font-size: 12px;
+        color: #909399;
+        margin: 0 12px;
+      }
+
+      .el-button {
+        padding: 4px;
+        color: #909399;
+
+        &:hover {
+          color: #f56c6c;
+        }
+      }
+    }
+  }
+}
+
 // 响应式
 @media (max-width: 1200px) {
   .upload-section .upload-cards {
@@ -908,6 +1410,7 @@ export default {
     grid-template-columns: repeat(3, 1fr);
     gap: 16px;
   }
+
 }
 
 @media (max-width: 768px) {
@@ -932,5 +1435,11 @@ export default {
   .quality-check-section .metrics {
     grid-template-columns: 1fr;
   }
+
+  .file-list-section .list-toolbar {
+    flex-direction: column;
+    align-items: flex-start;
+    gap: 12px;
+  }
 }
 </style>

ruoyi-ui/src/views/ccdiProject/detail.vue

@@ -60,6 +60,7 @@ import ParamConfig from "./components/detail/ParamConfig";
 import PreliminaryCheck from "./components/detail/PreliminaryCheck";
 import SpecialCheck from "./components/detail/SpecialCheck";
 import DetailQuery from "./components/detail/DetailQuery";
+import {getProject} from "@/api/ccdiProject";
 
 export default {
   name: "ProjectDetail",
@@ -99,19 +100,77 @@ export default {
       if (newId) {
         this.projectId = newId;
         this.projectInfo.projectId = newId;
+        this.initActiveTabFromRoute();
         this.initPageData();
       }
     },
+    "$route.query.tab"() {
+      this.initActiveTabFromRoute();
+    },
   },
   created() {
     // 初始化页面数据
+    this.initActiveTabFromRoute();
     this.initPageData();
   },
   methods: {
+    initActiveTabFromRoute() {
+      const tab = (this.$route.query && this.$route.query.tab) || "";
+      const validTabs = ["upload", "config", "overview", "special", "detail"];
+      const targetTab = validTabs.includes(tab) ? tab : "upload";
+      this.setActiveTab(targetTab);
+    },
+    setActiveTab(index) {
+      this.activeTab = index;
+      const componentMap = {
+        upload: "UploadData",
+        config: "ParamConfig",
+        overview: "PreliminaryCheck",
+        special: "SpecialCheck",
+        detail: "DetailQuery",
+      };
+      this.currentComponent = componentMap[index] || "UploadData";
+    },
     /** 初始化页面数据 */
     initPageData() {
       // 这里应该从API获取项目详细信息
-      this.mockProjectInfo();
+      if (!this.projectId) {
+        return;
+      }
+      this.projectInfo.projectName = "";
+      this.updatePageTitle();
+      getProject(this.projectId)
+        .then((res) => {
+          const data = res.data || {};
+          this.projectInfo = {
+            ...this.projectInfo,
+            ...data,
+            projectId: data.projectId || this.projectId,
+            projectName: data.projectName || "",
+            projectDesc: data.projectDesc || data.description || "",
+            projectStatus: String(
+              data.projectStatus !== undefined && data.projectStatus !== null
+                ? data.projectStatus
+                : data.status !== undefined && data.status !== null
+                  ? data.status
+                  : this.projectInfo.projectStatus
+            ),
+          };
+          this.updatePageTitle();
+        })
+        .catch(() => {
+          this.$message.error("Failed to load project details");
+          this.updatePageTitle();
+        });
+    },
+    updatePageTitle() {
+      const title = this.projectInfo.projectName || `ProjectDetail-${this.projectId}`;
+      this.$route.meta.title = title;
+      this.$store.dispatch("settings/setTitle", title);
+      this.$store.dispatch("tagsView/updateVisitedView", {
+        path: this.$route.path,
+        title,
+      });
     },
     /** 格式化更新时间 */
     formatUpdateTime(time) {
@@ -171,18 +230,7 @@ export default {
     /** 菜单选择事件 */
     handleMenuSelect(index) {
       console.log("菜单选择:", index);
-      this.activeTab = index;
+      this.setActiveTab(index);
-
-      // 组件映射
-      const componentMap = {
-        upload: "UploadData",
-        config: "ParamConfig",
-        overview: "PreliminaryCheck",
-        special: "SpecialCheck",
-        detail: "DetailQuery",
-      };
-
-      this.currentComponent = componentMap[index] || "UploadData";
     },
     /** UploadData 组件：菜单切换 */
     handleMenuChange({ key, route }) {
@@ -217,7 +265,7 @@ export default {
     },
     /** 刷新页面 */
     handleRefresh() {
-      this.mockProjectInfo();
+      this.initPageData();
       this.$message.success("刷新成功");
     },
     /** 导出报告 */

ruoyi-ui/src/views/ccdiProject/index.vue

@@ -61,7 +61,7 @@
 </template>
 
 <script>
-import {listProject, getStatusCounts} from '@/api/ccdiProject'
+import {getStatusCounts, listProject} from '@/api/ccdiProject'
 import SearchBar from './components/SearchBar'
 import ProjectTable from './components/ProjectTable'
 import QuickEntry from './components/QuickEntry'
@@ -234,8 +234,10 @@ export default {
     },
     /** 查看结果 */
     handleViewResult(row) {
-      console.log("查看结果:", row);
+      this.$router.push({
-      this.$modal.msgInfo("查看项目结果: " + row.projectName);
+        path: `/ccdiProject/detail/${row.projectId}`,
+        query: { tab: "overview" },
+      });
     },
     /** 重新分析 */
     handleReAnalyze(row) {
@@ -262,7 +264,7 @@ export default {
 .dpc-project-container {
   padding: 24px;
   background: #F8F9FA;
-  min-height: calc(100vh - 140px);
+  min-height: calc(100vh - 84px);
 }
 
 .page-header {

ruoyi-ui/vue.config.js

@@ -9,7 +9,7 @@ const CompressionPlugin = require('compression-webpack-plugin')
 
 const name = process.env.VUE_APP_TITLE || '纪检初核系统' // 网页标题
 
-const baseUrl = 'http://localhost:8080' // 后端接口
+const baseUrl = 'http://localhost:62318' // 后端接口
 
 const port = process.env.port || process.env.npm_config_port || 80 // 端口
 

sql/ccdi_bank_statement_add_project_id.sql

@@ -0,0 +1,14 @@
+-- 为 ccdi_bank_statement 表添加 project_id 字段
+-- 用途：关联项目ID，实现流水数据与项目的业务关联
+-- 作者：系统自动生成
+-- 日期：2026-03-04
+
+USE ccdi;
+
+-- 添加 project_id 字段
+ALTER TABLE `ccdi_bank_statement`
+ADD COLUMN `project_id` bigint(20) DEFAULT NULL COMMENT '关联项目ID' AFTER `bank_statement_id`;
+
+-- 添加索引以提升查询性能
+ALTER TABLE `ccdi_bank_statement`
+ADD INDEX `idx_project_id` (`project_id`);

sql/ccdi_file_upload_record.sql

@@ -0,0 +1,28 @@
+-- 项目文件上传记录表
+-- 用途：记录项目下所有文件的上传记录和处理状态
+-- 作者：系统
+-- 日期：2026-03-05
+
+USE ccdi;
+
+-- 创建文件上传记录表
+CREATE TABLE `ccdi_file_upload_record` (
+  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+  `project_id` bigint(20) NOT NULL COMMENT '项目ID',
+  `lsfx_project_id` int(11) DEFAULT NULL COMMENT '流水分析平台项目ID',
+  `log_id` int(11) DEFAULT NULL COMMENT '流水分析平台返回的logId',
+  `file_name` varchar(255) NOT NULL COMMENT '文件名称',
+  `file_size` bigint(20) DEFAULT NULL COMMENT '文件大小（字节）',
+  `file_status` varchar(20) NOT NULL COMMENT '文件状态：uploading-上传中，parsing-解析中，parsed_success-解析成功，parsed_failed-解析失败',
+  `enterprise_names` text COMMENT '主体名称（多个用逗号分隔）',
+  `account_nos` text COMMENT '主体账号（多个用逗号分隔）',
+  `error_message` text COMMENT '错误信息（解析失败时记录）',
+  `upload_time` datetime NOT NULL COMMENT '上传时间',
+  `upload_user` varchar(64) NOT NULL COMMENT '上传人',
+  PRIMARY KEY (`id`),
+  KEY `idx_project_id` (`project_id`),
+  KEY `idx_log_id` (`log_id`),
+  KEY `idx_file_status` (`file_status`),
+  KEY `idx_upload_time` (`upload_time`),
+  KEY `idx_project_status` (`project_id`, `file_status`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='项目文件上传记录表';