Attornatus

Avaliação técnica para desenvolvedor Backend Java na Attornatus

Desafio

Criar uma API Java com as seguintes características:

Uma Pessoa deve ter os seguintes campos:

Durante a implementação de uma nova funcionalidade de software solicitada, quais critérios você avalia e implementa para garantia de qualidade de software?

R: Avalio quais são os requisitos do cliente, o que essa funcionalidade se propõe a resolver e se a forma proposta é realmente a melhor maneira de solucionar o problema. Facilidade de uso da funcionalidade. Simplicidade na implementação, clareza no código e modularidade da funcionalidade vislumbrando futuras evoluções e facilidade de manutenção.

R: Desde a análise dos requisitos, concepção, desenvolvimento e manutenção. Procuro levar a qualidade de software em consideração em todos os momentos.

H2
A interface de usuário do banco de dados pode ser acessada em http://localhost:8080/h2
O respositório foi definido através de interface, o que permite utilizar o banco de dados que for mais conveniente e intercambiabilidade, sem prejudicar o funcionamento da API.

Foram criadas as classes Contact e Address com uma relação unidirecional de muitos endereços para um contato.
A relação foi definida na tabela de endereços porque manter a relação no objeto contido permite paginação e ordenação, evita inconsistências no banco de dados, melhorando performance e facilitando futuras evoluções da API. Também permite que um contato exista sem um endereço, mas um endereço não existe sem um contato.
Os identificadores dos objetos são do tipo UUID o que faz com que sejam únicos mesmo entre as classes contatos e endereços. Isso permite que os gerenciadores de cada classe possam ser separados em microserviços independentes, caso necessário.
Foi desenvolvido um CRUD para Contact e um para Address.
É possível definir um endereço primário durante a criação ou atualização de um endereço.
É possível listar o endereço primário ou todos os endereços de uma pessoa, mas por segurança, não é possível listar todos os endereços de todas as pessoas.
Pela pequena quantidade e simplicidade, os errors identificados foram tratados no próprio controller.
Foram realizados testes de integração em ContactController usando JUnit e RestAssured.

git clone https://github.com/pauloerico/attornatus

GET http://localhost:8080/contacts

POST http://localhost:8080/contacts

GET http://localhost:8080/contacts/{contactId}

PUT http://localhost:8080/contacts/{contactId}

DELETE http://localhost:8080/contacts/{contactId}

GET http://localhost:8080/contacts/{contactId}/addresses

POST http://localhost:8080/contacts/{contactId}/addresses

GET http://localhost:8080/contacts/{contactId}/primary-address

PUT http://localhost:8080/addresses/{addressId}

DELETE http://localhost:8080/addresses/{addressId}

{
    "name":"John Doe",
    "dateOfBirth":"1979-12-30"
}

{
    "street":"Rua dos Bobos",
    "number":0,
    "city":"São Paulo",
    "state":"SP",
    "cep":12345678,
    "primaryAddress":true
}