mec/mec-biz/src/main/java/com/ym/mec/biz/service/VipGroupService.java

package com.ym.mec.biz.service;

import java.math.BigDecimal;
import java.util.Date;
import java.util.List;
import java.util.Map;

import com.ym.mec.biz.dal.dto.StudentRecoverInfoDto;
import com.ym.mec.biz.dal.dto.StudentVipGroupDetailDto;
import com.ym.mec.biz.dal.dto.TeacherBasicDto;
import com.ym.mec.biz.dal.dto.TeachingRecordBaseInfo;
import com.ym.mec.biz.dal.dto.VipBuyResultDto;
import com.ym.mec.biz.dal.dto.VipGroupApplyBaseInfoDto;
import com.ym.mec.biz.dal.dto.VipGroupApplyDto;
import com.ym.mec.biz.dal.dto.VipGroupBuyParamsDto;
import com.ym.mec.biz.dal.dto.VipGroupCostCountDto;
import com.ym.mec.biz.dal.dto.VipGroupCostCountParamsDto;
import com.ym.mec.biz.dal.dto.VipGroupManageDetailDto;
import com.ym.mec.biz.dal.dto.VipGroupPayInfoDto;
import com.ym.mec.biz.dal.entity.ClassGroup;
import com.ym.mec.biz.dal.entity.School;
import com.ym.mec.biz.dal.entity.StudentApplyRefunds.StudentApplyRefundsStatus;
import com.ym.mec.biz.dal.entity.StudentPaymentOrder;
import com.ym.mec.biz.dal.entity.StudentRecoverDto;
import com.ym.mec.biz.dal.entity.VipGroup;
import com.ym.mec.biz.dal.enums.AuditStatusEnum;
import com.ym.mec.biz.dal.page.StudentVipGroupQueryInfo;
import com.ym.mec.biz.dal.page.VipGroupAttendanceQueryInfo;
import com.ym.mec.biz.dal.page.VipGroupQueryInfo;
import com.ym.mec.biz.dal.page.VipGroupSalaryQueryInfo;
import com.ym.mec.biz.dal.page.VipGroupTeachingRecordQueryInfo;
import com.ym.mec.common.page.PageInfo;
import com.ym.mec.common.service.BaseService;

public interface VipGroupService extends BaseService<Long, VipGroup> {

    /**
     * @describe 创建vip课
     * @author Joburgess
     * @date 2019/10/30
     * @param vipGroup: VIP课申请信息
     * @return void
     */
    String createVipGroup(VipGroupApplyDto vipGroup);

    /**
     * @describe 检测vip课程是否超过范围
     * @author Joburgess
     * @date 2020/1/16
     * @param vipGroupId: 小课编号
     * @return void
     */
    void checkVipCourseIsInScore(Long vipGroupId);

    /**
     * @describe 更新vip课程信息
     * @author Joburgess
     * @date 2019/10/30
     * @param vipGroupApplyInfo: vip课信息
     * @return void
     */
    void updateVipGroup(VipGroupApplyDto vipGroupApplyInfo);

    /**
     * @describe 新增vip课程计划
     * @author Joburgess
     * @date 2019/11/11
     * @param vipGroupApplyDto:
     * @return void
     */
    void appendVipGroupCourseSchedules(VipGroupApplyDto vipGroupApplyDto);

    /**
     * @describe vip课程审核
     * @author Joburgess
     * @date 2019/10/22
     * @param vipGroupId: vip课编号
     * @param auditStatus: 审核状态
     * @return void
     */
    void vipApplyAudit(Long vipGroupId,AuditStatusEnum auditStatus,String reason);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/3
     * @params [queryInfo]
     * @return com.ym.mec.common.page.PageInfo
     * @describe 获取可购买vip课列表
     */
    PageInfo findStudentVipGroupList(StudentVipGroupQueryInfo queryInfo);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/9
     * @params [queryInfo]
     * @return com.ym.mec.common.page.PageInfo
     * @describe 获取vip课列表
     */
    PageInfo<VipGroup> findVipGroups(VipGroupQueryInfo queryInfo);

    /**
     * @describe 获取vip课教学记录
     * @author Joburgess
     * @date 2019/10/21
     * @param queryInfo: 查询条件
     * @return java.util.Map<java.lang.String,java.lang.Object>
     */
    Map<String, Object> findVipGroupTeachingRecord(VipGroupTeachingRecordQueryInfo queryInfo);

    /**
     * @describe 获取vip课教学记录基本信息
     * @author Joburgess
     * @date 2019/10/21
     * @param vipGroupId: vip课编号
     * @return com.ym.mec.biz.dal.dto.TeachingRecordBaseInfo
     */
    TeachingRecordBaseInfo findTeachingRecordBaseInfo(Long vipGroupId);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/9
     * @params [queryInfo]
     * @return com.ym.mec.common.page.PageInfo
     * @describe 获取vip课学员
     */
    PageInfo findVipGroupStudents(VipGroupQueryInfo queryInfo);

    /**
     * @describe 获取还有课程余额的学员
     * @author Joburgess
     * @date 2019/11/16
     * @param queryInfo:
     * @return com.ym.mec.common.page.PageInfo
     */
    PageInfo findHaveCourseBalanceStudents(VipGroupQueryInfo queryInfo);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/3
     * @params [vipGroupId]
     * @return com.ym.mec.biz.dal.dto.VipGroupManageDetailDto
     * @describe 获取vip课详情
     */
    VipGroupManageDetailDto getVipGroupDetail(Long vipGroupId);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/3
     * @params [vipGroupId]
     * @return com.ym.mec.biz.dal.dto.VipGroupManageDetailDto
     * @describe 获取vip课详情
     */
    VipGroupManageDetailDto getVipGroupDetailForAudit(Long vipGroupId);

    /**
     * @describe 计算vip课程购买总价,及老师课酬
     * @author Joburgess
     * @date 2019/10/23
     * @param vipGroup: vip课程
     * @param teacherId: 要计算课酬的老师的编号
     * @param onlineClassesUnitPrice: 线上课程单价
     * @param offlineClassesUnitPrice: 线下课程单价
     * @param computeTotalPrice: 是否计算课程购买总价
     * @return java.util.Map
     */
    <K extends VipGroup> Map countVipGroupPredictFee(K vipGroup,
                                                     Integer teacherId,
                                                     BigDecimal onlineClassesUnitPrice,
                                                     BigDecimal offlineClassesUnitPrice,
                                                     boolean computeTotalPrice,
                                                     boolean useDefaultTeacherSalary);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/3
     * @params [queryInfo]
     * @return com.ym.mec.common.page.PageInfo
     * @describe 获取vip课考勤记录
     */
    PageInfo findVipGroupAttendances(VipGroupAttendanceQueryInfo queryInfo);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/3
     * @params [vipGroupId]
     * @return com.ym.mec.biz.dal.dto.StudentVipGroupDetailDto
     * @describe 学生端获取vip课详情
     */
    StudentVipGroupDetailDto getVipGroupShowDetail(Long vipGroupId);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/3
     * @params [vipGroupCostCountParamsDto]
     * @return com.ym.mec.biz.dal.dto.VipGroupCostCountDto
     * @describe vip课程费用计算
     */
    VipGroupCostCountDto vipGroupCostCount(VipGroupCostCountParamsDto vipGroupCostCountParamsDto);

    /**
     * @describe 更新vip课班级人数及状态
     * @author Joburgess
     * @date 2019/10/20
     * @param vipGroupId: vip课编号
     * @param num: 人数
     * @param updateVipStatus: 是否修改VIP课状态
     * @return void
     */
    void updateVipGroupStudentNumAndStatus(Long vipGroupId, ClassGroup classGroup, Integer num, boolean updateVipStatus);

    /**
     * @describe 课程购买成功后，创建课程相关信息
     * @author Joburgess
     * @date 2019/11/12
     * @param vipGroupId: vip课编号
     * @return void
     */
    void createVipGroupCourseScheInfo(Long vipGroupId,ClassGroup classGroup);

    /**
     * @describe 检测能否购买vip课
     * @author Joburgess
     * @date 2019/12/2
     * @param vipGroupId:
     * @return void
     */
    void enableBuyVipGroup(Integer vipGroupId, Integer userId);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/3
     * @params [vipGroupBuyParams]
     * @return void
     * @describe 购买vip课程
     */
    Map buyVipGroup(VipGroupBuyParamsDto vipGroupBuyParams) throws Exception;

    /**
     * @Author: Joburgess
     * @Date: 2019/10/3
     * @params [callbackParams]
     * @return void
     * @describe 支付回调接口
     */
    void orderCallback(StudentPaymentOrder order);

    /**
	 * @Author: Joburgess
	 * @Date: 2019/10/3
	 * @params [vipGroupId, studentId]
	 * @return void
	 * @describe 申请退课
	 */
	void applyRefund(Long vipGroupId);

	/**
	 * @describe 给指定学生退课
	 * @author Joburgess
	 * @date 2019/11/15
	 * @param vipGroupId: vip课程
	 * @param studentId: 学生编号
	 * @return void
	 */
	void applyRefundForStudent(Long vipGroupId, Integer studentId, BigDecimal amount);

	/**
	 * @describe 对某个学生进行休学
	 * @author Joburgess
	 * @date 2019/12/18
	 * @param vipGroupId: vip课编号
	 * @param studentId: 学生编号
	 * @return void
	 */
	void pauseForStudent(Long vipGroupId, Integer studentId);

	/**
	 * @describe 恢复休学的学生
	 * @author Joburgess
	 * @date 2019/12/18
	 * @param studentRecoverInfo:
	 * @return void
	 */
	void recoverForStudent(StudentRecoverDto studentRecoverInfo);

	/**
	 * @describe 获取学生休学信息
	 * @author Joburgess
	 * @date 2019/12/24
	 * @param vipGroupId:
	 * @param studentId:
	 * @return com.ym.mec.biz.dal.dto.StudentRecoverInfoDto
	 */
	StudentRecoverInfoDto getStudentPauseInfo(Long vipGroupId, Integer studentId);

	/**
	 * @describe 获取指定学生的剩余课时费用
	 * @author Joburgess
	 * @date 2019/11/15
	 * @param vipGroupId: VIP课编号
	 * @param studentId: 学生编号
	 * @return java.util.Map<java.lang.String,java.math.BigDecimal>
	 */
	Map<String,BigDecimal> getStudentSurplusCourseFee(Long vipGroupId, Integer studentId);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/3
     * @params [studentApplyRefunds]
     * @return void
     * @describe 退课申请审核
     */
    void applyRefundAudit(Long id,StudentApplyRefundsStatus status,String remark,BigDecimal amount);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/11
     * @params [queryInfo]
     * @return com.ym.mec.common.page.PageInfo
     * @describe vip财务记录
     */
    Map<String, Object> findVipGroupSalarys(VipGroupSalaryQueryInfo queryInfo);

    /**
     * @Author: Joburgess
     * @Date: 2019/10/11
     * @params [courseScheduleId]
     * @return java.util.List<java.lang.String>
     * @describe 获取上课签到学员
     */
    List<String> findVipGroupAttendanceStudents(Long courseScheduleId);

    /**
     * @describe 停止vip课
     * @author Joburgess
     * @date 2019/10/21
     * @param vipGroupId: vip课编号
     * @param stopReason: 取消原因
     * @return void
     */
    void stopGroup(Long vipGroupId,String stopReason);

    /**
     * 发放月度奖励
     * @return
     */
    boolean awardedMonthlyRewards();
    
    /**
     * 根据老师查询vip课教学点
     * @param userId
     * @return
     */
    List<School> querySchoolByUserId(Integer userId);

    /**
     * @describe 更新vip课基本信息
     * @author Joburgess
     * @date 2019/11/11
     * @param vipGroupApplyBaseInfo:
     * @return void
     */
    void updateVipGroupBaseInfo(VipGroupApplyBaseInfoDto vipGroupApplyBaseInfo);

    /**
     * @describe 取消达到报名时间仍未达到报名人数的vip课
     * @author Joburgess
     * @date 2019/11/13
     * @return void
     */
    void stopVipGroupWithNoCreate();

    /**
     * @describe 添加vip课学员
     * @author Joburgess
     * @date 2019/11/15
     * @param vipGroupId:
     * @param studentIds:
     * @return void
     */
    void addVipGroupStudents(Long vipGroupId,List<Integer> studentIds);

	/**
	 * 更新vipgroup至完成状态
	 */
	void updateVipGroupStatusToFinished();

	/**
	 * @describe 获取vip课购买信息
	 * @author Joburgess
	 * @date 2019/11/29
	 * @param vipGroupId: vip课编号
	 * @param userId: 用户编号
	 * @return void
	 */
    VipGroupPayInfoDto getVipGroupPayInfo(Integer vipGroupId,Integer userId);

    /**
     * @describe 获取vip课购买结果信息
     * @author Joburgess
     * @date 2019/11/29
     * @param vipGroupId: 小课编号
     * @return
     */
    VipBuyResultDto findVipBuyResultInfo(Integer vipGroupId);

    /**
     * @describe 根据vip课所在部门与深部获取教师
     * @author Joburgess
     * @date 2019/12/24
     * @param vipGroupId: 小课编号
     * @return java.util.List<com.ym.mec.biz.dal.dto.TeacherBasicDto>
     */
    List<TeacherBasicDto> findTeacherWithVipGroupOrganAndSubject(Long vipGroupId);

    /**
     * 更新线上课老师的课酬
     * @param startDate
     * @param endDate
     * @return
     */
    void updateHistoryTeacherSalaryOfOnline(Date startDate, Date endDate);
}