# tiagobahiense/conversor-de-moedas architecture

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

- Interactive diagram: https://gitdiagram.com/tiagobahiense/conversor-de-moedas
- Repository: https://github.com/tiagobahiense/conversor-de-moedas

## Overview

Para criar um diagrama de sistema claro e detalhado para o “Conversor de Moedas” (aplicação Java de console), siga estas instruções adaptadas à estrutura do projeto:

##### Identificação do tipo de projeto e propósito
- É uma aplicação monolítica de console em Java 17.
- Propósito: converter valores entre moedas, buscando taxas atualizadas de uma Exchange Rate API.

##### Componentes principais
Agrupe as classes em 3 grandes camadas/layers:
a. Camada de Apresentação / UI
- Main/Main.java
- classes/Interface.java
- classes/ImprimeValores.java
- classes/ObterValor.java
b. Camada de Negócio (Domínio)
- classes/Conversor.java
- classes/Moeda.java
- classes/CodePais.java
- classes/Localizacao.java
c. Camada de Integração / Serviço Externo
- classes/Api.java (constrói requisição HTTP)
- classes/ApiRec.java (trata resposta JSON da Exchange Rate API)
d. Dependência Externa
- Exchange Rate API (serviço REST externo)

##### Relacionamentos e fluxos de dados
a. Fluxo de execução (sequência):
1) Usuário ⟶ Main: inicia aplicação
2) Main ⟶ Interface: exibe menu
3) Interface ⟶ ObterValor: lê seleções de moeda origem, destino e valor
4) Interface ⟶ Conversor: solicita conversão
5) Conversor ⟶ Api: monta e envia chamada HTTP
6) Api ⟶ Exchange Rate API: requisição REST
7) Exchange Rate API ⟶ ApiRec: retorna JSON
8) ApiRec ⟶ Conversor: fornece taxa de câmbio
9) Conversor: calcula resultado
10) Conversor ⟶ ImprimeValores: exibe resultado formatado
11) ImprimeValores ⟶ Usuário: apresenta output no console

b. Dependências de dados:
- CodePais/Localizacao abastecem a lista de moedas disponíveis.
- Moeda modela propriedades de cada moeda.

##### Padrões e princípios arquiteturais
- Camadas bem definidas (Presentation, Domain, Integration).
- Responsabilidade única por classe (Single Responsibility Principle).
- Externalização de configuração da API (classe Api) e de parsing (ApiRec).
- Uso de pacotes Java para modularização.

##### Desenho do diagrama
a. Use um diagrama de componentes (ou um C4 Container simplificado):
- Desenhe 3 caixas empilhadas representando as camadas UI, Domínio e Integração.
- Dentro de cada caixa, liste os componentes (classes/packages).
- Fora, desenhe um componente “Exchange Rate API” com estilo de serviço REST.

b. Conecte-os com setas direcionais que indiquem chamadas e retornos de dados:
- UI → Domínio → Integração → Serviço Externo
- Retornos (setas tracejadas ou de resposta) voltam no sentido inverso.

##### Codificação de cores e formas
- UI (azul claro, retângulos de cantos arredondados)
- Domínio (verde, retângulos)
- Integração (amarelo, retângulos com borda tracejada)
- Serviço Externo (cinza, nuvem ou cilindro representando REST)

##### Rótulos e anotações
- Em cada seta, inclua a ação (ex.: “GET /latest?base=USD&symbols=EUR”).
- Em cada componente, indique o pacote (ex.: br.com.tiagobahiense.conversor.classes).
- Adicione legendas explicando cores e estilos.

##### Dicas finais
- Seja o mais granular possível: cada classe vira um componente.
- Mostre claramente o fluxo de dados do usuário até o API extern​o e de volta.
- Documente dependências (Java 17, Exchange Rate API).

Seguindo estas orientações, o diagrama resultante exibirá de forma completa e precisa a arquitetura do projeto, suas camadas, componentes e interações com o serviço de câmbio externo.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actor
    User(("User")):::actor

    %% UI Layer
    subgraph "Presentation/UI Layer" 
        direction TB
        Main["Main\nbr.com.tiagobahiense.conversor.Main"]:::ui
        Interface["Interface\nbr.com.tiagobahiense.conversor.classes"]:::ui
        ObterValor["ObterValor\nbr.com.tiagobahiense.conversor.classes"]:::ui
        ImprimeValores["ImprimeValores\nbr.com.tiagobahiense.conversor.classes"]:::ui
    end

    %% Domain Layer
    subgraph "Domain Layer" 
        direction TB
        Conversor["Conversor\nbr.com.tiagobahiense.conversor.classes"]:::domain
        Moeda["Moeda\nbr.com.tiagobahiense.conversor.classes"]:::domain
        CodePais["CodePais\nbr.com.tiagobahiense.conversor.classes"]:::domain
        Localizacao["Localizacao\nbr.com.tiagobahiense.conversor.classes"]:::domain
    end

    %% Integration Layer
    subgraph "Integration Layer"
        direction TB
        Api["Api\nbr.com.tiagobahiense.conversor.classes"]:::integration
        ApiRec["ApiRec\nbr.com.tiagobahiense.conversor.classes"]:::integration
    end

    %% External Service
    ExternalAPI([/ Exchange Rate API /]):::external

    %% Flow of execution
    User -->|"start()"| Main
    Main -->|"displayMenu()"| Interface
    Interface -->|"readSelection()"| ObterValor
    Interface -->|"requestConversion()"| Conversor
    Conversor -->|"buildRequest()"| Api
    Api -->|"GET /latest?base=USD&symbols=EUR"| ExternalAPI
    ExternalAPI -->|"JSON response"| ApiRec
    ApiRec -->|"getRate()"| Conversor
    Conversor -->|"formatOutput()"| ImprimeValores
    ImprimeValores -->|"display()"| User

    %% Data dependencies
    CodePais -.->|"provideCodes()"| Interface
    Localizacao -.->|"provideList()"| Interface
    Moeda -.->|"modelCurrency()"| Conversor

    %% Click Events
    click Main "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/Main/Main.java"
    click Interface "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/classes/Interface.java"
    click ObterValor "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/classes/ObterValor.java"
    click ImprimeValores "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/classes/ImprimeValores.java"
    click Conversor "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/classes/Conversor.java"
    click Moeda "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/classes/Moeda.java"
    click CodePais "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/classes/CodePais.java"
    click Localizacao "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/classes/Localizacao.java"
    click Api "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/classes/Api.java"
    click ApiRec "https://github.com/tiagobahiense/conversor-de-moedas/blob/master/src/br/com/tiagobahiense/conversor/classes/ApiRec.java"

    %% Styles
    classDef ui fill:#d0e7ff,stroke:#3498db,stroke-width:1px;
    classDef domain fill:#d5f5e3,stroke:#27ae60,stroke-width:1px;
    classDef integration fill:#fcf3cf,stroke:#f1c40f,stroke-width:1px,stroke-dasharray:5 5;
    classDef external fill:#ecf0f1,stroke:#7f8c8d,stroke-width:1px;
    classDef actor fill:none,stroke:none;
    class User actor
    class Main,Interface,ObterValor,ImprimeValores ui
    class Conversor,Moeda,CodePais,Localizacao domain
    class Api,ApiRec integration
    class ExternalAPI external
```
