package com.pangu.student.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.pangu.common.core.page.TableDataInfo;
import com.pangu.student.domain.dto.StudentDTO;
import com.pangu.student.domain.entity.Student;
import com.pangu.student.domain.vo.ImportResultVO;
import com.pangu.student.domain.vo.StudentVO;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * 学生服务接口
 * 
 * @author pangu
 */
public interface IStudentService extends IService<Student> {

    /**
     * 查询学生列表
     * 
     * @param studentDTO 查询条件
     * @return 学生列表
     */
    TableDataInfo selectStudentList(StudentDTO studentDTO);

    /**
     * 根据ID查询学生详情
     * 
     * @param studentId 学生ID
     * @return 学生详情
     */
    StudentVO getStudentById(Long studentId);

    /**
     * 新增学生
     * 
     * @param studentDTO 学生信息
     * @return 结果
     */
    int insertStudent(StudentDTO studentDTO);

    /**
     * 修改学生
     * 
     * @param studentDTO 学生信息
     * @return 结果
     */
    int updateStudent(StudentDTO studentDTO);

    /**
     * 删除学生
     * 
     * @param studentId 学生ID
     * @return 结果
     */
    int deleteStudent(Long studentId);

    /**
     * 批量导入学生
     * 
     * @param file Excel文件
     * @return 导入结果
     */
    ImportResultVO importStudents(MultipartFile file);

    /**
     * 检查学号是否唯一
     * 
     * @param studentNo 学号
     * @param studentId 学生ID
     * @return true唯一 false不唯一
     */
    boolean checkStudentNoUnique(String studentNo, Long studentId);

    /**
     * 检查学生是否在指定学校
     * 
     * @param studentId 学生ID
     * @param schoolId 学校ID
     * @return true在该学校 false不在
     */
    boolean isStudentInSchool(Long studentId, Long schoolId);

    /**
     * 更新学生的会员ID
     * 
     * @param studentId 学生ID
     * @param memberId 会员ID
     * @return 结果
     */
    int updateStudentMember(Long studentId, Long memberId);

    /**
     * 解绑学生（清空会员ID）
     * 
     * @param studentId 学生ID
     * @return 结果
     */
    int unbindStudent(Long studentId);
    
    /**
     * 绑定会员
     * 
     * @param studentId 学生ID
     * @param memberId 会员ID
     */
    void bindMember(Long studentId, Long memberId);

    /**
     * 统计会员绑定的学生数量
     * 
     * @param memberId 会员ID
     * @return 学生数量
     */
    int countByMemberId(Long memberId);

    /**
     * 根据会员ID查询学生列表
     * 
     * @param memberId 会员ID
     * @return 学生列表
     */
    List<StudentVO> selectStudentVOsByMemberId(Long memberId);
}
