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.HrmAttendanceRecordPageReqVO;
import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.HrmAttendanceRecordDO;
import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.HrmAttendanceExceptionDO;
import jakarta.validation.Valid;

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.List;

/**
 * 考勤记录 Service 接口
 *
 * @author 芋道源码
 */
public interface HrmAttendanceRecordService {

    /**
     * 获得考勤记录分页
     */
    PageResult<HrmAttendanceRecordDO> getAttendanceRecordPage(HrmAttendanceRecordPageReqVO pageReqVO);

    /**
     * 获得考勤记录
     */
    HrmAttendanceRecordDO getAttendanceRecord(Long id);

    /**
     * 获取员工指定日期范围的考勤记录
     */
    List<HrmAttendanceRecordDO> getAttendanceRecordListByUserIdAndDateBetween(Long userId, String startDate, String endDate);

    /**
     * 获取员工指定日期的考勤记录
     */
    HrmAttendanceRecordDO getAttendanceRecordByUserIdAndDate(Long userId, LocalDate date);

    /**
     * 打卡（上班打卡）
     *
     * @param userId 员工ID
     * @param clockTime 打卡时间
     * @param location 打卡地点
     * @return 考勤记录
     */
    HrmAttendanceRecordDO clockIn(Long userId, LocalDateTime clockTime, String location);

    /**
     * 打卡（下班打卡）
     *
     * @param userId 员工ID
     * @param clockTime 打卡时间
     * @param location 打卡地点
     * @return 考勤记录
     */
    HrmAttendanceRecordDO clockOut(Long userId, LocalDateTime clockTime, String location);

    /**
     * 补卡审批通过后更新考勤记录
     *
     * @param exception 考勤异常申请
     */
    void supplementClockIn(HrmAttendanceExceptionDO exception);

}