dongzi/AI-Check-Test
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

commit
Some checks failed
API接口参数变更检测 / api-param-check (push) Has been cancelled
Details

Browse Source
This commit is contained in:
东子
2026-06-05 16:18:40 +08:00
parent 1ca34c6bb2
commit 3cba3bb74e
4393 changed files with 450030 additions and 103 deletions
Download Patch File Download Diff File Expand all files Collapse all files

306
jnpf-ftb/jnpf-ftb-biz/src/main/java/jnpf/attendance/service/AttendanceClockInService.java Normal file
View File

@@ -0,0 +1,306 @@
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<FtbAttendanceClockIn> {
/**
* 打卡 - 主页
* @param today 日期
* @param userInfo 用户信息
* @param isMainInfo 是否打卡主页(1: 是, 0: 否)
* @return java.util.List<jnpf.model.attendance.vo.GroupInfoVo>
*/
List<GroupInfoVo> getClockInMainInfo(Date today, UserInfo userInfo, Integer isMainInfo) throws Exception;
/**
* 打卡
*
* @param clockInDto 打卡信息
* @return org.apache.commons.lang3.tuple.MutablePair <br> left:打卡结果状态, right:打卡结果id
*/
MutablePair<Integer, String> clockIn(ClockInDto clockInDto) throws Exception;
/**
* 更新打卡记录
* @param clockInDto 更新内容
* @param clockInId 打卡记录id
* @return org.apache.commons.lang3.tuple.MutablePair <br> left:打卡结果状态, right:打卡结果id
*/
MutablePair<Integer, String> 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<UserDayVo> 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<java.lang.String,jnpf.model.attendance.vo.AttendanceRuleVo>
*/
Map<String, AttendanceRuleVo> getAttendanceRuleBatch(List<String> 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<java.util.Date, java.util.Date>
*/
MutablePair<Date, Date> 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<Void> asyncDeal(String tenantId, String hashKey, List<AbsenceClockInVo> conditionList, String now);
/**
* 可选择的补卡列表
* @param userId 用户id
* @return java.util.List<jnpf.model.attendance.vo.GroupRepairVo>
*/
List<GroupRepairVo> getRepairList(String userId) throws Exception;
/**
* 查询每日出勤及打卡记录
* @param userId 用户id
* @param queryDate 查询日期
* @param currentGroupId 当前考勤组
* @return java.util.List<jnpf.model.attendance.vo.MiniGroupVo>
*/
List<MiniGroupVo> 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<FtbAttendanceClockIn> getDailyClockInRecord(String userId, DayClockRange clockRecord);
/**
* 判定连续动作(排班/旷工)
* @param tenantId 租户id
* @return java.lang.Boolean
*/
Boolean continuousCheck(String tenantId);
/**
* 获取当前考勤组排班
* @param today 日期
* @param userInfo 日期
*/
List<FtbAttendanceDailyRule> getCurrentDailyRuleListOfWithdraw(Date today, UserInfo userInfo);
/**
* 获取当前时间段内考勤组排班
*/
List<FtbAttendanceDailyRule> getCurrentDailyRuleListOfDay(DateRangeDto dateRangeDto, List<ClockInExportVo> 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<jnpf.model.attendance.vo.GroupApprovalVo>
*/
List<GroupApprovalVo> getGroupApprovalList(ApprovalQueryDto queryDto);
}