package com.gs.dingtalk.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.gs.dingtalk.entity.QwCheckinData;

import java.io.IOException;
import java.util.List;

/**
 * @description 针对表【QW_CHECKIN_DATA】企业微信打卡数据的数据库操作Service
 */
public interface QwCheckinDataService extends IService<QwCheckinData> {

    /**
     * 将CheckinData转换为QwCheckinData实体
     *
     * @param checkinData 企业微信打卡数据
     * @return QwCheckinData实体
     */
    QwCheckinData convertToEntity(WorkWXService.CheckinData checkinData);

    /**
     * 批量保存打卡数据（自动去重）
     *
     * @param checkinDataList 打卡数据列表
     * @return 新增记录数
     */
    int saveCheckinDataBatch(List<WorkWXService.CheckinData> checkinDataList);

    /**
     * 同步指定时间范围内的打卡数据到数据库
     *
     * @param startTime 开始时间（Unix时间戳）
     * @param endTime   结束时间（Unix时间戳）
     * @return 新增记录数
     * @throws IOException 获取打卡数据异常
     */
    int syncCheckinData(long startTime, long endTime) throws IOException;

    /**
     * 同步昨天的打卡数据到数据库
     *
     * @return 新增记录数
     * @throws IOException 获取打卡数据异常
     */
    int syncYesterdayCheckinData() throws IOException;
}