Este projeto é uma prova de aptidão realizada pela Ewave do Brasil (ver issue) Este projeto é a Livraria To-Do. Um projeto de uma livraria utilizando Asp.NET Core, com EntityFramework e utilizando arquitetura DDD (Domain-Driven Design).
Ela foi construída por Leonardo Sena, e pode ser encontrado no Github para download.
O projeto foi divido em três camadas, Presentation (views, arquivos estáticos e controllers), Application (serviços, view models e mensagens para o usuário) e por fim, Data (entidades, o mapeamento destas, repositórios, contexto e migrations). Estas camadas seguem os princípios do DDD, com a informação navegando da view, para os serviços, para os repositórios, e finalmente chegando ao banco de dados.
A aplicação é bem simples, e constitui de quatro cadastros com a finalidade do usuário ter uma lista de livros para pesquisar por titulo e autor. O usuario primeiramente cadastra as editoras, autores e categorias, e em seguida, utiliza estas informações para cadastrar os livros.
A aplicação de apresentação utiliza bootstrap 4.0, vue.js para realizar o two-way databind no componente da grade de livros e nos componentes que populam os elementos de select no cadastro de livros. Por fim, todos os arquivos estáticos estão utilizando cache para melhor desempenho. O Vue foi escolhido pela sua simplicidade e tamanho reduzido, atendendo a necessidade básica de realizar o binding com os elementos com pouco código javascript. E por fim, também foi criado um componente para enviar a imagem com a capa do livro para o servidor.
A aplicação de serviços constitui no meio-termo entre as controllers e os repositórios, utilizando de uma DTO (data transfer object) para transportar essas informações dos repositórios para as controllers na primeira camada.
Por fim, a aplicação de dados utiliza de classes para realizar o mapeamento das tabelas com o EntityFramework. E disponibiliza repositórios para serem utilizados pelas camadas superiores, por meio de interfaces. Foi criado um repositório base para centralizar os métodos mais utilizados pelos repositórios, para atender os princípios do DRY (don't repeat yourself).
Uma prévia da aplicação pode ser encontrada no endereço: https://e-topic-291313.appspot.com/
Sobre os requerimentos do projeto:
- .NET Core. A aplicação foi toda desenvolvida utilizando .NET Core.
- Testes de Unidade: A solução possui um projeto com testes unitários das controllers criadas pela aplicação.
- Conteinerização: A aplicação funciona em docker. Apesar de não conseguir realizar todas as configurações, ela levanta no docker desktop e se comunica com um banco em conteiner no Google Cloud. Ela também pode ser publicada em um container em kubernetes do Google Clouds, mas esbarrei em um problema dop cabeçalho encriptados dos requests de login não serem aceitos entre o container do banco e da aplicação, e apesar de ter tentado algumas soluções para corrigir, acredito que apenas mudando o tipo do container no google (flex) para uma maquina virtual resolve este problema.
- REST: A aplicação possui endpoints REST.
- Serviços de Cache: A aplicação utiliza-se de três tipos de cacheamento. Cacheamento de views, de respostas e de memória (IMemoryCache da Microsoft).
- Kubernetes: A aplicação roda em um containers em kubernetes no Google Cloud.
- DDD: A aplicação foi arquitetada utilizando a estrutura DDD.
- CQRS: A aplicação utiliza a arquitetura CQRS em um dos seus serviços, que centraliza a conexão com mais de um repositório para devolver dados de ambos em uma única resposta aos endpoints.
O que ficou pendente (TO-DO):
- Mensageria, também por falta de tempo. Mas penso em implementar um chat para usuários conversarem entre si utilizando a biblioteca SignalR da microsoft, assim como criar notificações para os usuários de novos livros e lembretes de quando um livro que alugaram está perto da data de devolução. Este tipo de notificação pode ser criado facilmente consultando o registro de livros emprestados e comparando com a data de devolução dos mesmos.
- Frontend em angular. Eu cheguei a criar o projeto do front-end, mas não conseguiria entregar algo apresentável no tempo que foi dado.
Dificuldades:
ERROR: (gcloud.app.deploy) Error Response: [8] The region northamerica-northeast1 does not have enough resources available to fulfill the request. Please try again later. Failed to deploy project BibliotecaVirtual to App Engine Flex.