Credit Application System - Kotlin API Rest

Prof. Camila Cavalcante

---

API Rest para um Sistema de Analise de Solicitação de Crédito

Uma empresa de empréstimo precisa criar um sistema de análise de solicitação de crédito. Sua tarefa será criar uma API REST SPRING BOOT E KOTLIN 🍃💜 para a empresa fornecer aos seus clientes as seguintes funcionalidades:

Instrução de Uso

No Terminal/Console:

1. Faça um clone do projeto na sua máquina: git clone git@github.com:bianavic/credit-application-system.git
2. Entre na pasta raiz do projeto: cd
3. Execute o comando: ./gradlew bootrun

POSTMAN - JSON Collection

• Cliente (Customer):

  • Cadastrar:
    1. Request: firstName, lastName, cpf, income, email, password, zipCode e street
    2. Response: String
  • Editar cadastro:
    1. Request: id, firstName, lastName, income, zipCode, street
    2. Response: firstName, lastName, income, cpf, email, income, zipCode, street
  • Visualizar perfil:
    1. Request: id
    2. Response: firstName, lastName, income, cpf, email, income, zipCode, street
  • Deletar cadastro:
    1. Request: id
    2. Response: sem retorno

• Solicitação de Empréstimo (Credit):

  • Cadastrar:
    1. Request: creditValue, dayFirstOfInstallment, numberOfInstallments e customerId
    2. Response: String
  • Listar todas as solicitações de emprestimo de um cliente:
    1. Request: customerId
    2. Response: creditCode, creditValue, numberOfInstallment
  • Visualizar um emprestimo:
    1. Request: customerId e creditCode
    2. Response: creditCode, creditValue, numberOfInstallment, status, emailCustomer e incomeCustomer

  
  Diagrama UML Simplificado de uma API para Sistema de Avaliação de Crédito

  
  Arquitetura em 3 camadas Projeto Spring Boot

  Regras de Negócio para a solicitação de empréstimo:

  1. o máximo de parcelas permitido será 48
  2. data da primeira parcela deverá ser no máximo 3 meses após o dia atual

  ---

  Code Coverage Report

  

  ---

  Links Úteis

  • https://start.spring.io/#!type=gradle-project&language=kotlin&platformVersion=3.2.2-SNAPSHOT&packaging=jar&jvmVersion=17&groupId=org.edu&artifactId=credit-application-system&name=credit-application-system&description=Credit%20Application%20System%20with%20Spring%20Boot%20and%20Kotlin&packageName=org.edu.credit-application-system&dependencies=web,validation,data-jpa,flyway,h2
  • https://docs.spring.io/spring-boot/docs/2.0.x/reference/html/common-application-properties.html
  • https://medium.com/cwi-software/versionar-sua-base-de-dados-com-spring-boot-e-flyway-be4081ddc7e5
  • https://strn.com.br/artigos/2018/12/11/todas-as-anota%C3%A7%C3%B5es-do-jpa-anota%C3%A7%C3%B5es-de-mapeamento/
  • https://pt.wikipedia.org/wiki/Objeto_de_Transfer%C3%AAncia_de_Dados
  • https://pt.wikipedia.org/wiki/CRUD
  • https://docs.spring.io/spring-data/jpa/docs/current/reference/html/#repository-query-keywords
  • https://docs.spring.io/spring-data/jpa/docs/current/reference/html/#jpa.query-methods.at-query
  • https://docs.spring.io/spring-data/jpa/docs/current/reference/html/#glossary

  ---

  Troubleshooting

  [Credit Repository Test - solved]

  EntityExistsException and PersistentObjectException: detached entity passed to persist

  • change persist to merge to merge the detached objects in the session

  FROM:
  customer = testEntityManager.persist(CustomerStub.buildCustomer())
  TO:
  customer = testEntityManager.merge(CustomerStub.buildCustomer())

  link: https://stackoverflow.com/questions/23645091/spring-data-jpa-and-hibernate-detached-entity-passed-to-persist-on-manytomany-re
  
  [Controller Tests - gambiarra] post, find and update methods AssertionError: JSON path "$.id" expected: X but was: Y

  The tests are failing when run together because the ID values are changing between runs. This is due to the nature of the @GeneratedValue strategy used in Hibernate, where the ID is auto-generated and may not always start from 1. obs: @TestMethodOrder, @TestInstance and @BeforeEach @AfterEach annotations did not work, the same error still remains

  • change .value(1L) to .exists()

  FROM:
  .andExpect(MockMvcResultMatchers.jsonPath("$.id").value(1L))
  TO:
  .andExpect(MockMvcResultMatchers.jsonPath("$.id").exists())