# jhuina/challenge-conversor-monedas architecture

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

- Interactive diagram: https://gitdiagram.com/jhuina/challenge-conversor-monedas
- Repository: https://github.com/jhuina/challenge-conversor-monedas

## Overview

##### Identificación del tipo de proyecto y propósito
- Se trata de una aplicación de consola (CLI) en Java 21+ cuyo objetivo es convertir monedas (USD ↔ CLP, ARS, BRL, COP, SOL), mantener un historial de conversiones y apoyarse en un servicio externo (https://www.exchangerate-api.com/).

##### Análisis de la estructura de archivos
- src/cl/conversor/Main.java: capa de presentación (entrada/salida por consola).
- src/cl/conversor/Config.java + config.properties: componente de configuración (API key, endpoint).
- src/cl/conversor/modelos: objetos de transferencia (ConsultaApi.java, RespuestaApi.java) y lógica de negocio (Service.java).
- conversion.txt: archivo local para almacenar o mostrar el historial de conversiones.
- No hay base de datos interna: el “historial” se maneja en memoria o mediante el archivo conversion.txt.

##### Principales componentes del sistema
A. Interfaz de Usuario (CLI)
B. Componente de Configuración
C. Capa de Servicio (Service.java)
D. Modelos de datos (DTOs para petición y respuesta)
E. Archivo de Historial (conversion.txt)
F. Servicio Externo (ExchangeRate API via HTTP)

##### Relaciones e interacciones
- Al arrancar, Main carga Config.properties a través de Config.java.
- Main recibe la moneda origen/destino e invoca Service.
- Service construye una ConsultaApi, llama (GET) al ExchangeRate API, y deserializa la RespuestaApi.
- Service calcula la conversión, devuelve el resultado a Main.
- Main imprime resultado y lo escribe en conversion.txt (append).
- Flechas bidireccionales para petición/respuesta HTTP, flecha unidireccional para logging a archivo.

##### Patrones y principios arquitectónicos
- Separación de responsabilidades (SRP):
· Main → UI/flow
· Config → lectura de propiedades
· Service → lógica de negocio/HTTP
· Modelos → DTO/serialización
- Arquitectura en capas (Presentation / Application / Domain / Infrastructure).

##### Tecnologías y librerías relevantes
- Java 21+
- java.net.http o una librería HTTP (si aplica)
- JSON parsing (Jackson, GSON, o similar)
- Archivo de propiedades estándar
- Archivo de texto para historial

##### Guía para diagramar este proyecto
a. Dibuja cajas rectangulares para cada componente:
- “CLI (Main.java)” en la capa de presentación
- “Config Loader (Config.java + config.properties)”
- “Service Layer (Service.java)”
- “Models (ConsultaApi, RespuestaApi)”
- “Historial (conversion.txt)”
- “ExchangeRate API (externo)”
b. Usa flechas dirigidas para mostrar el flujo:
- Config → Service y Main
- Main → Service → ExchangeRate API
- ExchangeRate API → Service → Main
- Main → Historial (escritura)
- Azul para componentes internos Java
- Verde para archivos de configuración/historial
- Naranja o nube para servicios externos
d. Etiqueta cada flecha con el tipo de dato o protocolo (GET HTTP, JSON, write).

##### Consejos adicionales
- Incluye leyenda de colores y formas.
- Numera los pasos de interacción (1, 2, 3…) junto a las flechas.
- Adjunta notas sobre el formato de config.properties y la URL del API.
- Sé lo más granular posible: cada clase o artefacto relevante es un nodo en el diagrama.

Con esta estructura, obtendrás un diagrama claro, preciso y directamente alineado con la arquitectura real de tu proyecto “Conversor de Moneda”.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Presentation Layer"
        CLI["CLI (Main.java)"]:::internal
    end

    subgraph "Configuration"
        Config["Config Loader (Config.java)"]:::config
        Props["config.properties"]:::config
    end

    subgraph "Service Layer"
        Service["Service Layer (Service.java)"]:::internal
    end

    subgraph "Models"
        Consulta["ConsultaApi"]:::internal
        Respuesta["RespuestaApi"]:::internal
    end

    subgraph "Infrastructure"
        Historial["Historial (conversion.txt)"]:::config
    end

    External["ExchangeRate API"]:::external

    Props -->|"1: loaded by"| Config
    Config -->|"1: provides config"| CLI
    CLI -->|"2: invokes Service"| Service
    Service -->|"3: GET HTTP"| External
    External -->|"4: returns JSON"| Service
    Service -->|"5: returns result"| CLI
    CLI -->|"6: writes to file"| Historial

    Service -->|"uses DTO"| Consulta
    Service -->|"uses DTO"| Respuesta

    click CLI "https://github.com/jhuina/challenge-conversor-monedas/blob/main/src/cl/conversor/Main.java"
    click Config "https://github.com/jhuina/challenge-conversor-monedas/blob/main/src/cl/conversor/Config.java"
    click Props "https://github.com/jhuina/challenge-conversor-monedas/blob/main/src/config.properties"
    click Service "https://github.com/jhuina/challenge-conversor-monedas/blob/main/src/cl/conversor/modelos/Service.java"
    click Consulta "https://github.com/jhuina/challenge-conversor-monedas/blob/main/src/cl/conversor/modelos/ConsultaApi.java"
    click Respuesta "https://github.com/jhuina/challenge-conversor-monedas/blob/main/src/cl/conversor/modelos/RespuestaApi.java"
    click Historial "https://github.com/jhuina/challenge-conversor-monedas/blob/main/conversion.txt"

    classDef internal fill:#bbdefb,stroke:#0d47a1,color:#0d47a1;
    classDef config fill:#c8e6c9,stroke:#1b5e20,color:#1b5e20;
    classDef external fill:#ffe0b2,stroke:#ef6c00,color:#e65100;
```
