TKMaster.Common.Toolkit 1.0.9

TKMaster.Common.Toolkit

TKMaster.Common é uma biblioteca reutilizável desenvolvida para projetos em C#. Ela centraliza componentes comuns e utilitários que podem ser facilmente integrados em qualquer aplicação, promovendo reutilização, padronização e produtividade.

📦 Estrutura dos Projetos

Esta solução é composta por vários projetos do tipo Class Library, cada um com responsabilidades bem definidas:

🔹 Util

• Extensions: Métodos de extensão como GetDescription, GetTypeAttribute, e NotFound (com suporte a gênero).
• Mensagens e Responses: Utilitários para mensagens consistentes e respostas padronizadas.
• LoggerFactoryConfiguration: Configuração e personalização do sistema de logging.
• GlobalizationConfiguration: Suporte à internacionalização, com recursos de tradução e formatos regionais.

🔹 Domain

• Interfaces: Contratos de serviços e entidades.
• Services: Lógica de negócio reutilizável.
• Entities: Representações de dados e modelos base.
• Notifications: Sistema de notificações para regras de negócio e feedbacks.

🔹 Logger

• CustomLogger: Implementação de logger customizado.
• CustomLoggerProvider: Provedor adaptável para integração com diversos sistemas de log.
• CustomLoggerProviderConfiguration: Configurações ajustáveis para múltiplos ambientes.

⚙️ Funcionalidades Principais

✅ QueryHelper - Filtros e Ordenação Dinâmica

ApplyFilter<TFilter, TEntity>

Aplica filtros dinâmicos em uma consulta IQueryable<TEntity> usando um objeto TFilter. Apenas propriedades marcadas com [Filterable] são consideradas.

Características:

• Suporte a ==, >=, <=, Contains
• Intervalos com sufixos From e To
• Ignora propriedades nulas ou vazias

Exemplo:

var result = QueryHelper.ApplyFilter<CourseFilter, CourseEntity>(query, filter);

ApplySorting<T>

Aplica ordenação dinâmica com base na propriedade e direção informada (asc ou desc).

Exemplo:

var sorted = QueryHelper.ApplySorting<CourseEntity>(query, "Title", "desc");

💡 Extensões Incluídas

• NotFound(this string subject, bool isFeminine): Gera mensagens padronizadas com concordância de gênero.
• Diversos métodos utilitários para manipulação de strings, enums e expressões.

📦 Dependências Necessárias

dotnet add package System.Linq.Dynamic.Core

using TKMaster.Common.Util.Helpers;

🚀 Sugestões Futuras

• Suporte a List<int> e List<string> com Contains
• Combinação de filtros AND / OR
• Tradução de nomes de campos com [Filterable("Contains", Target = "Title,Description")]
• Integração com Swagger para exibição de filtros dinamicamente

🛠️ Tecnologias

📄 Licença

Este projeto é licenciado sob os termos da licença MIT. Consulte o arquivo LICENSE.txt para mais informações.