package org.dromara.project.service;

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.service.IService;
import jakarta.servlet.http.HttpServletResponse;
import org.dromara.project.domain.BusConstructionUser;
import org.dromara.project.domain.BusConstructionUserFile;
import org.dromara.project.domain.dto.constructionuserfile.BusConstructionUserFileQueryReq;
import org.dromara.project.domain.dto.constructionuserfile.BusConstructionUserFileSaveReq;
import org.dromara.project.domain.dto.constructionuserfile.BusConstructionUserFileTemplateReq;
import org.dromara.project.domain.vo.constructionuserfile.BusConstructionUserFileVo;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * 施工人员文件存储Service接口
 *
 * @author lcj
 * @date 2025-04-01
 */
public interface IBusConstructionUserFileService extends IService<BusConstructionUserFile> {

    /**
     * 查询施工人员文件存储
     *
     * @param id 主键
     * @return 施工人员文件存储
     */
    BusConstructionUserFileVo queryById(Long id);

    /**
     * 查询符合条件的施工人员文件存储列表
     *
     * @param req 查询条件
     * @return 施工人员文件存储列表
     */
    List<BusConstructionUserFileVo> queryList(BusConstructionUserFileQueryReq req);

    /**
     * 导出施工人员文件模版zip
     *
     * @param req      查询条件
     * @param response 响应对象
     */
    void downloadFileTemplate(BusConstructionUserFileTemplateReq req, HttpServletResponse response);

    /**
     * 通过zip文件批量上传施工人员文件
     *
     * @param multipartFile zip文件
     * @return 是否上传成功
     */
    Boolean batchUploadFileByZip(MultipartFile multipartFile);

    /**
     * 保存施工人员文件存储
     *
     * @param req 保存参数
     * @return 是否保存成功
     */
    Boolean saveFileList(BusConstructionUserFileSaveReq req);

    /**
     * 获取施工人员文件存储查询条件封装
     *
     * @param req 查询条件
     * @return 查询条件封装
     */
    LambdaQueryWrapper<BusConstructionUserFile> buildQueryWrapper(BusConstructionUserFileQueryReq req);

    /**
     * 获取施工人员查询条件封装
     *
     * @param req 查询条件
     * @return 查询条件封装
     */
    LambdaQueryWrapper<BusConstructionUser> buildTemplateQueryWrapper(BusConstructionUserFileTemplateReq req);

}
