Nuuvify.CommonPack

Coleção de bibliotecas .NET para desenvolvimento de aplicações robustas, escaláveis e de alta performance.

🎉 Novidade! Agora com suporte completo a filtros dinâmicos com tipos complexos! Use propriedades de navegação como Customer.Address.City diretamente nos seus filtros. Ver exemplos ↓

✨ Características Principais

🚀 Performance e Escalabilidade

Async/Await em todas as operações I/O
Connection pooling otimizado para bancos de dados
Retry policies configuráveis com Polly
Caching inteligente com suporte a distribuído

🔒 Segurança

JWT Authentication com refresh tokens
Autenticação Azure AD integrada
Criptografia de dados sensíveis
Rate limiting e proteção contra ataques

📊 Observabilidade

Logging estruturado com Microsoft.Extensions.Logging
Health checks customizados
Métricas e telemetria
Distributed tracing pronto para produção

�️ Arquitetura

Clean Architecture e DDD patterns
SOLID principles aplicados
Dependency Injection nativa
Unit of Work e Repository patterns

🔍 Filtros Dinâmicos Avançados

Tipos complexos com navegação aninhada (Customer.Address.City)
Type-safe filters com attributes declarativos
Performance otimizada com compiled expressions
Operadores especializados (Contains, StartsWith, Range, etc.)
Validação automática de propriedades de navegação

🧪 Testabilidade

100% testável com mocks e fakes
InMemory providers para testes rápidos
Testcontainers para testes de integração
Separation of Concerns clara

🌐 Cloud-Native

Azure Service Bus para mensageria
Azure Storage para blobs e arquivos
Docker e Kubernetes ready
Health checks para orquestração

�🆕 Novidades

BackgroundService v2.0 - Diagnóstico Avançado

✨ Propriedades de diagnóstico contextuais para Dead Letter Queue e Abandon
🔧 Arquitetura modular refatorada com complexidade cognitiva reduzida
🔍 Troubleshooting aprimorado com metadados detalhados
📊 Observabilidade avançada para monitoramento e métricas

UnitOfWork - Dynamic Queries v3.0

🔍 Filtros com tipos complexos - Suporte a propriedades de navegação aninhadas
🎯 Notação de ponto (dot notation) - Ex: Customer.Address.City
⚡ Performance otimizada com compiled queries e parameterização EF Core
🛠️ Validação aprimorada - Detecção automática de propriedades aninhadas
📝 Documentação completa com exemplos de filtros complexos

Email - SMTP Service

📧 Envio via MailKit com templates HTML
📎 Anexos (file e stream)
👥 Múltiplos destinatários (To, Cc, Bcc)
🔄 Retry logic integrado

📦 Pacotes Disponíveis

Infraestrutura e Serviços

Pacote	Descrição	Versão	Downloads
Nuuvify.CommonPack.BackgroundService	🆕 Serviços de background com Azure Service Bus
Nuuvify.CommonPack.AzureServiceBus	Cliente para Azure Service Bus
Nuuvify.CommonPack.AzureServiceBus.Abstraction	Abstrações para Azure Service Bus
Nuuvify.CommonPack.AzureStorage	Cliente para Azure Storage
Nuuvify.CommonPack.AzureStorage.Abstraction	Abstrações para Azure Storage

Comunicação e Integração

Pacote	Descrição	Versão	Downloads
Nuuvify.CommonPack.StandardHttpClient	Cliente HTTP otimizado com retry e resiliência
Nuuvify.CommonPack.Email	Envio de e-mails via SMTP com MailKit
Nuuvify.CommonPack.Email.Abstraction	Abstrações para serviço de e-mail

Segurança

Pacote	Descrição	Versão	Downloads
Nuuvify.CommonPack.Security	Componentes de segurança e autenticação
Nuuvify.CommonPack.Security.Abstraction	Abstrações de segurança
Nuuvify.CommonPack.Security.JwtCredentials	Gerenciamento de credenciais JWT
Nuuvify.CommonPack.Security.JwtStore.Ef	Armazenamento de JWT com Entity Framework

Persistência de Dados

Pacote	Descrição	Versão	Downloads
Nuuvify.CommonPack.UnitOfWork	Implementação do padrão Unit of Work
Nuuvify.CommonPack.UnitOfWork.Abstraction	Abstrações do padrão Unit of Work
Nuuvify.CommonPack.Domain	Classes base para entidades de domínio
Nuuvify.CommonPack.AutoHistory	Auditoria automática de entidades

Entity Framework Exceptions

Pacote	Descrição	Versão	Downloads
Nuuvify.CommonPack.EF.Exceptions.Common	Tratamento de exceções EF Core comum
Nuuvify.CommonPack.EF.Exceptions.Db2	Tratamento de exceções para IBM DB2
Nuuvify.CommonPack.EF.Exceptions.Oracle	Tratamento de exceções para Oracle

Middleware e APIs

Pacote	Descrição	Versão	Downloads
Nuuvify.CommonPack.Middleware	Middlewares customizados para ASP.NET Core
Nuuvify.CommonPack.Middleware.Abstraction	Abstrações de middlewares
Nuuvify.CommonPack.OpenApi	Configurações OpenAPI/Swagger
Nuuvify.CommonPack.HealthCheck	Health checks customizados

Extensões e Utilitários

Pacote	Descrição	Versão	Downloads
Nuuvify.CommonPack.Extensions	Métodos de extensão e Notification Pattern

📚 Documentação

Cada pacote possui documentação detalhada em seu respectivo diretório:

Infraestrutura e Serviços

📚 BackgroundService - 🆕 Com diagnóstico avançado
📚 AzureServiceBus
📚 AzureServiceBus.Abstraction
📚 AzureStorage
📚 AzureStorage.Abstraction

Comunicação e Integração

📚 StandardHttpClient
📚 Email - Envio de e-mails via SMTP
📚 Email.Abstraction

Segurança

Persistência de Dados

📚 UnitOfWork - Com queries dinâmicas
📚 UnitOfWork.Abstraction - ✨ Com filtros complexos
📚 Domain
📚 AutoHistory

Entity Framework Exceptions

Middleware e APIs

Extensões e Utilitários

📚 Extensions - Notification Pattern e extensões

Exemplos

📚 Samples - Exemplos práticos de uso
📚 OrderProcessingWorker - Worker com Azure Service Bus

🚀 Início Rápido

Instalação

# Unit of Work com Entity Framework
dotnet add package Nuuvify.CommonPack.UnitOfWork

# Cliente HTTP com resiliência
dotnet add package Nuuvify.CommonPack.StandardHttpClient

# Envio de e-mails
dotnet add package Nuuvify.CommonPack.Email

# Segurança e JWT
dotnet add package Nuuvify.CommonPack.Security

# Background services com Azure Service Bus
dotnet add package Nuuvify.CommonPack.BackgroundService

Exemplo Básico - Unit of Work

// Configuração no Program.cs
builder.Services.AddNuuvifyDbContext<MyDbContext>(
    builder.Configuration.GetConnectionString("DefaultConnection"));

// Uso no serviço
public class ProductService
{
    private readonly IUnitOfWork _unitOfWork;

    public ProductService(IUnitOfWork unitOfWork)
    {
        _unitOfWork = unitOfWork;
    }

    public async Task<Product> CreateProductAsync(Product product)
    {
        await _unitOfWork.Repository<Product>().AddAsync(product);
        await _unitOfWork.SaveChangesAsync();
        return product;
    }

    public async Task<IEnumerable<Product>> GetActiveProductsAsync()
    {
        return await _unitOfWork.Repository<Product>()
            .Where(p => p.IsActive)
            .OrderBy(p => p.Name)
            .ToListAsync();
    }
}

Exemplo Avançado - Filtros Dinâmicos com Tipos Complexos

// Modelo de filtro com propriedades de navegação
public class OrderFilterModel : IQueryableCustom
{
    // Filtro simples
    [QueryOperator(WhereOperator.GreaterThanOrEqualTo)]
    public decimal? MinTotal { get; set; }

    // Filtros com tipos complexos usando notação de ponto
    [QueryOperator(WhereOperator.Contains, HasName = "Customer.Name", CaseSensitive = false)]
    public string CustomerName { get; set; }

    [QueryOperator(WhereOperator.Equals, HasName = "Customer.Address.City")]
    public string City { get; set; }

    [QueryOperator(WhereOperator.ContainsWithLikeForList, HasName = "Items.Product.Category", CaseSensitive = false)]
    public List<string> ProductCategories { get; set; }

    // Filtro aninhado de múltiplos níveis
    [QueryOperator(WhereOperator.GreaterThan, HasName = "Customer.Profile.CreatedDate")]
    public DateTime? CustomerSince { get; set; }
}

// Uso do serviço com filtros complexos
public class OrderService
{
    private readonly IUnitOfWork _unitOfWork;

    public async Task<IPagedList<Order>> GetFilteredOrdersAsync(OrderFilterModel filter)
    {
        return await _unitOfWork.Repository<Order>()
            .Filter(filter)  // ✨ Aplica automaticamente todos os filtros
            .OrderByDescending(o => o.OrderDate)
            .GetPagedListAsync(pageIndex: 1, pageSize: 20);
    }

    // SQL gerado automaticamente:
    // WHERE Orders.Total >= @p0
    //   AND UPPER(Customer.Name) LIKE '%' + UPPER(@p1) + '%'
    //   AND Customer.Address.City = @p2
    //   AND (Items.Product.Category LIKE '%' + @p3 + '%' OR Items.Product.Category LIKE '%' + @p4 + '%')
    //   AND Customer.Profile.CreatedDate > @p5
}

// Exemplo de uso
var filter = new OrderFilterModel
{
    MinTotal = 100.00m,
    CustomerName = "João",
    City = "São Paulo",
    ProductCategories = new List<string> { "Electronics", "Computers" },
    CustomerSince = DateTime.Now.AddYears(-2)
};

var orders = await orderService.GetFilteredOrdersAsync(filter);

Exemplo Básico - Email

// Configuração no appsettings.json
{
  "EmailConfig": {
    "EmailServerConfiguration": {
      "ServerHost": "smtp.gmail.com",
      "Port": 587,
      "Security": "StartTls",
      "AccountUserName": "seu-email@gmail.com",
      "AccountPassword": "sua-senha"
    }
  }
}

// Configuração no Program.cs
builder.Services.AddScoped<IEmail, Email>();
builder.Services.Configure<EmailServerConfiguration>(
    builder.Configuration.GetSection("EmailConfig:EmailServerConfiguration"));

// Uso no serviço
public class NotificationService
{
    private readonly IEmail _emailService;

    public async Task SendWelcomeEmailAsync(string email, string name)
    {
        var recipients = new Dictionary<string, string> { { email, name } };
        var senders = new Dictionary<string, string> { { "noreply@empresa.com", "Empresa" } };

        await _emailService.EnviarAsync(
            recipients: recipients,
            senders: senders,
            subject: "Bem-vindo!",
            message: $"<h1>Olá {name}!</h1><p>Seja bem-vindo à nossa plataforma.</p>"
        );
    }
}

Exemplo Básico - HTTP Client

// Configuração no Program.cs
builder.Services.AddStandardHttpClient<MyApiClient>(options =>
{
    options.BaseAddress = "https://api.example.com";
    options.Timeout = TimeSpan.FromSeconds(30);
    options.RetryCount = 3;
});

// Uso no serviço
public class MyApiClient
{
    private readonly HttpClient _httpClient;

    public MyApiClient(HttpClient httpClient)
    {
        _httpClient = httpClient;
    }

    public async Task<Product> GetProductAsync(int id)
    {
        return await _httpClient.GetFromJsonAsync<Product>($"/products/{id}");
    }
}

🧪 Testes

✅ Recentemente corrigido: Problemas de ObjectDisposedException em testes foram resolvidos com gerenciamento adequado do ciclo de vida do EF Core.

O projeto possui uma estratégia de testes abrangente com 12 projetos de teste cobrindo todos os pacotes principais:

Projetos de Teste Disponíveis

Projeto de Teste	Tipo	Descrição
Nuuvify.CommonPack.UnitOfWork.InMemory.xTest	Unit	Testes unitários com InMemory provider
Nuuvify.CommonPack.UnitOfWork.Integration.xTest	Integration	Testes de integração com SQL Server (Docker)
Nuuvify.CommonPack.Extensions.xTest	Unit	Testes de extensões e Notification Pattern
Nuuvify.CommonPack.Email.xTest	Unit	Testes do serviço de e-mail
Nuuvify.CommonPack.Security.xTest	Unit	Testes de segurança e JWT
Nuuvify.CommonPack.StandardHttpClient.xTest	Unit	Testes do cliente HTTP
Nuuvify.CommonPack.BackgroundService.xTest	Unit	Testes de background services
Nuuvify.CommonPack.AzureServiceBus.xTest	Unit	Testes de Azure Service Bus
Nuuvify.CommonPack.AzureStorage.xTest	Unit	Testes de Azure Storage
Nuuvify.CommonPack.Middleware.xTest	Unit	Testes de middlewares
Nuuvify.CommonPack.HealthCheck.xTest	Unit	Testes de health checks
Nuuvify.CommonPack.Domain.xTest	Unit	Testes de entidades de domínio

Testes Unitários (InMemory)

Foco: Velocidade e feedback rápido

⚡ Rápidos: Execução em < 1 segundo
💚 Leves: Usa EF Core InMemory provider
✅ CI/CD Friendly: Sem dependências externas (não requer Docker)
🎯 Uso: TDD, desenvolvimento rápido, validação de lógica de negócio

# Executar todos os testes unitários
dotnet test --filter "Category=Unit"

# Executar testes de um projeto específico
dotnet test test/Nuuvify.CommonPack.Extensions.xTest

Testes de Integração (SQL Server via Docker)

Foco: Fidelidade e validação real

🐘 SQL Server Real: Usa Testcontainers com SQL Server 2022
✅ Alta Fidelidade: Testa queries SQL específicas e collations
⚠️ Requer Docker: Docker Desktop deve estar em execução
🎯 Uso: Validação de features específicas do SQL Server, testes de regressão

# Executar testes de integração (requer Docker)
dotnet test --filter "Category=Integration"

# Executar projeto específico de integração
dotnet test test/Nuuvify.CommonPack.UnitOfWork.Integration.xTest

Executar Todos os Testes

# Executar todos os testes
dotnet test

# Executar com cobertura de código
dotnet test /p:CollectCoverage=true /p:CoverletOutputFormat=opencover

# Executar com relatório detalhado
dotnet test --logger "console;verbosity=detailed"

📖 Documentação Completa: Integration Tests README

Comparação Rápida

Aspecto	Unit (InMemory)	Integration (SQL Server)
Velocidade	⚡ < 1s	🐢 2-4s
Requisitos	✅ Nenhum	⚠️ Docker
Fidelidade	⚠️ Simulado	✅ SQL Real
CI/CD	✅ Sempre	⚠️ Depende do Docker
Cobertura	🎯 Lógica	🎯 Infraestrutura
Feedback	🚀 Instantâneo	⏱️ Alguns segundos

Estratégia de Testes Recomendada

Durante o desenvolvimento: Use testes unitários (InMemory) para feedback rápido
Antes do commit: Execute todos os testes unitários
Antes do merge: Execute testes de integração com Docker
Pipeline CI/CD: Execute ambos em paralelo quando possível

Cobertura de Código

O projeto mantém alta cobertura de código:

Testes Unitários: > 80% de cobertura
Testes de Integração: Valida cenários críticos
SonarCloud: Análise contínua de qualidade

🤝 Contribuindo

Contribuições são bem-vindas! Veja como você pode ajudar:

Como Contribuir

Fork o repositório
Clone seu fork: git clone https://github.com/seu-usuario/Nuuvify.CommonPack.git
Crie uma branch: git checkout -b feature/minha-feature
Faça suas alterações seguindo as convenções do projeto
Execute os testes: dotnet test
Commit suas mudanças: git commit -m 'feat: adiciona nova feature'
Push para a branch: git push origin feature/minha-feature
Abra um Pull Request

Convenções

✅ Conventional Commits: Use commits semânticos (feat, fix, docs, etc.)
✅ EditorConfig: Siga as regras do .editorconfig
✅ Testes: Escreva testes para novas funcionalidades
✅ Documentação: Atualize o README quando necessário
✅ Code Review: Aguarde aprovação antes do merge

Diretrizes de Código

Siga os princípios SOLID
Escreva código limpo e legível
Adicione comentários onde necessário
Mantenha alta cobertura de testes
Use async/await para operações I/O

Configuração de Credenciais Git

Se você receber o erro abaixo ao tentar fazer push, significa que há credenciais de outra conta em cache:

remote: Permission to nuuvify/Nuuvify.CommonPack.git denied to usuario_anterior.
fatal: unable to access 'https://github.com/nuuvify/Nuuvify.CommonPack.git/': The requested URL returned error: 403

1. Configure o usuário local do repositório:

git config --local user.name "lzocateli"
git config --local user.email "lzocateli@outlook.com"

2. Troque o remote para HTTPS (se estiver usando SSH):

git remote set-url origin https://github.com/nuuvify/Nuuvify.CommonPack.git

3. Liste e remova credenciais antigas do Windows:

# Listar credenciais relacionadas ao GitHub
cmdkey /list | Select-String -Pattern "github"

# Remover cada entrada encontrada (ajuste o target conforme listado)
cmdkey /delete:git:https://github.com

4. Limpe também pelo Git Credential Manager:

# Cole as 3 linhas abaixo e pressione Enter duas vezes
git credential reject
protocol=https
host=github.com

5. Se houver credenciais persistentes no Gerenciador de Credenciais do Windows:

Pressione Win + R → digite control /name Microsoft.CredentialManager → Enter
Clique em Credenciais do Windows
Localize entradas com github no nome (ex: GitHub for Visual Studio - https://usuario_anterior@github.com/)
Clique na entrada e depois em Remover

6. (Opcional) Se usar GitHub CLI:

gh auth logout
gh auth login
# Selecione: GitHub.com → HTTPS → Autentique no navegador com a conta correta

7. Faça o push — o Git Credential Manager abrirá o navegador para autenticar:

git push origin sua-branch

⚠️ Dica: Certifique-se de estar logado no GitHub com a conta correta (lzocateli) antes de autorizar no navegador. Se o navegador abrir já logado com outra conta, faça logout no GitHub primeiro.

8. Confirme que está tudo certo:

# Verificar configuração local
git config user.name
git config user.email

# Se usar gh cli
gh auth status

📊 Status do Projeto

🔗 Links Úteis

Documentação e Recursos

📦 Pacotes NuGet
📋 Changelog - 🆕 Filtros com tipos complexos!
📖 Wiki
💡 Samples e Exemplos

Desenvolvimento

🐛 Issues
🔄 Pull Requests
🚀 Releases
📊 SonarCloud

Comunidade

💬 Discussions
📧 Email
🌐 Website

📄 Licença

Este projeto está licenciado sob a MIT License.

👥 Autores e Colaboradores

Desenvolvido e mantido pela equipe Nuuvify.

Agradecimentos especiais a todos os colaboradores que ajudaram a tornar este projeto melhor!

Nuuvify CommonPack - Construindo soluções robustas para .NET 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 402 Commits
.config		.config
.devcontainer		.devcontainer
.github		.github
.husky		.husky
.vscode		.vscode
Images		Images
Nuget.CustomManagement		Nuget.CustomManagement
RestClient		RestClient
Samples		Samples
pipelines		pipelines
src		src
test		test
.cz.toml		.cz.toml
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
Nuuvify.CommonPack.sln		Nuuvify.CommonPack.sln
Readme.md		Readme.md
azurepipelines-coverage.yml		azurepipelines-coverage.yml
global.json		global.json
pull_request_template.md		pull_request_template.md

Folders and files

Latest commit

History

Repository files navigation

Nuuvify.CommonPack

✨ Características Principais

🚀 Performance e Escalabilidade

🔒 Segurança

📊 Observabilidade

�️ Arquitetura

🔍 Filtros Dinâmicos Avançados

🧪 Testabilidade

🌐 Cloud-Native

�🆕 Novidades

BackgroundService v2.0 - Diagnóstico Avançado

UnitOfWork - Dynamic Queries v3.0

Email - SMTP Service

📦 Pacotes Disponíveis

Infraestrutura e Serviços

Comunicação e Integração

Segurança

Persistência de Dados

Entity Framework Exceptions

Middleware e APIs

Extensões e Utilitários

📚 Documentação

Infraestrutura e Serviços

Comunicação e Integração

Segurança

Persistência de Dados

Entity Framework Exceptions

Middleware e APIs

Extensões e Utilitários

Exemplos

🚀 Início Rápido

Instalação

Exemplo Básico - Unit of Work

Exemplo Avançado - Filtros Dinâmicos com Tipos Complexos

Exemplo Básico - Email

Exemplo Básico - HTTP Client

🧪 Testes

Projetos de Teste Disponíveis

Testes Unitários (InMemory)

Testes de Integração (SQL Server via Docker)

Executar Todos os Testes

Comparação Rápida

Estratégia de Testes Recomendada

Cobertura de Código

🤝 Contribuindo

Como Contribuir

Convenções

Diretrizes de Código

Configuração de Credenciais Git

📊 Status do Projeto

🔗 Links Úteis

Documentação e Recursos

Desenvolvimento

Comunidade

📄 Licença

👥 Autores e Colaboradores

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages