Biss.Solutions.MicroService.Template.Net9 1.0.0

Biss Solutions - Microservice Template (.NET 9)

Versão 1.0.0

✨ Introdução

Este template cria a estrutura base para um Microservice moderno em .NET 9, utilizando padrões e boas práticas de Clean Architecture, CQRS e Testes Unitários.

Projetado para ajudar desenvolvedores a criarem APIs escaláveis, seguras e bem organizadas rapidamente.

🏗️ Visão Geral da Solução

A solução é dividida em 5 camadas principais, seguindo os princípios de Clean Architecture:

📦 Camadas principais

• Api: Responsável por receber as requisições HTTP, aplicar validações iniciais e devolver as respostas formatadas.
• Application: Orquestra a lógica de negócios, gerencia Commands, Queries e utiliza padrões como CQRS e Mediator.
• Infrastructure: Implementa o acesso a dados e a comunicação com serviços externos (por exemplo: SQL Server via EF Core).
• Domain: Define as entidades de domínio, enums, interfaces e regras de negócio puras.
• CrossCutting: Contém utilitários e configurações compartilhadas entre todas as camadas (como injeções de dependência, logs, validações).

🛠️ Tecnologias e Bibliotecas Utilizadas

• .NET 9: Última versão do framework da Microsoft.
• Entity Framework Core (EF Core): Persistência de dados no banco de dados relacional (SQL Server).
• AutoMapper: Mapeamento automático entre objetos (DTOs e entidades).
• MediatR: Implementação do padrão Mediator para Commands e Queries.
• FluentValidation: Validação fluente de Requests.
• Swagger/OpenAPI: Documentação automática da API.
• HealthChecks: Monitoramento básico da saúde da API.
• Serilog: Logging estruturado com suporte a múltiplos sinks.
• XUnit e Moq: Testes unitários de infraestrutura, aplicação e API.

🚀 Recursos do Template

• Estrutura com suporte a CQRS (Command Query Responsibility Segregation).
• Clean Architecture organizada em camadas independentes.
• Logs estruturados para auditoria de requisições e exceções.
• Validação de entrada robusta com FluentValidation.
• Health Checks configurados para monitoramento de API.
• Swagger pronto para documentação de endpoints (com suporte a Accept-Language).
• Suporte a testes unitários usando XUnit e Moq.
• AutoMigrations aplicadas automaticamente no startup.
• Suporte a Localization (Accept-Language) para internacionalização.
• Cors já configurado para comunicação segura entre domínios.
• Template 100% compatível com o .NET CLI (dotnet new) e com o Visual Studio.

📦 Como Usar

Após instalar o template:

dotnet new biss-microservice-net9 -n MeuProjeto.Microservice

Isso criará um novo projeto com toda a estrutura pronta para uso.

📜 Notas da Versão 1.0.0

• Estruturação completa em Clean Architecture.
• Implementação de CQRS com MediatR.
• Suporte a validações com FluentValidation.
• Testes Unitários implementados para Infra, Application e API.
• Documentação de API via Swagger.
• Health Checks configurados.
• Logging estruturado com Serilog.

🧾 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para mais detalhes.

🔗 Informações Adicionais

Empresa: Biss Solutions Contato: contato@biss.com.br