Lambda.Core.LogNotificator 1.0.6

Lambda.Core.LogNotificator

Lambda.Core.LogNotificator é um pacote NuGet para facilitar o registro estruturado de logs e notificações em aplicações .NET, com suporte a repositórios de persistência e integração com padrões de correlação de logs (Correlation ID).

📦 Instalação

Via NuGet Package Manager:

Install-Package Lambda.Core.LogNotificator

Via .NET CLI:

dotnet add package Lambda.Core.LogNotificator

✅ Funcionalidades

• Registro de logs estruturados com níveis: Debug, Information, Warning e Error.
• Correlação de logs via Correlation ID.
• Registro de notificações categorizadas: Informações, Alertas e Erros.
• Persistência de logs utilizando ILogRepository com suporte a transações.
• Serviço central NotificationLogService para registrar notificações como logs.
• Implementação do padrão Unit of Work para controle de transações.

📂 Estrutura de Classes

Entities

• Log: Representa um log estruturado.
• Notification: Representa uma notificação categorizada (Informação, Alerta, Erro).

Interfaces

• ILoggerProvider: Interface para abstração de provedores de log.
• ILogRepository: Interface para persistência de logs.
• INotificator: Interface para gerenciamento de notificações.

Repositories

• LogRepository: Implementação de ILogRepository utilizando IUnitOfWork para persistência transacional dos logs.

Services

• LoggerProvider: Implementação padrão de ILoggerProvider, escreve logs no console e suporta Correlation ID.
• NotificationLogService: Serviço para converter notificações em logs persistentes.
• Notificator: Implementação padrão de INotificator, gerencia notificações em memória.

🚀 Exemplo de Uso

// Instanciar o Notificator
var notificator = new Notificator();

// Adicionar notificações
notificator.AddInformation("INFO001", "Processo concluído com sucesso.");
notificator.AddWarning("WARN001", "Limite de tentativas quase atingido.");
notificator.AddError("ERR001", "Falha ao processar solicitação.");

// Instanciar o LogRepository com UnitOfWork
var unitOfWork = new UnitOfWork(connection);
var logRepository = new LogRepository(unitOfWork);

// Criar o NotificationLogService
var notificationLogService = new NotificationLogService(notificator, logRepository);

// Registrar notificações como logs
await notificationLogService.RegistrarNotificacoesInformationsAsync();
await notificationLogService.RegistrarNotificacoesWarnings();
await notificationLogService.RegistrarNotificacoesErrors();

🛠️ Dependências

• Dapper para execução de comandos SQL.
• IUnitOfWork para controle transacional.
• Banco de dados relacional com tabela Logs com colunas: Message, MessageTemplate, Level, TimeStamp, Exception, Properties, LogEvent.

📝 Tabela de Logs (SQL)

CREATE TABLE Logs (
    Id INT PRIMARY KEY IDENTITY,
    Message NVARCHAR(MAX),
    MessageTemplate NVARCHAR(MAX),
    Level NVARCHAR(50),
    TimeStamp DATETIMEOFFSET,
    Exception NVARCHAR(MAX),
    Properties NVARCHAR(MAX),
    LogEvent NVARCHAR(100)
);

🎯 Principais Benefícios

✅ Facilidade para estruturar logs e notificações.
✅ Integração simples com qualquer sistema de persistência.
✅ Padronização de logs com correlação de eventos.
✅ Flexível e extensível via injeção de dependência.

⚖️ Licença

Este projeto é distribuído sob a licença MIT.

🙌 Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para abrir Issues ou enviar Pull Requests.

👤 Autor

Desenvolvido por [Marcelo P. Matos].