namespace YY.Admin.Services.Service.Jeecg;

/// <summary>
/// Jeecg 登录日志上报服务（WebSocket + HTTP + 本地离线队列）。
/// </summary>
public interface IJeecgLoginLogReportService
{
    /// <summary>
    /// 启动后台离线日志补传循环（可重复调用，内部幂等）。
    /// </summary>
    void StartBackgroundSync();

    /// <summary>
    /// 上报一次登录日志；网络不可达时自动落本地，联网后自动补传。
    /// </summary>
    Task ReportLoginAsync(string account, bool success, string message, CancellationToken cancellationToken = default);

    /// <summary>
    /// 上报通用日志（操作/异常/告警等），自动走 WS/HTTP/本地队列兜底。
    /// </summary>
    Task ReportLogAsync(
        string category,
        string message,
        string? account = null,
        bool? success = null,
        string? exception = null,
        CancellationToken cancellationToken = default);
}