How tiagobahiense/conversor-de-moedas works
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 externo 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.