marcospjms/store-api

Configuração inicial

Banco de dados

Para executar é necessário atualizar o application.properties. A seguinte propriedade deve ser atualizada para o arquivo que ficará seu banco de dados:

• spring.datasource.url=jdbc:h2:file:///home/marcos/testdb

Criar usuário inicial

Como o sistema foi construído usando spring boot security, para conseguir requisitar alguns recursos será necessário criar um usuário. Basta enviar um post para seguinte url:

• http://localhost:8080/api/public/users/

Deverá ser enviado um json com o username, password, name e email. Se for do interesse criar um admin, enviar a mesma requisição para:

• http://localhost:8080/api/public/users/admin

Essa url serve para facilitar a criação de usuário admin para fins de teste. Exemplos dessas requisições podem ser vistas na classe de teste CustomerPublicControllerTest.

Realizar login

Para realizar o login, basta enviar um post com username e password em formato json para url:

• http://localhost:8080/login

Com isso, um token será enviado. Nas requisições futuras deverá ser configurado o header Authentication com o "Bearer + token gerado"

Passos para execução

1. Criar pacote:

   1. mvn -f pom.xml clean package

2. Executar

   1. cd target
   2. a -jar store-api-0.0.1-SNAPSHOT.jar

3. Testar:

   1. mvn test

Visualizar a api

Com o projeto em execução, será possível visualizar a api a partir:

• http://localhost:8080/swagger-ui.html

Considerações sobre o desenvolvimento

Design

Evitei armazenar listas como atributos do modelo para facilitar a paginação. Por isso criei classes como ShoppingCartDiscount e ShoppingCartProduct, em vez de armazenar informações sobre os produtos e descontos dentro do ShoppingCart.

Testes

Tentei abranger os testes unitários de serviços e os dos controllers. Nesse último realizei requisições no ambiente de teste para verificar se as requisições estavam funcionando corretamente.

Porém, devido ao tempo, não criei todos os testes possíveis.