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.HrmAttendanceRulePageReqVO;
|
import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceRuleSaveReqVO;
|
import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.HrmAttendanceRuleDO;
|
import jakarta.validation.Valid;
|
|
import java.util.List;
|
|
/**
|
* 考勤规则配置 Service 接口
|
*
|
* @author 超级管理员
|
*/
|
public interface HrmAttendanceRuleService {
|
|
/**
|
* 新增考勤规则
|
*
|
* @param createReqVO 新增信息
|
* @return 规则ID
|
*/
|
Long createAttendanceRule(@Valid HrmAttendanceRuleSaveReqVO createReqVO);
|
|
/**
|
* 更新考勤规则
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateAttendanceRule(@Valid HrmAttendanceRuleSaveReqVO updateReqVO);
|
|
/**
|
* 删除考勤规则
|
*
|
* @param id 规则ID
|
*/
|
void deleteAttendanceRule(Long id);
|
|
/**
|
* 获得考勤规则
|
*
|
* @param id 规则ID
|
* @return 考勤规则
|
*/
|
HrmAttendanceRuleDO getAttendanceRule(Long id);
|
|
/**
|
* 获得考勤规则分页
|
*
|
* @param pageReqVO 分页查询参数
|
* @return 考勤规则分页
|
*/
|
PageResult<HrmAttendanceRuleDO> getAttendanceRulePage(HrmAttendanceRulePageReqVO pageReqVO);
|
|
/**
|
* 获得启用的考勤规则列表
|
*
|
* @return 考勤规则列表
|
*/
|
List<HrmAttendanceRuleDO> getAttendanceRuleList();
|
|
/**
|
* 根据部门ID + 考勤日期获取生效的考勤规则
|
* 优先匹配部门规则，其次查找全局规则（deptId=null）；
|
* 同部门存在多条规则时，取「生效开始日期」最晚且覆盖该日期的那条。
|
*
|
* @param deptId 部门ID
|
* @param date 考勤日期（为空时按当天）
|
* @return 考勤规则
|
*/
|
HrmAttendanceRuleDO getAttendanceRuleByDeptId(Long deptId, java.time.LocalDate date);
|
|
/**
|
* 导入考勤规则（移植自新高电力）
|
*
|
* 按「规则名称」判重；已存在时需 updateSupport=true 才覆盖。
|
* 部门按名称匹配，部门为空表示全局规则。
|
*
|
* @param importList 导入的规则列表
|
* @param importReqVO 导入参数
|
* @return 导入结果
|
*/
|
cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceRuleImportRespVO importAttendanceRuleList(
|
List<cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceRuleImportExcelVO> importList,
|
cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.HrmAttendanceRuleImportReqVO importReqVO);
|
}
|
