TL.AuditLogger 0.2.0

🛡️ TL.AuditLogger

Structured audit logging utility for .NET: automatic JSON property diff calculation, pluggable storage backends, and zero-leak event dispatching.
Biblioteca de auditoria estruturada para .NET: cálculo automático de diff diferencial JSON por propriedade, provedores plugáveis de armazenamento e despacho sem vazamento de memória.

O TL.AuditLogger fornece uma infraestrutura robusta e desacoplada para rastrear operações de alteração de estado (CRUD) em aplicações .NET. Ele captura o estado anterior e posterior das entidades, computa automaticamente o diferencial estruturado em JSON e despacha os registros para destinos de armazenamento configuráveis.

📦 Instalação

Adicione o pacote ao seu projeto através do .NET CLI:

dotnet add package TL.AuditLogger

🚀 Funcionalidades Principais

💡 Exemplos de Uso

1. Entidade com Proteção de Dados Sensíveis

using AuditLogger;

public class Usuario
{
    public int Id { get; set; }
    public string Nome { get; set; } = string.Empty;

    [SensitiveData]
    public string SenhaHash { get; set; } = string.Empty;

    public string Cpf { get; set; } = string.Empty; // Mascarado automaticamente por convenção heurística
}

2. Registro em Injeção de Dependência

using AuditLogger.DependencyInjection;

// No Program.cs
builder.Services.AddAuditLogger(builder.Configuration);

3. Configuração no appsettings.json

{
  "AuditLoggerSettings": {
    "StorageType": "Logger",
    "EnableHeuristicMasking": true,
    "DefaultMask": "***"
  }
}

4. Registro Estruturado com Cálculo Automático de Diff

using AuditLogger.Interfaces;

public class UsuarioService
{
    private readonly IAuditLogger _auditLogger;

    public UsuarioService(IAuditLogger auditLogger)
    {
        _auditLogger = auditLogger;
    }

    public async Task AtualizarUsuarioAsync(Usuario original, Usuario modificado, string usuarioId)
    {
        modificado.Nome = "Novo Nome";
        modificado.SenhaHash = "novo_hash_secreto";

        // SenhaHash e CPF são automaticamente mascarados como "***" no payload JSON
        Guid logId = await _auditLogger.LogUpdateAsync(original, modificado, usuarioId);
    }
}

🏛️ Decisões Arquiteturais e Segurança

Para detalhes sobre governança, ciclo de vida de instâncias e estratégias de isolamento de log:

• 📄 ADR-003: Decisões Arquiteturais do TL.AuditLogger

📄 Licença

Distribuído sob a licença MIT.