Skip to content

About

Projeto desenvolvido em Java com Spring Boot para aplicar Design Patterns na construção de uma API bancária. A aplicação possui operações de criação de contas, depósitos, saques e transferências, utilizando os padrões Builder, Strategy, Factory, Chain of Responsibility e Repository, além de Spring Data JPA e MySQL para persistência dos dados.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

ByteBank API

API bancária desenvolvida em Java com Spring Boot, criada como desafio para aplicar Design Patterns na prática. O projeto simula operações básicas de um banco digital: criação de contas, depósitos, saques e transferências entre contas (PIX e TED).

Sobre o projeto

O foco principal deste projeto não é apenas construir uma API funcional, mas demonstrar a aplicação de padrões de projeto (Design Patterns) em um cenário realista, mantendo o código desacoplado e fácil de estender.

Design Patterns utilizados

Builder

Usado na classe Conta para construir objetos de forma fluente e controlada, evitando construtores com muitos parâmetros.

Strategy

Define o contrato TransferenciaStrategy, implementado por PixStrategy e TedStrategy, permitindo que cada tipo de transferência tenha sua própria regra de negócio (a TED, por exemplo, aplica uma taxa fixa sobre o valor transferido).

Factory

A classe TransferenciaFactory é responsável por escolher e instanciar a estratégia de transferência correta (PIX ou TED) a partir do tipo informado na requisição.

Chain of Responsibility

As classes ValidadorValor e ValidadorSaldo formam uma cadeia de validação executada antes de um saque, verificando primeiro se o valor é válido e, em seguida, se há saldo suficiente na conta.

Repository

ContaRepository estende JpaRepository e isola toda a comunicação com o banco de dados, seguindo o padrão Repository do Spring Data JPA.

Tecnologias

  • Java 21
  • Spring Boot 3.5.4
  • Spring Web
  • Spring Data JPA
  • Spring Validation
  • MySQL
  • Lombok
  • Maven

Estrutura do projeto

src/main/java/com/bytebank
├── chain
│   ├── Validador.java
│   ├── ValidadorSaldo.java
│   └── ValidadorValor.java
├── controller
│   └── ContaController.java
├── factory
│   └── TransferenciaFactory.java
├── model
│   ├── Conta.java
│   └── Transacao.java
├── repository
│   └── ContaRepository.java
├── service
│   └── ContaService.java
└── strategy
    ├── PixStrategy.java
    ├── TedStrategy.java
    └── TransferenciaStrategy.java

Como executar

Pre-requisitos

  • Java 21
  • Maven
  • MySQL em execucao

Configuracao do banco de dados

Crie um arquivo src/main/resources/application.properties com as credenciais do seu banco MySQL, por exemplo:

spring.datasource.url=jdbc:mysql://localhost:3306/bytebank
spring.datasource.username=root
spring.datasource.password=sua_senha

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

Rodando a aplicacao

git clone https://github.com/DneyDev/bytebank-api.git
cd bytebank-api
mvn spring-boot:run

A API sobe por padrao em http://localhost:8080.

Endpoints

Metodo Rota Descricao
POST /contas Cria uma nova conta (parametro titular)
POST /contas/{id}/depositar Deposita um valor na conta (parametro valor)
POST /contas/{id}/sacar Saca um valor da conta (parametro valor)
POST /contas/transferir Transfere entre contas (origem, destino, valor, tipo)

O parametro tipo aceita PIX ou TED. Na TED e descontada uma taxa fixa de R$ 5,00 do valor transferido.

Exemplo de uso

Criar uma conta:

curl -X POST "http://localhost:8080/contas?titular=Sidney"

Depositar:

curl -X POST "http://localhost:8080/contas/1/depositar?valor=100"

Transferir via PIX:

curl -X POST "http://localhost:8080/contas/transferir?origem=1&destino=2&valor=50&tipo=PIX"

Possiveis melhorias futuras

  • Persistir o historico de transacoes (a classe Transacao ainda nao esta integrada ao banco)
  • Adicionar tratamento global de excecoes (@ControllerAdvice)
  • Criar testes unitarios e de integracao
  • Adicionar documentacao da API com Swagger/OpenAPI
  • Validar entradas com Bean Validation nos DTOs de requisicao

Autor

Desenvolvido por Sidney (DneyDev).

About

Projeto desenvolvido em Java com Spring Boot para aplicar Design Patterns na construção de uma API bancária. A aplicação possui operações de criação de contas, depósitos, saques e transferências, utilizando os padrões Builder, Strategy, Factory, Chain of Responsibility e Repository, além de Spring Data JPA e MySQL para persistência dos dados.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages