版本260406

OrpaonVision.Core/Audit/IAuditAppService.cs

@@ -0,0 +1,44 @@
+using OrpaonVision.Core.Results;
+using OrpaonVision.Core.Audit.Contracts;
+using OrpaonVision.Core.Audit.Contracts.Queries;
+
+namespace OrpaonVision.Core.Audit;
+
+/// <summary>
+/// 审计应用服务接口。
+/// </summary>
+public interface IAuditAppService
+{
+    /// <summary>
+    /// 记录审计日志。
+    /// </summary>
+    /// <param name="auditLog">审计日志详情。</param>
+    /// <param name="cancellationToken">取消令牌。</param>
+    /// <returns>操作结果。</returns>
+    Task<Result> LogAsync(AuditLogDetailDto auditLog, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 分页查询审计日志。
+    /// </summary>
+    /// <param name="query">查询条件。</param>
+    /// <param name="cancellationToken">取消令牌。</param>
+    /// <returns>分页结果。</returns>
+    Task<Result<PagedResult<AuditLogDetailDto>>> GetPagedListAsync(AuditLogQueryDto query, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 获取审计日志详情。
+    /// </summary>
+    /// <param name="auditLogId">审计日志ID。</param>
+    /// <param name="cancellationToken">取消令牌。</param>
+    /// <returns>审计日志详情。</returns>
+    Task<Result<AuditLogDetailDto>> GetDetailAsync(Guid auditLogId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 获取操作统计。
+    /// </summary>
+    /// <param name="startTime">开始时间（UTC）。</param>
+    /// <param name="endTime">结束时间（UTC）。</param>
+    /// <param name="cancellationToken">取消令牌。</param>
+    /// <returns>操作统计结果。</returns>
+    Task<Result<AuditStatisticsDto>> GetStatisticsAsync(DateTime startTime, DateTime endTime, CancellationToken cancellationToken = default);
+}