package org.dromara.crm.service;

import org.dromara.crm.domain.vo.CrmQuoteShareLogVo;

import java.util.List;
import java.util.Map;

/**
 * 报价单分享访问日志Service接口
 *
 * @author 系统管理员
 * @date 2025-10-05
 */
public interface ICrmQuoteShareLogService {

    /**
     * 记录访问日志
     *
     * @param quoteId   报价单ID
     * @param shareCode 分享码
     * @param ipAddress IP地址
     * @param userAgent 用户代理
     * @return 是否成功
     */
    Boolean recordVisit(Long quoteId, String shareCode, String ipAddress, String userAgent);

    /**
     * 查询指定报价单的访问日志
     *
     * @param quoteId 报价单ID
     * @return 访问日志列表
     */
    List<CrmQuoteShareLogVo> queryLogsByQuoteId(Long quoteId);

    /**
     * 统计指定报价单的访问数据
     *
     * @param quoteId 报价单ID
     * @return 统计数据(总访问次数、独立IP数、最近访问时间等)
     */
    Map<String, Object> statisticsVisits(Long quoteId);

}