package com.xiaopeng.maintenance.service;

import com.xiaopeng.api.model.maintenance.XpClockIn;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xiaopeng.common.core.domain.R;
import com.xiaopeng.common.core.web.page.PageInfo;
import com.xiaopeng.maintenance.dto.*;
import com.xiaopeng.maintenance.vo.ClockInStatisticsDetailsVo;
import com.xiaopeng.maintenance.vo.ClockInStatisticsVo;
import org.springframework.web.bind.annotation.RequestBody;

import javax.servlet.http.HttpServletResponse;
import java.time.LocalDate;

/**
 * <p>
 * 打卡明细 服务类
 * </p>
 *
 * @author mitao
 * @since 2026-02-03
 */
public interface IXpClockInService extends IService<XpClockIn> {

    /**
     * 验证打卡范围
     *
     * @param dto
     * @return
     */
    Boolean verifyRange(VerifyRangeDTO dto);

    /**
     * 打卡
     *
     * @param dto
     * @return
     */
    R<Integer> clockIn(ClockDTO dto);

    /**
     * 下班打卡
     *
     * @param dto
     * @return
     */
    R<Integer> clockOut(ClockDTO dto);

    /**
     * 补充上班缺卡记录
     *
     * @param appUserId 用户ID
     * @param shiftId 班次ID
     * @param attendanceDate 考勤日期
     * @return 是否新增成功
     */
    boolean createMissingClockInIfAbsent(Long appUserId, Long shiftId, LocalDate attendanceDate);

    /**
     * 检查用户是否上班中
     * @param appUserId 用户ID
     * @return true=上班中(只打了上班卡), false=未上班或已下班
     */
    Integer checkWorkStatus(Long appUserId);


    /**
     * 获取打卡统计
     * @param query
     * @return
     */
    PageInfo<ClockInStatisticsDto> getClockInStatistics(ClockInStatisticsVo query);


    /**
     * 导出打卡统计
     * @param vo
     * @param response
     */
    void exportClockInStatistics(ClockInStatisticsVo vo, HttpServletResponse response);



    /**
     * 获取打卡统计详情
     * @param query
     * @return
     */
    GetClockInStatisticsDetailsDto getClockInStatisticsDetails(ClockInStatisticsDetailsVo query);


    /**
     * 导出打卡统计详情
     * @param vo
     * @param response
     */
    void exportClockInStatisticsDetails(ClockInStatisticsDetailsVo vo, HttpServletResponse response);
}