namespace Service.Interface
{
    /// <summary>
    /// 审计日志记录器：业务服务注入后一行代码记录关键操作（操作人/角色自动取自当前登录上下文）
    /// </summary>
    public interface IAuditRecorder
    {
        /// <summary>
        /// 记录一条审计日志
        /// </summary>
        /// <param name="operationType">操作类型（Create/Update/Delete/Login/Command等）</param>
        /// <param name="operationTarget">操作对象（IotDevice/Gateway/User/Role等）</param>
        /// <param name="targetId">操作对象Id</param>
        /// <param name="deviceId">关联设备Id（0=无关）</param>
        /// <param name="oldValue">操作前值（JSON 或摘要）</param>
        /// <param name="newValue">操作后值（JSON 或摘要）</param>
        /// <param name="ip">操作IP（null 自动留空）</param>
        /// <param name="description">操作描述</param>
        Task RecordAsync(string operationType, string operationTarget, long targetId,
            long deviceId = 0, string? oldValue = null, string? newValue = null,
            string? ip = null, string? description = null);
    }
}