package cn.iocoder.yudao.module.hrm.service.attendance;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceHolidayImportExcelVO;
|
import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceHolidayImportReqVO;
|
import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceHolidayImportRespVO;
|
import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceHolidayPageReqVO;
|
import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceHolidaySaveReqVO;
|
import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.HrmAttendanceHolidayDO;
|
import jakarta.validation.Valid;
|
|
import java.time.LocalDate;
|
import java.util.List;
|
|
/**
|
* 考勤节假日配置 Service 接口
|
*
|
* @author 超级管理员
|
*/
|
public interface HrmAttendanceHolidayService {
|
|
/**
|
* 新增节假日配置
|
*
|
* @param createReqVO 新增信息
|
* @return 节假日ID
|
*/
|
Long createAttendanceHoliday(@Valid HrmAttendanceHolidaySaveReqVO createReqVO);
|
|
/**
|
* 更新节假日配置
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateAttendanceHoliday(@Valid HrmAttendanceHolidaySaveReqVO updateReqVO);
|
|
/**
|
* 删除节假日配置
|
*
|
* @param id 节假日ID
|
*/
|
void deleteAttendanceHoliday(Long id);
|
|
/**
|
* 获得节假日配置
|
*
|
* @param id 节假日ID
|
* @return 节假日配置
|
*/
|
HrmAttendanceHolidayDO getAttendanceHoliday(Long id);
|
|
/**
|
* 获得节假日配置分页
|
*
|
* @param pageReqVO 分页查询参数
|
* @return 节假日配置分页
|
*/
|
PageResult<HrmAttendanceHolidayDO> getAttendanceHolidayPage(HrmAttendanceHolidayPageReqVO pageReqVO);
|
|
/**
|
* 获得指定日期范围的节假日列表
|
*
|
* @param startDate 开始日期
|
* @param endDate 结束日期
|
* @return 节假日列表
|
*/
|
List<HrmAttendanceHolidayDO> getAttendanceHolidayListByDateRange(LocalDate startDate, LocalDate endDate);
|
|
/**
|
* 判断是否工作日
|
*
|
* @param date 日期
|
* @return true-工作日，false-休息日
|
*/
|
boolean isWorkDay(LocalDate date);
|
|
/**
|
* 导入节假日配置列表
|
*
|
* @param importList 导入列表
|
* @param importReqVO 导入请求参数
|
* @return 导入结果
|
*/
|
HrmAttendanceHolidayImportRespVO importAttendanceHolidayList(List<HrmAttendanceHolidayImportExcelVO> importList,
|
HrmAttendanceHolidayImportReqVO importReqVO);
|
|
}
|
