# enry-cl/desafio-conversor-de-monedas architecture

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

- Interactive diagram: https://gitdiagram.com/enry-cl/desafio-conversor-de-monedas
- Repository: https://github.com/enry-cl/desafio-conversor-de-monedas

## Overview

Para dibujar un diagrama de arquitectura claro y preciso para el proyecto “Conversor de monedas”, sigue estos pasos:

##### Identificar el tipo de proyecto y su propósito
- Es una aplicación de consola en Java que recibe datos de usuario, consulta una API externa de tipos de cambio, realiza la conversión y muestra el resultado.
- No es un sistema web ni microservicio; es un programa monolítico con capas internas bien definidas (presentación, servicio, modelo).

##### Analizar la estructura de ficheros
- src/: contiene toda la lógica.
- Principal.java → capa de presentación / orquestación.
- ConsultaTipoDeMoneda.java → capa de servicio que comunica con la API externa.
- TipoCambio.java (record) → modelo de datos inmutable.
- TipoDeMonedaNoEncontradaException.java → manejo de errores específico.
- No hay submódulos ni front-end; todo corre localmente en consola.

##### Extraer detalles del README
- La responsabilidad de cada clase ya está definida:
a. Principal gestiona I/O y flujo (menú, lectura, bucle de conversión).
b. ConsultaTipoDeMoneda encapsula HTTP y parseo JSON.
c. TipoCambio transporta moneda destino y valor.
d. Excepción personalizada para moneda no encontrada.

##### Componentes principales para el diagrama
- Presentación (Console UI)
- Componente “Principal”
- Lógica de negocio / servicio
- Componente “CurrencyService” (ConsultaTipoDeMoneda)
- Modelo de datos
- Componente “TipoCambio”
- Manejo de errores
- Componente “TipoDeMonedaNoEncontradaException”
- Sistema externo
- API de tipos de cambio (end-point HTTP)

##### Relaciones e interacciones
- Flecha UI → Service: Principal invoca obtenerTipoDeCambio(monedaOrigen, monedaDestino).
- Flecha Service → External API: ConsultaTipoDeMoneda hace petición HTTP y recibe JSON.
- Flecha Service → Modelo: parsea JSON a TipoCambio.
- Excepción: Service lanza TipoDeMonedaNoEncontradaException si la API no reconoce moneda.
- Flecha Modelo → UI: Principal recibe el objeto TipoCambio y calcula el valor convertido.
- Flecha UI → Usuario: muestra resultado y lee si desea continuar o salir.

##### Patrones y principios arquitectónicos
- Separación de capas (Presentation, Service, Model, Exception).
- Encapsulamiento en ConsultaTipoDeMoneda: aisla detalles HTTP/JSON.
- Uso de record para modelo inmutable.
- Excepción personalizada para control de errores específico.

##### Directrices para el diagrama
- Dibuja cada componente como un rectángulo o caja.
- Usa flechas con sentido único o bidireccional según el flujo de datos.
- Aplica colores o formas distintos:
- Azul para componentes internos (Principal, Service, Modelo).
- Rojo para la excepción.
- Verde para sistemas externos (API).
- Etiqueta claramente cada flecha con la acción o el método (por ejemplo, “obtenerTipoDeCambio()”, “HTTP GET /rates”).
- Incluye notas o leyenda si hay flujos alternativos (p. ej. manejo de excepción).

##### Consejos finales
- Sé muy detallado: muestra cada capa por separado y sus responsabilidades.
- No sobrecargues con subcomponentes: basta con representar las cuatro piezas clave y su interacción.
- Añade un título y fecha al diagrama, y conserva la leyenda de colores para mejorar la legibilidad.

Siguiendo esta guía, obtendrás un diagrama sencillo pero completo que refleja exactamente la arquitectura interna del Conversor de Monedas.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        Principal["Principal"]:::internal
        Usuario["Usuario"]:::external
    end

    %% Service Layer
    subgraph "Service Layer"
        CurrencyService["CurrencyService (ConsultaTipoDeMoneda)"]:::internal
    end

    %% Model Layer
    subgraph "Model Layer"
        TipoCambio["TipoCambio"]:::internal
    end

    %% Exception Layer
    subgraph "Exception Layer"
        TipoEx["TipoDeMonedaNoEncontradaException"]:::exception
    end

    %% External Systems
    ExternalAPI["API de tipos de cambio"]:::external

    %% Interactions
    Principal -->|"obtenerTipoDeCambio()"| CurrencyService
    CurrencyService -->|"HTTP GET /rates"| ExternalAPI
    ExternalAPI -->|"JSON response"| CurrencyService
    CurrencyService -->|"parsea a TipoCambio"| TipoCambio
    CurrencyService --->|"lanza excepción"| TipoEx
    TipoCambio -->|"objeto de retorno"| Principal
    Principal -->|"muestra resultado / lee continuación"| Usuario

    %% Click Events
    click Principal "https://github.com/enry-cl/desafio-conversor-de-monedas/blob/main/src/Principal.java"
    click CurrencyService "https://github.com/enry-cl/desafio-conversor-de-monedas/blob/main/src/ConsultaTipoDeMoneda.java"
    click TipoCambio "https://github.com/enry-cl/desafio-conversor-de-monedas/blob/main/src/TipoCambio.java"
    click TipoEx "https://github.com/enry-cl/desafio-conversor-de-monedas/blob/main/src/TipoDeMonedaNoEncontradaException.java"

    %% Styling
    classDef internal fill:#AEDBFF,stroke:#000,stroke-width:1px;
    classDef exception fill:#FFB3B3,stroke:#000,stroke-width:1px;
    classDef external fill:#B9E2B8,stroke:#000,stroke-width:1px;
```
