Skip to content

API Rest CRUD, utilizando arquitetura Hexagonal. Com várias tecnologias como: Docker, Testcontainers, Redis, PostgreSQL, Nginx e Spring Boot.

License

Notifications You must be signed in to change notification settings

hugarty/superhero

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Projeto feito em 4 dias para uma entrevista

Software é uma API Rest CRUD, utilizando arquitetura Hexagonal.

Contém as seguintes tecnologias:

  • Spring Boot
  • Docker e Docker compose para subir os vários containers da aplicação, responsável por reiniciar os containers caso algum tenha alguma falha.
  • Nginx como loadbalancer Round-robin, que envia as requisições para os containers de applicação.
  • PostgreSQL para armazenamento de dados.
  • Redis para armazenamento de Cache Distribuído.
  • Sistema de cache utilizando Redis e Spring Cache.
  • Testes unitário utilizando Mockito.
  • Testes de integração com Testcontainers - Para cada teste de integração um servidor PostgreSQL e Redis é iniciado, o schema é definido e valores padrões são inseridos.

Teste

Descrição

Um cliente chamado Bruce Wayne nos contratou para fazer um sistema com o objetivo de catalogar os super-heróis existentes.
Parece uma missão difícil, mas, não se preocupe, o seu papel não será o de sair por aí procurando por heróis, vamos deixar isso para o Sr. Wayne...
Seu papel é desenvolver uma API com as operações básicas de cadastro de um herói e algum mago (coff, coff) do front-end fará as telas.

Requisitos

Bom, aqui começa a explicação do que você terá que nos entregar. Leia com atenção.
Ah, o Alfred (acho que ele é tipo um mordono do Sr. Wayne) começou o projeto para nós e o esqueleto do projeto já existe.

Dito isso vamos deixar uma lista com as tarefas:

  • Criar endpoint de criação de heróis respeitando os campos obrigatórios. Olhe o script SQL dentro do projeto para saber quais são os campos obrigatórios.;
  • Criar endpoint de busca de heróis e seus atributos por ID. Caso não encontre o herói o sistema deve retornar um erro 404 (Not Found);
  • Criar endpoint de busca de heróis e seus atributos por filtro, nesse caso o filtro será apenas o nome. Caso não encontre nenhum herói o sistema deve retornar um sucesso 200 com o body vazio;
  • Criar endpoint de atualização de heróis, todos os campos poderão ser atualizados. Caso não encontre o herói o sistema deve retornar um erro 404 (Not Found);
  • Criar endpoint de exclusão de heróis. A exclusão será física, ok? (Física?! É, deleta o registro da base). Caso não encontre o herói o sistema deve retornar um erro 404 (Not Found);
  • Criar testes unitários e de integração das funcionalidades desenvolvidas. As classes de teste unitário terminam com o prefixo Test.java e as classes de teste de integração terminam com IT.java. Temos um modelo de classe de exemplo dentro do projeto;
  • Criar um docker-compose.yml funcional para execução da aplicação. (Banco de Dados + API).

Ah, tem algo mais! O Sr. Wayne nos pediu para criar um endpoint onde ele possa selecionar dois heróis e comparar seus atributos força, agilidade, destreza e inteligência. Como resultado, o sistema deve retornar um objeto contendo os id's e a diferença dos atributos (positivo se maior, negativo se menor) de cada herói. Dá uma pensada em como vai ficar esse objeto e o caminho do endpoint, tudo bem?

Agora sim, terminamos! Se você nos entregar isso que pedimos garanto que o Sr. Wayne vai pirar!!!

Considerações

Leia essas instruções para ganhar tempo no desenvolvimento, ok? ;)

Primeiro Passo

Como primeiro passo faça um fork desse projeto na sua conta do GitHub, se não tiver uma conta é só criar uma nova.
Não iremos avaliar provas que não estejam nesse padrão, então MUITA ATENÇÃO nessa dica.

Correção

Ao término da prova, abra um PR (Pull Request), é assim que iremos avaliar o código proposto.

Configurações

  • OpenJDK 17 instalado;
  • Maven na versão 3.8+ instalado;
  • IDE pode ser o de preferência, mas gostamos bastante do IntelliJ por aqui;
  • Docker e docker-compose instalados.

Testes

Para rodar os testes (unitários e de integração) utilize o comando a seguir:

mvn clean verify

Bônus

Será considerado um plus os candidatos que entregarem:

  • Bom uso dos padrões de REST;
  • Refatorar para Arquitetura Hexagonal/Clean Arch
  • Uso de BDD para escrever os testes de integração;
  • Redundância e Escalabilidade da API:
    • Mínimo de 2 instâncias;
    • Balanceamento de carga usando alguma técnica de Round Robin;
    • Endpoint de HealthCheck das máquinas;
    • (Opcional) Monitoramento das máquinas.
  • Cache Distribuído:
    • Utilizar algum mecanismo de cache distribuído na camada de banco de dados.

About

API Rest CRUD, utilizando arquitetura Hexagonal. Com várias tecnologias como: Docker, Testcontainers, Redis, PostgreSQL, Nginx e Spring Boot.

Resources

License

Stars

Watchers

Forks

Packages

No packages published