接口变动

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

.gitignore

@@ -67,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 数据库操作时，使用项目配置文件中的数据库

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

@@ -15,8 +15,8 @@ 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;
@@ -109,8 +109,8 @@ public class LsfxAnalysisClient {
     /**
      * 上传文件
      */
-    public UploadFileResponse uploadFile(Integer groupId, MultipartFile file) {
-        log.info("【流水分析】上传文件请求: groupId={}, fileName={}", groupId, file.getOriginalFilename());
+    public UploadFileResponse uploadFile(Integer groupId, File file) {
+        log.info("【流水分析】上传文件请求: groupId={}, fileName={}", groupId, file.getName());
         long startTime = System.currentTimeMillis();
 
         try {

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

@@ -18,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;
+
 /**
  * 流水分析平台接口测试控制器
  */
@@ -76,8 +82,28 @@ public class LsfxTestController {
             return AjaxResult.error("文件大小超过限制：最大10MB");
         }
 
-        UploadFileResponse response = lsfxAnalysisClient.uploadFile(groupId, file);
-        return AjaxResult.success(response);
+        // 将 MultipartFile 转换为 File
+        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 = "从数仓拉取行内流水数据")

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/util/HttpUtil.java

@@ -1,10 +1,11 @@
 package com.ruoyi.lsfx.util;
 
-import com.ruoyi.lsfx.exception.LsfxApiException;
 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;
@@ -13,6 +14,7 @@ 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;
 
 /**
@@ -200,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

@@ -198,6 +198,7 @@ public class CcdiBankStatement implements Serializable {
             entity.setTrxType(item.getTransTypeId());
             entity.setCustomerLeId(item.getCustomerId());
             entity.setCustomerAccountName(item.getCustomerName());
+            entity.setBatchSequence(item.getUploadSequenceNumber());
 
             // 5. 特殊字段处理
             entity.setMetaJson(null);  // 根据文档要求强制设为 null

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/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/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>

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/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: /

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") {
-        this.showNameListDialog = true;
-      } else {
+      if (key === "transaction") {
+        // 流水导入 - 打开批量上传弹窗
+        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;
-
-      // 组件映射
-      const componentMap = {
-        upload: "UploadData",
-        config: "ParamConfig",
-        overview: "PreliminaryCheck",
-        special: "SpecialCheck",
-        detail: "DetailQuery",
-      };
-
-      this.currentComponent = componentMap[index] || "UploadData";
+      this.setActiveTab(index);
     },
     /** 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.$modal.msgInfo("查看项目结果: " + row.projectName);
+      this.$router.push({
+        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_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='项目文件上传记录表';