Arquitetura

A aplicação é divida nos seguintes grupos de camada:

• Apresentação

• Aplicação

• Infraestrutura

As camadas são refletidas na organização do projeto através das pastas dentro de src:

Camada de Apresentação

• Projeto Presentation

• Padrão MVC (Model View Controller)

• As Views são pré-compiladas com a extensão RazorGenerator (mais sobre isso adiante) para ganho de performance

• Destaque para os itens:

  • Areas: contra o subprojeto da (controllers, views, scripts, css) da área administrativa, e também da API pública da plataforma (documentação aqui)

  • Controllers: código dos controllers da parte principal da plataforma (aquela acessada pelos usuários finais - compradores e vendedores)

  • Views: código das views da parte principal da plataforma

  • connstrings.config e appsettings.config: configurações do projeto, como Connection String (dados para conexão com o banco de dados) e outras chaves

Camada de Aplicação

• Projetos Application, V2.Application, Domain

• Concentram as regras de negócio da aplicação, através de classes de Domínio (models, entidades) e Serviço

• Definem também interfaces para os serviços de infraestrutura que são implementados nos projetos focados em infraestrutura. Essas interfaces são: envio de email, conexão com banco de dados, integração com gateway de pagamento, etc.

• Explicando os projetos separadamente:

  • Application: age como uma ponte entre a camada de Apresentação e as Entidades de Domínio. Contém também várias classes de serviço, que processam ações dos usuários, implementando assim os Casos de Uso da plataforma (ex. processamento de um pedido, conectando com gateway de pagamento, banco de dados e outros)

  • V2.Application: existe para auxiliar na refatoração de classes e serviços originais de Application. Novos serviços são criados em V2.Application, e serviços antigos de Application são migrados para a nova estrutura de forma gradativa

  • Domain: define as models e entidades centrais da plataforma (ex. classes de Vendedor, Comprador, Produto, Pedido, Orçamento, etc.)

    • Contém também as classes que representam a Configuração da plataforma (classes dentro da pasta Config), que ditam o funcionamento de toda a regra de negócio da plataforma.

    • Por fim, contém ainda as classes de DomainEvents, que representam os eventos gerados pela regra de negócio e que podem ser usados para disparar ações adicionais/efeitos colaterais de forma desacoplada (ex. quando um pedido é pago, a plataforma dispara um evento do tipo OrderStatusChangedEvent, que é capturado por outra classe para acionar o disparo de emails para o comprador e vendedor). Veja este artigo para saber mais sobre este conceito.

Camada de Infraestrutura

• Os principais projetos são Infrastructure, V2.Infrastructure e V2.Infrastructure.Boostrapper

• Os projetos dessa camada são todos voltados para a implementação de serviços que excedem a barreira física das classes de negócio, ou seja, que fazem algum tipo de IO (disco, APIs, banco de dados, etc.)

• As principais implementações são:

  • Repositórios, Queries e Acesso a Dados, também envio de emails (Infrastructure e V2.Infrastructure)

  • Configuração de Injeção de Dependências para todo o projeto (V2.Infrastructure.Bootstrapper)

  • Integração com armazenamento de arquivos em nuvem (CloudStorage)

  • Importação em massa de vendedores e produtos (BatchImport)

  • Integração com Correios (Infra.Crosscutting.Correios)

  • Mecanismo de busca inteligente (Infra.SmartSearchAdapter)

  • Integração com Gateways de Pagamento (PaymentIntegrator.Moip, PaymentIntegrator.PagarMe, NewIntegrator.Stripe)

Outros

RazorGenerator

Todos os detalhes sobre a extensão aparecem em sua página. Os pontos relevantes para o projeto são:

• Extensão que deve ser instalada diretamente no Visual Studio (ou neste link)

• Todas as views (arquivos .cshtml) devem ter a propriedade CustomTool definida para RazorGenerator

• Com isso, ao salvar o arquivo .cshtml, o Visual Studio gera automaticamente sua versão pré-compilada no arquivo de mesmo nome e extensão .generated.cs

• A extensão também conta com dois comandos que podem ser executados pelo PMC (Package Manager Console) para:

  • Definir automaticamente o CustomTool como RazorGenerator para todas as views do projeto (comando enable-razorgenerator)

  • Recompilar todas as views, forçando gerar/atualizar o arquivo .generated.cs para todas elas (comando redo-razorgenerator)

  • Mais sobre estes comandos no link

Voltar para o índice da documentação