/**
 * @ProjectName: 智慧评标-主观分助手
 * @Package: com.zhpb.gdyd_zhpb_zgf.service
 * @ClassName: UserLogService
 * @Description: 用户操作日志服务接口
 * @Author: 
 * @Date: 2025-11-28
 * @Version: 1.0
 * @Copyright: © 2025 智慧评标-主观分助手
 */
package com.zhpb.gdyd_zhpb_zgf.service;

import com.zhpb.gdyd_zhpb_zgf.entity.mysql.UserLog;
import jakarta.servlet.http.HttpServletRequest;
import java.util.List;

/**
 * 用户操作日志服务接口
 */
public interface UserLogService {

    /**
     * 记录用户操作日志
     *
     * @param userId 用户ID
     * @param userName 用户名
     * @param projectId 项目ID
     * @param operationType 操作类型
     * @param operationDetail 操作详情
     * @param relatedId 关联ID
     * @param request HTTP请求对象（用于获取IP地址和User-Agent）
     */
    void logUserOperation(String userId, String userName, String projectId, 
                         String operationType, String operationDetail, 
                         String relatedId, HttpServletRequest request);

    /**
     * 记录用户操作日志（简化版）
     *
     * @param userId 用户ID
     * @param userName 用户名
     * @param operationType 操作类型
     * @param operationDetail 操作详情
     * @param request HTTP请求对象
     */
    void logUserOperation(String userId, String userName, 
                         String operationType, String operationDetail, 
                         HttpServletRequest request);

    /**
     * 根据用户ID查询操作日志
     *
     * @param userId 用户ID
     * @return 操作日志列表
     */
    List<UserLog> getUserLogsByUserId(String userId);

    /**
     * 根据项目ID查询操作日志
     *
     * @param projectId 项目ID
     * @return 操作日志列表
     */
    List<UserLog> getUserLogsByProjectId(String projectId);

    /**
     * 根据操作类型查询操作日志
     *
     * @param operationType 操作类型
     * @return 操作日志列表
     */
    List<UserLog> getUserLogsByOperationType(String operationType);

    /**
     * 根据用户ID和操作类型查询操作日志
     *
     * @param userId 用户ID
     * @param operationType 操作类型
     * @return 操作日志列表
     */
    List<UserLog> getUserLogsByUserIdAndOperationType(String userId, String operationType);

    /**
     * 统计指定用户的操作次数
     *
     * @param userId 用户ID
     * @return 操作次数
     */
    Long countUserOperations(String userId);

    /**
     * 统计指定操作类型的次数
     *
     * @param operationType 操作类型
     * @return 操作次数
     */
    Long countOperationsByType(String operationType);
}