package go.kr.project.system.loginLog.mapper;

import go.kr.project.system.loginLog.model.LoginLogSearchVO;
import go.kr.project.system.loginLog.model.LoginLogVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

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

/**
 * packageName    : go.kr.project.login.mapper
 * fileName       : LoginLogMapper
 * author         : 시스템 관리자
 * date           : 2025-05-13
 * description    : 로그인 로그 관련 데이터베이스 작업을 위한 매퍼 인터페이스
 * ===========================================================
 * DATE              AUTHOR             NOTE
 * -----------------------------------------------------------
 * 2025-05-13        시스템 관리자       최초 생성
 */
@Mapper
public interface LoginLogMapper {

    /**
     * 로그인 로그를 저장합니다.
     * 
     * @param loginLog 로그인 로그 정보
     * @return 저장된 행의 수
     */
    int insertLoginLog(LoginLogVO loginLog);

    /**
     * 로그인 로그를 조회합니다.
     * 
     * @param logId 로그 ID
     * @return 로그인 로그 정보
     */
    LoginLogVO selectLoginLog(String logId);

    /**
     * 조건에 맞는 로그인 로그 목록을 조회합니다.
     * 
     * @param paramVO 조회 조건
     * @return 로그인 로그 목록
     */
    List<LoginLogVO> selectLoginLogList(LoginLogSearchVO paramVO);

    /**
     * 조건에 맞는 로그인 로그 개수를 조회합니다.
     * 
     * @param paramVO 조회 조건
     * @return 로그인 로그 개수
     */
    int selectLoginLogCount(LoginLogSearchVO paramVO);

    /**
     * 특정 사용자의 최근 로그인 기록을 조회합니다.
     * 
     * @param userAcnt 사용자 계정
     * @param limit 조회할 기록 수
     * @return 최근 로그인 기록 목록
     */
    List<LoginLogVO> selectRecentLoginLogs(@Param("userAcnt") String userAcnt, @Param("limit") int limit);

    /**
     * 특정 기간 내 사용자의 로그인 실패 횟수를 조회합니다.
     * 
     * @param userAcnt 사용자 계정
     * @param startDttm 시작 시간
     * @return 로그인 실패 횟수
     */
    int selectLoginFailureCount(@Param("userAcnt") String userAcnt, @Param("startDttm") LocalDateTime startDttm);

    /**
     * 특정 사용자의 다른 디바이스에서의 로그인 기록을 조회합니다.
     * 
     * @param userAcnt 사용자 계정
     * @param deviceInfo 현재 디바이스 정보
     * @param startDttm 시작 시간
     * @return 다른 디바이스에서의 로그인 기록 목록
     */
    List<LoginLogVO> selectDifferentDeviceLogins(
            @Param("userAcnt") String userAcnt, 
            @Param("deviceInfo") String deviceInfo, 
            @Param("startDttm") LocalDateTime startDttm);

    /**
     * 특정 IP 주소에서의 로그인 시도 횟수를 조회합니다.
     * 
     * @param ipAddr IP 주소
     * @param startDttm 시작 시간
     * @return 로그인 시도 횟수
     */
    int selectLoginAttemptsByIp(@Param("ipAddr") String ipAddr, @Param("startDttm") LocalDateTime startDttm);

    /**
     * 디바이스 유형별 로그인 통계를 조회합니다.
     * 
     * @param params 조회 조건 (startDate, endDate 등)
     * @return 디바이스 유형별 로그인 횟수 맵
     */
    List<Map<String, Object>> selectDeviceTypeStats(Map<String, Object> params);

    /**
     * 로그인 성공/실패 비율 통계를 조회합니다.
     * 
     * @param params 조회 조건 (startDate, endDate 등)
     * @return 성공/실패 횟수 맵
     */
    List<Map<String, Object>> selectSuccessFailStats(Map<String, Object> params);

    /**
     * 시간대별 로그인 시도 통계를 조회합니다.
     * 
     * @param params 조회 조건 (startDate, endDate 등)
     * @return 시간대별 로그인 시도 횟수 맵
     */
    List<Map<String, Object>> selectHourlyLoginStats(Map<String, Object> params);
}
