https://github.com/lucasplopes/case-creditas

https://github.com/lucasplopes/case-creditas

Last synced: 10 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/lucasplopes/case-creditas
• Owner: LucasPLopes
• Created: 2025-08-20T09:37:22.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2025-08-20T09:38:38.000Z (10 months ago)
• Last Synced: 2025-08-20T11:41:30.245Z (10 months ago)
• Language: Java
• Size: 2.68 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# API de Simulação e Proposta

## Visão Geral

Este projeto consiste em dois serviços principais: Simulação e Proposta, que trabalham em conjunto para fornecer funcionalidades de simulação de financiamento e criação de propostas.

## Documentação da API

![](img/swagger.png)

### Endpoints de Simulação

#### POST /service--simulacao/v1/simulacoes

Cria uma nova simulação de financiamento.

Request Body:

json

`{`  

  `"valor": 10000.00,`  

  `"dataNascimento": "1995-05-15",`  

  `"prazoMeses": 120,`  

  `"registrar": true,`  

  `"modalidade": "VARIAVEL"`  

`}`

Response:

json

`{`  

  `"id": "68a439e6eb78fa8c509cbf6d"`  

`}`

#### POST /service--simulacao/internal/v1/simulacoes/bulk

Cria múltiplas simulações em lote (endpoint interno).

Request Body:

json

`{`  

  `"canalOrigem": "APP",`  

  `"correlationId": "UUID-4",`  

  `"simulacoes": [`  

    `{`  

      `"valor": 7129.94,`  

      `"prazoMeses": 32,`  

      `"dataNascimento": "1962-02-13",`  

      `"modalidade": "VARIAVEL",`  

      `"registrar": true`  

    `}`  

    `// ... mais simulações`  

  `]`  

`}`

#### GET /service--simulacao/v1/simulacoes/{id}

Busca uma simulação pelo ID.

### Endpoints de Proposta

#### POST /service--proposta/v1/proposta

Cria uma proposta baseada em uma simulação.

Request Body:

json

`{`  

  `"idSimulacao": "68a439e6eb78fa8c509cbf6d",`  

  `"cliente": {`  

    `"cpf": "12345678900",`  

    `"nome": "Fulano da Silva"`  

  `}`  

`}`

Response:

json

`{`  

  `"numeroProposta": "PROP20230001"`  

`}`

## Diagramas

### Diagrama de Sequência \- Fluxo de Simulação e Proposta

![](img/img1.png)

### Diagrama de Arquitetura

![](img/img2.png)

## Como Executar

### Pré-requisitos

* Java 11 ou superior  

* Maven 3.6+  

* Docker (opcional)

### Executando os Serviços

1. Serviço de Simulação

bash

`cd service-simulacao`  

`mvn spring-boot:run`

2. Serviço de Proposta

bash

`cd service-proposta`  

`mvn spring-boot:run`

### Executando com Docker

bash

`docker-compose up -d`

## Testando a API

Importe a collection do Postman fornecida e execute os requests na seguinte ordem:

1. `simulacao` \- Para criar uma simulação  

2. `buscar id` \- Para buscar a simulação criada  

3. `proposta` \- Para criar uma proposta baseada na simulação