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.HrmAttendanceHolidayGroupRespVO; import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceHolidayPageReqVO; import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceHolidayRangeCreateReqVO; import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceHolidayRangeUpdateReqVO; 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 createReqVO 新增信息 * @return 新增的节假日数量 */ Integer createAttendanceHolidayRange(@Valid HrmAttendanceHolidayRangeCreateReqVO createReqVO); /** * 更新节假日配置 * * @param updateReqVO 更新信息 */ void updateAttendanceHoliday(@Valid HrmAttendanceHolidaySaveReqVO updateReqVO); /** * 按日期区间更新节假日配置:删除区间内原记录,再按新起止日期重新写入每一天 * * @param updateReqVO 更新信息 */ void updateAttendanceHolidayRange(@Valid HrmAttendanceHolidayRangeUpdateReqVO updateReqVO); /** * 按日期区间删除节假日配置(删除区间内全部记录) * * @param ids 区间内记录ID列表 */ void deleteAttendanceHolidayRange(List ids); /** * 删除节假日配置 * * @param id 节假日ID */ void deleteAttendanceHoliday(Long id); /** * 获得节假日配置 * * @param id 节假日ID * @return 节假日配置 */ HrmAttendanceHolidayDO getAttendanceHoliday(Long id); /** * 获得节假日配置分页 * * @param pageReqVO 分页查询参数 * @return 节假日配置分页 */ PageResult getAttendanceHolidayPage(HrmAttendanceHolidayPageReqVO pageReqVO); /** * 获得按连续日期区间合并后的节假日分页 * * 库里按自然日存储,列表侧按「日期连续 + 名称/类型/是否法定/备注一致」合并成一行展示。 * * @param pageReqVO 分页查询参数 * @return 合并后的节假日分页 */ PageResult getAttendanceHolidayGroupPage(HrmAttendanceHolidayPageReqVO pageReqVO); /** * 获得指定日期范围的节假日列表 * * @param startDate 开始日期 * @param endDate 结束日期 * @return 节假日列表 */ List getAttendanceHolidayListByDateRange(LocalDate startDate, LocalDate endDate); /** * 判断是否工作日 * * @param date 日期 * @return true-工作日,false-休息日 */ boolean isWorkDay(LocalDate date); }