# luishu533/coversordemonedas architecture

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

- Interactive diagram: https://gitdiagram.com/luishu533/coversordemonedas
- Repository: https://github.com/luishu533/coversordemonedas

## Overview

##### Project type and purpose
- This is a Java-based, console (CLI) application (“Conversor de Monedas”) whose sole responsibility is to read a user’s text input (“1000 dólares a soles”), parse it, call an external ExchangeRate API, and print the conversion result.

##### File structure
- Top-level:
- src/com/alura/coversorDeMonedas/principal
- src/lib/gson-2.13.1.jar
- Under “principal” you have:
- Principal.java (entry point / CLI loop)
- Bienvenida.java (welcome & help text)
- FraseConversor.java (parser for “<cantidad> <moneda1> a <moneda2>”)
- DatosMoneda.java (map of supported currencies & ISO codes)
- Moneda.java (currency model)
- ConsultaApi.java (HTTP client to ExchangeRate API)
- Conversor.java (data model for JSON response)

##### README for additional insights
- The README confirms:
- Java 17+, uses Gson for JSON
- Flow: read CLI → parse → fetch rates → compute → output
- External dependency: ExchangeRate-API

##### Essential architectural elements
- Don’t overcomplicate—break the system into the five layers above
- Classes and their relationships—each class as its own sub-component if needed
- External dependency (Gson JAR) and the remote API

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "CLI Layer"
        direction TB
        Principal["CLI / Principal"]:::presentation
        Bienvenida["CLI / Bienvenida"]:::presentation
    end

    %% Domain / Parsing Layer
    subgraph "Input-Parsing / Domain Layer"
        direction TB
        FraseConversor["Parser / FraseConversor"]:::domain
        DatosMoneda["Domain Lookup / DatosMoneda"]:::domain
        Moneda["Model / Moneda"]:::domain
    end

    %% Integration / API Client Layer
    subgraph "API Client Layer"
        direction TB
        ConsultaApi["API Client / ConsultaApi"]:::integration
    end

    %% Data Model Layer
    subgraph "Data Model Layer"
        direction TB
        Conversor["Data Model / Conversor"]:::data
        Gson["Library / Gson"]:::data
    end

    %% External Service
    subgraph "External Service"
        direction TB
        ExchangeRateAPI["ExchangeRate-API"]:::external
    end

    %% Flow
    User["User"]:::external -->|"types command"| Principal
    Principal -->|"show welcome"| Bienvenida
    Principal -->|"reads input"| FraseConversor
    FraseConversor -->|"lookup currency"| DatosMoneda
    DatosMoneda --> Moneda
    Principal -->|"calls API client"| ConsultaApi
    ConsultaApi -->|"HTTP GET"| ExchangeRateAPI
    ConsultaApi -->|"uses Gson to parse"| Gson
    Gson --> Conversor
    Principal -->|"compute conversion using rates"| Conversor
    Principal -->|"print result"| ConsoleOutput["Console Output"]:::presentation

    %% Click Events
    click Principal "https://github.com/luishu533/coversordemonedas/blob/master/src/com/alura/coversorDeMonedas/principal/Principal.java"
    click Bienvenida "https://github.com/luishu533/coversordemonedas/blob/master/src/com/alura/coversorDeMonedas/principal/Bienvenida.java"
    click FraseConversor "https://github.com/luishu533/coversordemonedas/blob/master/src/com/alura/coversorDeMonedas/principal/FraseConversor.java"
    click DatosMoneda "https://github.com/luishu533/coversordemonedas/blob/master/src/com/alura/coversorDeMonedas/principal/DatosMoneda.java"
    click Moneda "https://github.com/luishu533/coversordemonedas/blob/master/src/com/alura/coversorDeMonedas/principal/Moneda.java"
    click ConsultaApi "https://github.com/luishu533/coversordemonedas/blob/master/src/com/alura/coversorDeMonedas/principal/ConsultaApi.java"
    click Conversor "https://github.com/luishu533/coversordemonedas/blob/master/src/com/alura/coversorDeMonedas/principal/Conversor.java"
    click Gson "https://github.com/luishu533/coversordemonedas/blob/master/src/lib/gson-2.13.1.jar"

    %% Styles
    classDef presentation fill:#a8e6a3,stroke:#333,stroke-width:1px
    classDef domain fill:#a3c4f3,stroke:#333,stroke-width:1px
    classDef integration fill:#f3b27a,stroke:#333,stroke-width:1px
    classDef data fill:#f9f871,stroke:#333,stroke-width:1px
    classDef external fill:#d3d3d3,stroke:#333,stroke-width:1px
```
