namespace OrpaonVision.Core.Abstractions;

/// <summary>
/// 应用日志抽象，用于屏蔽日志实现细节。
/// </summary>
public interface IAppLogger
{
    /// <summary>
    /// 记录信息日志。
    /// </summary>
    /// <param name="message">日志消息。</param>
    /// <param name="traceId">可选链路标识。</param>
    void LogInformation(string message, string? traceId = null);

    /// <summary>
    /// 记录警告日志。
    /// </summary>
    /// <param name="message">日志消息。</param>
    /// <param name="traceId">可选链路标识。</param>
    void LogWarning(string message, string? traceId = null);

    /// <summary>
    /// 记录错误日志。
    /// </summary>
    /// <param name="message">日志消息。</param>
    /// <param name="exception">可选异常。</param>
    /// <param name="traceId">可选链路标识。</param>
    void LogError(string message, Exception? exception = null, string? traceId = null);
}