package com.zsElectric.boot.system.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.zsElectric.boot.system.model.entity.SecurityEventLog;
import com.zsElectric.boot.system.model.query.SecurityEventLogPageQuery;
import com.zsElectric.boot.system.model.vo.SecurityEventLogPageVO;

/**
 * 安全事件日志服务。
 *
 * @author zsElectric
 */
public interface SecurityEventLogService extends IService<SecurityEventLog> {

    /**
     * 记录安全事件。
     *
     * <p>调用方负责判断事件是否需要记录；本方法只负责统一落库并保证记录失败不影响主业务。</p>
     *
     * @param eventLog 安全事件日志
     * @return 是否记录成功
     */
    boolean record(SecurityEventLog eventLog);

    /**
     * Page security event logs.
     *
     * @param queryParams query params
     * @return security event log page
     */
    Page<SecurityEventLogPageVO> getSecurityEventLogPage(SecurityEventLogPageQuery queryParams);
}