package org.dromara.art.service;

import org.dromara.art.domain.vo.ArtSchoolVo;
import org.dromara.art.domain.bo.ArtSchoolBo;
import org.dromara.art.domain.bo.ArtSchoolSubmitBo;
import org.dromara.art.domain.vo.ArtSchoolImportPreviewVo;
import org.dromara.art.domain.vo.ArtSchoolImportResultVo;
import org.dromara.art.domain.vo.ArtSchoolSubmitResultVo;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.springframework.web.multipart.MultipartFile;

import jakarta.servlet.http.HttpServletResponse;

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

/**
 * 学校基础信息主表Service接口
 *
 * @author ZhouWenTao
 * @date 2026-02-17
 */
public interface IArtSchoolService {

    /**
     * 查询学校基础信息主表
     *
     * @param schoolId 主键
     * @return 学校基础信息主表
     */
    ArtSchoolVo queryById(Long schoolId);

    /**
     * 分页查询学校基础信息主表列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 学校基础信息主表分页列表
     */
    TableDataInfo<ArtSchoolVo> queryPageList(ArtSchoolBo bo, PageQuery pageQuery);

    /**
     * 查询符合条件的学校基础信息主表列表
     *
     * @param bo 查询条件
     * @return 学校基础信息主表列表
     */
    List<ArtSchoolVo> queryList(ArtSchoolBo bo);

    /**
     * 导出学校主子表模板数据（多sheet）
     *
     * @param bo       查询条件
     * @param response 响应对象
     */
    void exportTemplateData(ArtSchoolBo bo, HttpServletResponse response);

    /**
     * 导出空模板
     *
     * @param response 响应对象
     */
    void exportImportTemplate(HttpServletResponse response);

    /**
     * 导入预检
     *
     * @param file Excel文件
     * @return 预检结果
     */
    ArtSchoolImportPreviewVo previewImport(MultipartFile file);

    /**
     * 导入执行
     *
     * @param file             Excel文件
     * @param replaceMainCodes 需要替换的学校编码集合
     * @param replaceAll       是否全部替换
     * @return 执行结果
     */
    ArtSchoolImportResultVo importData(MultipartFile file, List<String> replaceMainCodes, boolean replaceAll);

    /**
     * 新增学校基础信息主表
     *
     * @param bo 学校基础信息主表
     * @return 是否新增成功
     */
    Boolean insertByBo(ArtSchoolBo bo);

    /**
     * 新增学校基础信息与详情信息
     *
     * @param bo 统一提交对象
     * @return 处理结果
     */
    ArtSchoolSubmitResultVo insertWithDetailByBo(ArtSchoolSubmitBo bo);

    /**
     * 修改学校基础信息与详情信息
     *
     * @param bo 统一提交对象
     * @return 处理结果
     */
    ArtSchoolSubmitResultVo updateWithDetailByBo(ArtSchoolSubmitBo bo);

    /**
     * 修改学校基础信息主表
     *
     * @param bo 学校基础信息主表
     * @return 是否修改成功
     */
    Boolean updateByBo(ArtSchoolBo bo);

    /**
     * 校验并批量删除学校基础信息主表信息
     *
     * @param ids     待删除的主键集合
     * @param isValid 是否进行有效性校验
     * @return 是否删除成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
}
