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).
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.
Usado na classe Conta para construir objetos de forma fluente e controlada, evitando construtores com muitos parâmetros.
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).
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.
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.
ContaRepository estende JpaRepository e isola toda a comunicação com o banco de dados, seguindo o padrão Repository do Spring Data JPA.
- Java 21
- Spring Boot 3.5.4
- Spring Web
- Spring Data JPA
- Spring Validation
- MySQL
- Lombok
- Maven
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
- Java 21
- Maven
- MySQL em execucao
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=truegit clone https://github.com/DneyDev/bytebank-api.git
cd bytebank-api
mvn spring-boot:runA API sobe por padrao em http://localhost:8080.
| 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.
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"- Persistir o historico de transacoes (a classe
Transacaoainda 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
Desenvolvido por Sidney (DneyDev).