package com.ruoyi.education.service;

import java.util.List;
import com.ruoyi.education.domain.EduSemester;

/**
 * 学期信息Service接口
 * 
 * @author ruoyi
 * @date 2024-09-26
 */
public interface IEduSemesterService 
{
    /**
     * 查询学期信息
     * 
     * @param semesterId 学期信息主键
     * @return 学期信息
     */
    public EduSemester selectEduSemesterBySemesterId(Long semesterId);

    /**
     * 查询学期信息列表
     * 
     * @param eduSemester 学期信息
     * @return 学期信息集合
     */
    public List<EduSemester> selectEduSemesterList(EduSemester eduSemester);

    /**
     * 新增学期信息
     * 
     * @param eduSemester 学期信息
     * @return 结果
     */
    public int insertEduSemester(EduSemester eduSemester);

    /**
     * 修改学期信息
     * 
     * @param eduSemester 学期信息
     * @return 结果
     */
    public int updateEduSemester(EduSemester eduSemester);

    /**
     * 批量删除学期信息
     * 
     * @param semesterIds 需要删除的学期信息主键集合
     * @return 结果
     */
    public int deleteEduSemesterBySemesterIds(Long[] semesterIds);

    /**
     * 删除学期信息信息
     * 
     * @param semesterId 学期信息主键
     * @return 结果
     */
    public int deleteEduSemesterBySemesterId(Long semesterId);

    /**
     * 根据学期编码查询学期信息
     * 
     * @param semesterCode 学期编码
     * @return 学期信息
     */
    public EduSemester selectEduSemesterBySemesterCode(String semesterCode);

    /**
     * 查询当前进行中的学期
     * 
     * @return 当前学期信息
     */
    public EduSemester selectCurrentSemester();

    /**
     * 查询可选课的学期列表
     * 
     * @return 学期信息集合
     */
    public List<EduSemester> selectEnrollableSemesters();

    /**
     * 发布学期（将状态改为进行中）
     * 
     * @param semesterId 学期ID
     * @return 结果
     */
    public int publishSemester(Long semesterId);

    /**
     * 归档学期（将状态改为已归档）
     * 
     * @param semesterId 学期ID
     * @return 结果
     */
    public int archiveSemester(Long semesterId);

    /**
     * 校验学期编码是否唯一
     * 
     * @param eduSemester 学期信息
     * @return 结果
     */
    public String checkSemesterCodeUnique(EduSemester eduSemester);

    /**
     * 校验学期时间是否冲突
     * 
     * @param eduSemester 学期信息
     * @return 结果
     */
    public String checkSemesterTimeConflict(EduSemester eduSemester);
}