TKMaster.Common.Toolkit 1.2.1

📦 Estrutura dos Projetos

Esta solução é composta por vários projetos do tipo Class Library, cada um com responsabilidades bem definidas e organizados em grupos lógicos na Solution:

🔹 Util

• Extensions: Métodos de extensão como GetDescription, GetTypeAttribute, e NotFound (com suporte a gênero).
• Mensagens e Responses:
  • Responses padronizados (ResponseSuccess<T>, ResponseFailure, ResponsePaged<T>) para unificar o retorno das APIs.
  • ResponseFactory para criação centralizada de respostas.
• LoggerFactoryConfiguration: Configuração e personalização do sistema de logging.
• GlobalizationConfiguration: Suporte à internacionalização, com recursos de tradução e formatos regionais.
• Dictionaries: Classe utilitária que fornece listas fixas (Dictionary<int, string>) para preenchimento de comboboxes e enums simulados no frontend (ex: status, meses, modalidades de curso etc).
• EmailServiceDependencyInjection: Método de extensão para facilitar o registro de serviços de envio de e-mail via IServiceCollection.

🔹 Domain

• Interfaces: Contratos de serviços, repositórios e entidades.
• RepositoryBase / IRepositoryBase: Implementação do padrão repositório genérico para facilitar o acesso e manipulação de dados com suporte a operações assíncronas.
• 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.
• Filters: Classe abstrata FilterBase.
• Email: Modelos de envio (GenericEmailModel) e configuração SMTP (EmailEntityModel), além do enum EmailType.

🔹 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.

🔹 Application

• Filters: Classe abstrata FilterBaseDTO.
• DTOs de Paginação: PaginationDTO<T> para retorno paginado no nível de aplicação.

🔹 Infrastructure.Email

• GenericEmailService: Implementação genérica de envio de e-mails via SmtpClient, com suporte a múltiplos tipos (EmailType), corpo HTML, anexos e configuração por injeção de dependência.

🔹 HTTP (TKMaster.Common.Http)

• BaseHttpService / IBaseHttpService: Serviço base para chamadas HTTP utilizando HttpClientFactory e retorno nos padrões de Responses.
• ResponseExtensionAPI: Métodos de extensão para simplificar o consumo de endpoints HTTP (ToResponse, ToResponseList, ToResponsePaged).
• ServiceCollectionExtensions: Método AddCommonHttpServices() para registrar o módulo HTTP e configurar IHttpClientFactory de forma centralizada.
• ResponseAPIConfig: Inicialização do ResponseExtensionAPI via injeção de dependência.

⚙️ 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>

Ordenação dinâmica baseada no nome da propriedade e direção (asc ou desc).

Exemplo:

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

📄 Responses Padronizados

• ResponseSuccess<T> → Retorno genérico com Data e flag de sucesso.
• ResponseFailure → Retorno para erros com lista de mensagens.
• ResponsePaged<T> → Retorno padronizado para dados paginados usando PaginationDTO<T>.
• ResponseFactory → Criação simplificada de Responses em Controllers.

Exemplo em Controller:

return ResponseFactory.Success(new UserDTO { Id = 1, Name = "Teste" });

📦 Pagination

• Pagination<T> → Uso interno no domínio para paginação genérica.
• PaginationDTO<T> → Retorno paginado em DTOs na camada Application.
• ResponsePaged<T> → Resposta HTTP unificando PaginationDTO<T> com status de sucesso.

🗂️ Repository Pattern

O projeto TKMaster.Common.Domain implementa repositório genérico (IRepositoryBase e RepositoryBase) com: - Métodos de busca (GetByCodeAsync, GetByNameAsync, SearchAsync) - Manipulação (ToAdd, ToUpdate, Remove) - Persistência (ToSaveAsync, SaveIdentityAsync)

💡 Extensões Incluídas

• NotFound(this string subject, bool isFeminine)
• Métodos utilitários para strings, enums e expressões
• Extensões para consumo HTTP com HttpClient e Responses padronizados

📦 Dependências Necessárias

dotnet add package System.Linq.Dynamic.Core

using TKMaster.Common.Util.Helpers;

🚀 Sugestões Futuras

• Suporte a filtros List<int> e List<string>
• Filtros compostos AND / OR
• Integração automática com Swagger para exibir metadados de filtros

🛠️ Tecnologias

📄 Licença

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