package org.dromara.system.service;

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.system.domain.BusProjectFile;
import org.dromara.system.domain.dto.projectfile.BusProjectFileQueryReq;
import org.dromara.system.domain.dto.projectfile.BusProjectFileUpdateReq;
import org.dromara.system.domain.vo.projectfile.BusProjectFileVo;

import java.util.Collection;
import java.util.List;

/**
 * 项目文件存储Service接口
 *
 * @author lilemy
 * @date 2025-04-23
 */
public interface IBusProjectFileService extends IService<BusProjectFile> {

    /**
     * 查询项目文件存储
     *
     * @param id 主键
     * @return 项目文件存储
     */
    BusProjectFileVo queryById(Long id);

    /**
     * 分页查询项目文件存储列表
     *
     * @param req       查询条件
     * @param pageQuery 分页参数
     * @return 项目文件存储分页列表
     */
    TableDataInfo<BusProjectFileVo> queryPageList(BusProjectFileQueryReq req, PageQuery pageQuery);

    /**
     * 查询符合条件的项目文件存储列表
     *
     * @param req 查询条件
     * @return 项目文件存储列表
     */
    List<BusProjectFileVo> queryList(BusProjectFileQueryReq req);

    /**
     * 修改项目文件存储
     *
     * @param req 项目文件存储
     * @return 是否修改成功
     */
    Boolean updateByBo(BusProjectFileUpdateReq req);

    /**
     * 校验并批量删除项目文件存储信息
     *
     * @param ids     待删除的主键集合
     * @param isValid 是否进行有效性校验
     * @return 是否删除成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 获取项目文件存储视图对象
     *
     * @param projectFile 项目文件存储对象
     * @return 项目文件存储视图对象
     */
    BusProjectFileVo getVo(BusProjectFile projectFile);

    /**
     * 获取项目文件存储查询条件封装
     *
     * @param req 查询条件
     * @return 查询条件封装
     */
    LambdaQueryWrapper<BusProjectFile> buildQueryWrapper(BusProjectFileQueryReq req);

    /**
     * 获取项目文件存储分页对象视图
     *
     * @param projectFilePage 项目文件存储分页对象
     * @return 项目文件存储分页对象视图
     */
    Page<BusProjectFileVo> getVoPage(Page<BusProjectFile> projectFilePage);

}
