版本260406

OrpaonVision.Core/Abstractions/IAppLogger.cs

@@ -0,0 +1,29 @@
+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);
+}