package jnpf.attendance.service; import jnpf.base.UserInfo; import jnpf.base.service.SuperService; import jnpf.entity.attendance.AttendanceClockInResult; import jnpf.entity.attendance.FtbAttendanceClockIn; import jnpf.entity.attendance.FtbAttendanceDailyRule; import jnpf.exception.HandleException; import jnpf.exception.QueryException; import jnpf.model.attendance.dto.ClockInDto; import jnpf.model.attendance.model.DayClockRange; import jnpf.model.attendance.vo.*; import jnpf.model.attendance.vo.attendance.ClockInExportVo; import jnpf.model.common.DateRangeDto; import org.apache.commons.lang3.tuple.MutablePair; import java.util.Date; import java.util.List; import java.util.Map; import java.util.concurrent.CompletableFuture; /** * 打卡服务 * * @author yanwenfu * @create 2023-11-21 */ public interface AttendanceClockInService extends SuperService { /** * 打卡 - 主页 * @param today 日期 * @param userInfo 用户信息 * @param isMainInfo 是否打卡主页(1: 是, 0: 否) * @return java.util.List */ List getClockInMainInfo(Date today, UserInfo userInfo, Integer isMainInfo) throws Exception; /** * 打卡 * * @param clockInDto 打卡信息 * @return org.apache.commons.lang3.tuple.MutablePair
left:打卡结果状态, right:打卡结果id */ MutablePair clockIn(ClockInDto clockInDto) throws Exception; /** * 更新打卡记录 * @param clockInDto 更新内容 * @param clockInId 打卡记录id * @return org.apache.commons.lang3.tuple.MutablePair
left:打卡结果状态, right:打卡结果id */ MutablePair updateClockIn(String clockInId, ClockInDto clockInDto) throws Exception; /** * 判断本次是否外出打卡 * @param rule 考勤规则 * @param clockInType 上/下班打卡 * @return boolean */ boolean getOutsideCheck(AttendanceRuleVo rule, Integer clockInType); /** * 变更出勤规则[批量] * @param userDayList 用户日期列表 * @param user 操作人 */ void changeAttendanceRuleBatch(List userDayList, UserInfo user); /** * 查询出勤规则 * @param ruleId 出勤规则id * @return jnpf.model.attendance.vo.AttendanceRuleVo */ AttendanceRuleVo getAttendanceRule(String ruleId) throws HandleException; /** * 查询出勤规则[批量] * @param ruleIds 出勤规则ids * @return java.util.Map */ Map getAttendanceRuleBatch(List ruleIds); /** * 查询考勤组信息 * @param today 日期 * @param groupId 考勤组id * @param selfGroupInt 是否自己的考勤组 * @param userInfo 当前登陆用户 * @return jnpf.model.attendance.vo.GroupInfoVo */ GroupInfoVo getGroupInfo(Date today, String groupId, int selfGroupInt, UserInfo userInfo) throws QueryException; /** * 查询考勤组信息 * @param today 日期 * @param groupId 考勤组id * @param selfGroupInt 是否自己的考勤组 * @param userInfo 当前登陆用户 * @param isMainInfo 是否主页进入 * @return jnpf.model.attendance.vo.GroupInfoVo */ GroupInfoVo getGroupInfo(Date today, String groupId, int selfGroupInt, UserInfo userInfo, Integer isMainInfo) throws QueryException; /** * 查询考勤组出勤规则 * @param groupId 考勤组id * @param userId 用户id * @return jnpf.model.attendance.vo.GroupRuleVo */ GroupRuleVo getGroupRule(String groupId, String userId); /** * 能否补卡 * @param day 日期 * @param clockInResult 出勤结果 * @param approvalStatus 审批状态 * @param groupRule 考勤组规则 * @return org.apache.commons.lang3.tuple.MutablePair */ MutablePair couldRepairRecord(Date day, AttendanceClockInResult clockInResult, Integer approvalStatus, GroupRuleVo groupRule) throws Exception; /** * 根据日期查询考勤组信息 * @param today 日期 * @param userInfo 当前登陆用户 * @return jnpf.model.attendance.vo.GroupInfoVo */ GroupInfoVo getGroupInfoByDate(Date today, UserInfo userInfo) throws QueryException; /** * 外勤打卡 * @param approvalCode 审批code * @param tenantId 租户id * @param clockInId 打卡id */ void outsideClockIn(String approvalCode, String tenantId, String clockInId) throws Exception; /** * 外勤打卡审批(通过/不通过/撤回) * @param applyId 审批id * @param passed 是否通过(0: 否, 1: 是, 2: 撤回) * @param userInfo 当前登录人 */ void approvalOutsideClockIn(String applyId, String passed, UserInfo userInfo) throws Exception; /** * 异常打卡审批(通过/不通过/撤回) * @param applyId 审批id * @param passed 是否通过(0: 否, 1: 是, 2: 撤回) * @param userInfo 当前登录人 */ void approvalUnusualPhoneClockIn(String applyId, String passed, UserInfo userInfo) throws Exception; /** * 补卡 * @param applyId 审批id * @param passed 是否通过(0: 否, 1: 是, 2: 撤回) * @param tenantId 租户ID */ void repairClockIn(String applyId, String passed, String approveUserId, String tenantId) throws Exception; /** * 执行缺卡逻辑 * @param tenantId 租户id * @return java.lang.Boolean */ Boolean generateFtbAbsenceRecord(String tenantId); /** * 生成上班前打卡提醒 * @param tenantId 租户id * @return java.lang.Boolean */ Boolean generateBeforeWorkRemind(String tenantId); /** * 异步处理缺卡 * @param tenantId 租户id * @param conditionList 需要执行的任务 * @param now 当前时间 */ CompletableFuture asyncDeal(String tenantId, String hashKey, List conditionList, String now); /** * 可选择的补卡列表 * @param userId 用户id * @return java.util.List */ List getRepairList(String userId) throws Exception; /** * 查询每日出勤及打卡记录 * @param userId 用户id * @param queryDate 查询日期 * @param currentGroupId 当前考勤组 * @return java.util.List */ List getDailyClockInRecord(String userId, String queryDate, String currentGroupId); /** * 出勤变更 * @param applyId 申请id * @param passed 是否通过(0: 否, 1: 是, 2: 撤回) * @param approveUserId 审批人id * @param tenantId 租户ID */ void attendanceChange(String applyId, String passed, String approveUserId, String tenantId) throws HandleException; /** * 出勤变更(不审批) * @param clockInResultId 打卡结果id * @param changeType 变更类型(1: 变更为旷工, 2: 撤销旷工, 3: 变更为正常, 4: 补卡) */ void attendanceChangeNoApproval(String clockInResultId, Integer changeType) throws HandleException; /** * 查询每日出勤及打卡记录 - v2 * @param userId 用户id * @param queryDate 查询日期 * @param currentGroupId 当前考勤组id * @param queryOldData 查看原始数据(1: 是, 0: 否) * @return jnpf.model.attendance.vo.DailyInfoVo */ DailyInfoVo getDailyClockInRecordV2(String userId, String queryDate, String currentGroupId, Integer queryOldData) throws QueryException; /** * 获取班次时间 * @param rule 出勤规则 * @param workStatus 上/下班 * @return java.lang.String */ String getShiftTimeStr(FtbAttendanceDailyRule rule, int workStatus); /** * 生成补卡次数 * @return java.lang.Boolean */ Boolean generateRepairNum(); /** * 生成用户补卡次数记录 * @param groupId 考勤组id * @param userId 用户id * @param generateType 生成类型(1: 新增组成员, 2: 借调到新组) * @return java.lang.Boolean */ Boolean generateRepairNumForUser(String groupId, String userId, Integer generateType); /** * 判断考勤组是否可以补卡 * @param groupId 考勤组id * @return jnpf.model.attendance.vo.RepairRuleVo */ RepairRuleVo getClockInRepairCheck(String groupId); /** * 生成全面维修编号 * 本方法旨在生成一个全面的维修编号，该编号用于唯一标识一次维修事件或记录 * 它可能涉及到复杂的逻辑，如数据库查询、序列生成或其他策略，以确保编号的唯一性和连续性 * * @return Boolean 表示维修编号是否成功生成true表示成功，false表示失败 */ Boolean generateRepairNumAll(); /** * 查询每日出勤及打卡记录 * @param userId 用户id * @param clockRecord 查询日期范围 */ List getDailyClockInRecord(String userId, DayClockRange clockRecord); /** * 判定连续动作(排班/旷工) * @param tenantId 租户id * @return java.lang.Boolean */ Boolean continuousCheck(String tenantId); /** * 获取当前考勤组排班 * @param today 日期 * @param userInfo 日期 */ List getCurrentDailyRuleListOfWithdraw(Date today, UserInfo userInfo); /** * 获取当前时间段内考勤组排班 */ List getCurrentDailyRuleListOfDay(DateRangeDto dateRangeDto, List usersByGroupVos); /** * 生成打卡旷工任务 * @param flag 是否删除redisKey重新生成(1: 是, 0: 否) * @param tenantId 租户id * @return java.lang.Boolean */ Boolean generateAbsenceTask(Integer flag, String tenantId); /** * 查询考勤组审批列表 * @param queryDto 查询条件 * @return java.util.List */ List getGroupApprovalList(ApprovalQueryDto queryDto); }