/**
 * @ProjectName: 智慧评标-主观分助手
 * @Package: com.zhpb.gdyd_zhpb_zgf.repository.mysql
 * @ClassName: FileRepository
 * @Description: 文件Repository接口
 * @Author: 张志锋
 * @Date: 2025-11-01
 * @Version: 1.0
 * @Copyright: © 2025 智慧评标-主观分助手
 */
package com.zhpb.gdyd_zhpb_zgf.repository.mysql;

import com.zhpb.gdyd_zhpb_zgf.entity.mysql.File;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Optional;

/**
 * 文件 Repository
 */
@Repository
public interface FileRepository extends JpaRepository<File, Long> {

    /**
     * 根据文件ID查找文件
     *
     * @param fileId 文件ID
     * @return 文件对象
     */
    Optional<File> findByFileId(String fileId);

    /**
     * 根据项目ID查找所有文件
     *
     * @param projectId 项目ID
     * @return 文件列表
     */
    List<File> findByProjectId(String projectId);

    /**
     * 根据供应商ID查找所有文件
     *
     * @param supplierId 供应商ID
     * @return 文件列表
     */
    List<File> findBySupplierId(String supplierId);

    /**
     * 根据文件路径查找文件
     *
     * @param filePath 文件路径
     * @return 文件对象
     */
    Optional<File> findByFilePath(String filePath);

    /**
     * 根据项目ID和供应商ID查找所有文件
     *
     * @param projectId 项目ID
     * @param supplierId 供应商ID
     * @return 文件列表
     */
    List<File> findByProjectIdAndSupplierId(String projectId, String supplierId);

    /**
     * 根据项目ID和是否已向量化查找文件
     *
     * @param projectId 项目ID
     * @param isVectorized 是否已向量化
     * @return 文件列表
     */
    List<File> findByProjectIdAndIsVectorized(String projectId, Boolean isVectorized);

    /**
     * 根据项目ID和文件名查找文件
     *
     * @param projectId 项目ID
     * @param fileName 文件名
     * @return 文件列表
     */
    List<File> findByProjectIdAndFileName(String projectId, String fileName);

    /**
     * 根据目录摘取状态和更新时间查找文件（用于查找卡住的任务）
     *
     * @param status 目录摘取状态
     * @param updateTime 更新时间截止点
     * @return 文件列表
     */
    List<File> findByCatalogExtractionStatusAndUpdateTimeBefore(String status, java.time.LocalDateTime updateTime);

    /**
     * 根据目录摘取状态查找文件
     */
    List<File> findByCatalogExtractionStatus(String status);

    /**
     * 根据项目ID和目录摘取状态查找文件
     */
    List<File> findByProjectIdAndCatalogExtractionStatus(String projectId, String status);

    /**
     * 根据向量化状态查找文件
     */
    List<File> findByVectorizationStatus(String status);

    /**
     * 根据项目ID和向量化状态查找文件
     */
    List<File> findByProjectIdAndVectorizationStatus(String projectId, String status);

    /**
     * 统计目录摘取状态的文件数量
     */
    long countByCatalogExtractionStatus(String status);

    /**
     * 统计项目下目录摘取状态的文件数量
     */
    long countByProjectIdAndCatalogExtractionStatus(String projectId, String status);

    /**
     * 统计向量化状态的文件数量
     */
    long countByVectorizationStatus(String status);

    /**
     * 统计项目下向量化状态的文件数量
     */
    long countByProjectIdAndVectorizationStatus(String projectId, String status);
}

