package com.pangu.school.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.pangu.school.domain.dto.SchoolQueryDTO;
import com.pangu.school.domain.entity.School;
import com.pangu.school.domain.vo.SchoolVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 学校Mapper接口
 * @author pangu
 */
@Mapper
public interface SchoolMapper extends BaseMapper<School> {

    /**
     * 按区域查询学校列表
     * @param regionId 区域ID
     * @return 学校列表
     */
    List<School> selectSchoolsByRegionId(@Param("regionId") Long regionId);

    /**
     * 查询学校列表（带数据权限）
     * @param query 查询条件
     * @return 学校列表
     */
    List<SchoolVO> selectSchoolList(SchoolQueryDTO query);

    /**
     * 根据ID查询学校
     * @param schoolId 学校ID
     * @return 学校信息
     */
    SchoolVO selectSchoolById(@Param("schoolId") Long schoolId);

    /**
     * 查询当前年份最大编码
     * @param prefix 编码前缀（如：SCH2026）
     * @return 最大编码
     */
    String selectMaxCode(@Param("prefix") String prefix);

    /**
     * 统计学校数量（按区域）
     * @param regionId 区域ID
     * @return 学校数量
     */
    int countByRegionId(@Param("regionId") Long regionId);

    /**
     * 新增学校
     * @param school 学校信息
     * @return 影响行数
     */
    int insertSchool(School school);

    /**
     * 修改学校
     * @param school 学校信息
     * @return 影响行数
     */
    int updateSchool(School school);

    /**
     * 删除学校（软删除）
     * @param schoolId 学校ID
     * @return 影响行数
     */
    int deleteSchoolById(@Param("schoolId") Long schoolId);
}
