# diegomouraoficial/sistema-bancario architecture

> Architecture diagram of the GitHub repository diegomouraoficial/sistema-bancario, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/diegomouraoficial/sistema-bancario
- Repository: https://github.com/diegomouraoficial/sistema-bancario

## Overview

##### Project type and purpose
- This is a Java-based RESTful web application (full-stack backend) built with Spring Boot.
- Purpose: provide a banking system API to manage customers (“Cliente”) and accounts (“Conta”), execute transactions and transfers, backed by a PostgreSQL database.

##### File structure
- Top-level: pom.xml, Maven wrapper, README → Maven-based build.
- src/main/java/br/com/diego/olabi:
- BlackApplication.java — entry point (SpringBootApplication)
- controller/…Controller.java — REST controllers for “clientes” and “contas”
- service/…Service.java — business logic layer
- repository/…Repository.java — Spring Data JPA interfaces → database access
- model/… — JPA entity definitions (Cliente, Conta)
- dto/… — data transfer objects for API responses
- request/… — request payload objects
- exception/… — custom exceptions (InsufficientFunds, ResourceNotFound)
- enums/… — domain enums (TipoConta)
- src/main/resources/application.properties — DB configuration
- src/test — basic integration/unit test of application context.

##### README
- Tech stack: Java 11+, Spring Boot, Spring Data JPA, PostgreSQL.
- Describes DB setup, API endpoints, JSON schemas.

1. An actor (HTTP Client) on the left.
- Top: Controller Layer
- Middle: Service Layer
- Bottom: Repository Layer
3. Inside each section, list relevant packages/classes.
- Client → Controllers (POST /clientes/cadastrar, GET /contas/{id}, etc.)
- Controllers → Services
- Services → Repositories
- Repositories → Database
- Database → Services (on query result) → Controllers → Client
7. Notes on exception flows (e.g., ResourceNotFound → 404, InsufficientFunds → 400).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Actor
    Client["HTTP Client<br/>(Postman/Insomnia)"]:::external

    %% Spring Boot Application
    subgraph "Spring Boot Application"
        direction TB

        subgraph "Controller Layer"
            direction TB
            ClienteController["ClienteController<br/>(/clientes)"]:::controller
            ContaController["ContaController<br/>(/contas)"]:::controller
        end

        subgraph "Service Layer"
            direction TB
            ClienteService["ClienteService"]:::service
            ContaService["ContaService"]:::service
        end

        subgraph "Repository Layer"
            direction TB
            ClienteRepository["ClienteRepository"]:::repository
            ContaRepository["ContaRepository"]:::repository
        end

        subgraph "Domain Model"
            direction TB
            ClienteModel["Cliente"]:::model
            ContaModel["Conta"]:::model
        end

        subgraph "DTOs"
            direction TB
            ContaDTO["ContaDTO"]:::dto
            TransacaoDTO["TransacaoDTO"]:::dto
            TransferenciaDTO["TransferenciaDTO"]:::dto
        end

        subgraph "Requests"
            direction TB
            CriarContaRequest["CriarContaRequest"]:::request
            AtualizarContaRequest["AtualizarContaRequest"]:::request
            OperacaoRequest["OperacaoRequest"]:::request
            TransferenciaRequest["TransferenciaRequest"]:::request
        end

        subgraph "Exceptions & Enums"
            direction TB
            ResourceNotFoundException["ResourceNotFoundException"]:::exception
            InsufficientFundsException["InsufficientFundsException"]:::exception
            TipoContaEnum["TipoConta"]:::enum
        end
    end

    %% Database
    Database["PostgreSQL Database<br/>Tables: cliente, conta, transacao"]:::database

    %% Connections
    Client -->|"HTTP Request"| ClienteController
    ClienteController -->|"calls"| ClienteService
    ContaController -->|"calls"| ContaService
    ClienteService -->|"uses"| ClienteRepository
    ContaService -->|"uses"| ContaRepository
    ClienteRepository -->|"queries"| Database
    ContaRepository -->|"queries"| Database

    %% Click Events
    click ClienteController "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/controller/ClienteController.java"
    click ContaController "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/controller/ContaController.java"
    click ClienteService "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/service/ClienteService.java"
    click ContaService "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/service/ContaService.java"
    click ClienteRepository "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/repository/ClienteRepository.java"
    click ContaRepository "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/repository/ContaRepository.java"
    click ClienteModel "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/model/Cliente.java"
    click ContaModel "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/model/Conta.java"
    click ContaDTO "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/dto/ContaDTO.java"
    click TransacaoDTO "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/dto/TransacaoDTO.java"
    click TransferenciaDTO "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/dto/TransferenciaDTO.java"
    click CriarContaRequest "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/request/CriarContaRequest.java"
    click AtualizarContaRequest "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/request/AtualizarContaRequest.java"
    click OperacaoRequest "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/request/OperacaoRequest.java"
    click TransferenciaRequest "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/request/TransferenciaRequest.java"
    click ResourceNotFoundException "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/exception/ResourceNotFoundException.java"
    click InsufficientFundsException "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/exception/InsufficientFundsException.java"
    click TipoContaEnum "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/java/br/com/diego/olabi/enums/TipoConta.java"
    click Database "https://github.com/diegomouraoficial/sistema-bancario/blob/main/src/main/resources/application.properties"

    %% Styles
    classDef external fill:#FFA500,stroke:#333,stroke-width:1px;
    classDef controller fill:#87CEEB,stroke:#333,stroke-width:1px;
    classDef service fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef repository fill:#AFEEEE,stroke:#333,stroke-width:1px;
    classDef model fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef dto fill:#D8BFD8,stroke:#333,stroke-width:1px;
    classDef request fill:#FFB6C1,stroke:#333,stroke-width:1px;
    classDef exception fill:#F08080,stroke:#333,stroke-width:1px;
    classDef enum fill:#FFD700,stroke:#333,stroke-width:1px;
    classDef database fill:#228B22,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5;
```
