package org.dromara.safety.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 jakarta.servlet.http.HttpServletResponse;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.safety.domain.HseQuestionUserAnswer;
import org.dromara.safety.domain.dto.questionuseranswer.HseQuestionUserAnswerBatchDownloadFileReq;
import org.dromara.safety.domain.dto.questionuseranswer.HseQuestionUserAnswerCreateReq;
import org.dromara.safety.domain.dto.questionuseranswer.HseQuestionUserAnswerQueryReq;
import org.dromara.safety.domain.dto.questionuseranswer.HseQuestionUserAnswerUpdateReq;
import org.dromara.safety.domain.vo.questionuseranswer.HseQuestionUserAnswerVo;
import org.springframework.web.multipart.MultipartFile;

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

/**
 * 用户试卷存储Service接口
 *
 * @author lcj
 * @date 2025-03-24
 */
public interface IHseQuestionUserAnswerService extends IService<HseQuestionUserAnswer> {

    /**
     * 查询用户试卷存储
     *
     * @param id 主键
     * @return 用户试卷存储
     */
    HseQuestionUserAnswerVo queryById(Long id);

    /**
     * 分页查询用户试卷存储列表
     *
     * @param req       查询条件
     * @param pageQuery 分页参数
     * @return 用户试卷存储分页列表
     */
    TableDataInfo<HseQuestionUserAnswerVo> queryPageList(HseQuestionUserAnswerQueryReq req, PageQuery pageQuery);

    /**
     * 查询符合条件的用户试卷存储列表
     *
     * @param req 查询条件
     * @return 用户试卷存储列表
     */
    List<HseQuestionUserAnswerVo> queryList(HseQuestionUserAnswerQueryReq req);

    /**
     * 新增用户试卷存储
     *
     * @param req 用户试卷存储
     * @return 新增用户试卷存储id
     */
    Long insertByBo(HseQuestionUserAnswerCreateReq req);

    /**
     * 通过zip文件批量上传用户试卷存储
     *
     * @param multipartFile zip文件
     * @param projectId     项目id
     * @return 是否上传成功
     */
    Boolean batchUploadFileByZip(MultipartFile multipartFile, Long projectId);

    /**
     * 修改用户试卷存储
     *
     * @param req 用户试卷存储
     * @return 是否修改成功
     */
    Boolean updateByBo(HseQuestionUserAnswerUpdateReq req);

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

    /**
     * 获取用户试卷存储视图对象
     *
     * @param questionUserAnswer 用户试卷存储对象
     * @return 用户试卷存储视图对象
     */
    HseQuestionUserAnswerVo getVo(HseQuestionUserAnswer questionUserAnswer);

    /**
     * 获取用户试卷存储查询条件封装
     *
     * @param req 用户试卷存储查询条件
     * @return 用户试卷存储查询条件封装
     */
    LambdaQueryWrapper<HseQuestionUserAnswer> buildQueryWrapper(HseQuestionUserAnswerQueryReq req);

    /**
     * 获取用户试卷存储分页对象视图
     *
     * @param questionUserAnswerPage 用户试卷存储分页对象
     * @return 用户试卷存储分页对象视图
     */
    Page<HseQuestionUserAnswerVo> getVoPage(Page<HseQuestionUserAnswer> questionUserAnswerPage);

    /**
     * 批量下载用户试卷存储文件
     *
     * @param req      用户试卷存储文件下载请求
     * @param response 设置响应头和向客户端发送文件内容
     */
    void batchDownloadFile(HseQuestionUserAnswerBatchDownloadFileReq req, HttpServletResponse response);

}
