klp-oa/klp-system/src/main/java/com/klp/system/service/ISysOperLogService.java

package com.klp.system.service;

import com.klp.common.core.domain.PageQuery;
import com.klp.common.core.page.TableDataInfo;
import com.klp.system.domain.SysOperLog;
import com.klp.system.domain.bo.OperPerformanceQuery;
import com.klp.system.domain.vo.OperMenuGroupVO;
import com.klp.system.domain.vo.OperModuleStatVO;
import com.klp.system.domain.vo.OperPersonVO;
import com.klp.system.domain.vo.OperSummaryVO;

import java.util.List;

/**
 * 操作日志 服务层
 *
 * @author Lion Li
 */
public interface ISysOperLogService {

    TableDataInfo<SysOperLog> selectPageOperLogList(SysOperLog operLog, PageQuery pageQuery);

    /**
     * 新增操作日志
     *
     * @param operLog 操作日志对象
     */
    void insertOperlog(SysOperLog operLog);

    /**
     * 查询系统操作日志集合
     *
     * @param operLog 操作日志对象
     * @return 操作日志集合
     */
    List<SysOperLog> selectOperLogList(SysOperLog operLog);

    /**
     * 批量删除系统操作日志
     *
     * @param operIds 需要删除的操作日志ID
     * @return 结果
     */
    int deleteOperLogByIds(Long[] operIds);

    /**
     * 查询操作日志详细
     *
     * @param operId 操作ID
     * @return 操作日志对象
     */
    SysOperLog selectOperLogById(Long operId);

    /**
     * 清空操作日志
     */
    void cleanOperLog();

    /**
     * 绩效概览统计
     */
    OperSummaryVO selectPerformanceSummary(OperPerformanceQuery query);

    /**
     * 人员绩效列表（含模块明细）
     */
    List<OperPersonVO> selectPersonPerformance(OperPerformanceQuery query);

    /**
     * 模块使用排行
     */
    List<OperModuleStatVO> selectModuleRanking(OperPerformanceQuery query);

    /**
     * 按菜单分组绩效统计（oper_page 匹配一级菜单 path）
     */
    List<OperMenuGroupVO> selectMenuGroupPerformance(OperPerformanceQuery query);
}