# serato12/challengeconversor architecture

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

- Interactive diagram: https://gitdiagram.com/serato12/challengeconversor
- Repository: https://github.com/serato12/challengeconversor

## Overview

Para dibujar un diagrama de arquitectura claro y detallado del proyecto **ChallengeConversor**, sigue estos pasos, adaptándolos a la estructura y funcionalidades específicas:

##### Identificación del tipo de proyecto y propósito
- Es una pequeña aplicación de consola escrita en Java cuyo propósito principal es realizar conversiones entre distintas monedas (MXN, USD, BRL, EUR).
- No es un sistema distribuido ni un frontend web: funciona como herramienta de línea de comandos (CLI).

##### Análisis de la estructura de archivos
- challengeConversor/src
- Main.java – punto de entrada y manejo de I/O con el usuario.
- Conversiones.java – contiene los métodos que realizan cada cálculo de conversión.
- Moneda.java – modelo de dominio que representa una moneda (abstracción de cantidad y tipo).
- Dependencia externa: gson-2.11.0.jar – se puede usar para parseo de JSON si en el futuro se cargan tablas de conversión desde ficheros o servicios.

##### Funciones y métodos clave
Conversiones.java:
- double pesosAM dolares(double cantidad)
- double dolaresAPesos(double cantidad)
- double dolaresABr reales(double cantidad)
- double realesAdolares(double cantidad)
- double dolaresAEuros(double cantidad)
- double eurosAdolares(double cantidad)
Moneda.java:
- Atributos: String tipo (p. ej. "USD", "MXN"), double cantidad
- Constructor, getters/setters
Main.java:
- Método main():
- Muestra menú de opciones de conversión al usuario
- Lee selección y cantidad por consola
- Invoca al método correspondiente de Conversiones.java
- Crea instancia de Moneda con resultado y tipo
- Muestra resultado final por consola

##### Componentes principales para el diagrama
- Componente CLI (User Interface)
- Subcomponente: Lector de entrada (Scanner/System.in)
- Subcomponente: Escritor de salida (System.out)
- Core de Lógica de Negocio (Conversion Module)
- Conversiones.java
- Modelo de Dominio (Domain Model)
- Moneda.java
- Dependencias Externas
- Gson Library (jar) – uso futuro para configuración o extensión
- Configuración de tasas de conversión (opcional futuro)
- Fichero JSON / Properties / Servicio externo

##### Relaciones e interacciones
- El **CLI** recibe la orden del usuario y la cantidad
- CLI → invoca → **Conversion Module**
- Conversion Module → devuelve → valor convertido
- CLI → crea → **Moneda** (objeto de dominio) con el resultado
- CLI → muestra → resultado al usuario
- (Si se extiende) Conversion Module ↔ lee ↔ fichero JSON vía Gson para tasas

##### Patrones y buenas prácticas
- Separación clara entre UI y lógica de negocio
- Uso de un modelo de dominio para representar resultados
- Posible futura inyección de dependencias para tasas de conversión (por ejemplo, Strategy Pattern o Service Loader)

##### Guía para el diagrama específico
a) Dibuja rectángulos grandes para cada componente principal:
[CLI]   [Conversion Module]   [Domain Model]   [External Libs/Config]
b) Usa flechas unidireccionales:
CLI → Conversion Module → CLI → Domain Model → CLI
c) Añade etiquetas en las flechas (p.ej., “solicita conversión”, “retorna valor”)
d) Emplea colores o formas:
- Azul para UI
- Verde para Lógica de Negocio
- Amarillo para Modelo
- Gris para librerías externas
e) Dentro de cada bloque, anota los nombres de clases y métodos principales (ver punto 3)

##### Detalles adicionales
- Marca el método `main()` como entrypoint con un símbolo especial (por ejemplo, un icono de play o un círculo relleno).
- Si prevés ampliaciones (nuevas conversiones o carga dinámica de tasas), muestra un componente “Config Service” o “Exchange Rate Provider” que alimente al Conversion Module.

Con este diagrama detallado, capturarás la arquitectura actual de ChallengeConversor y dejarás espacio para futuras extensiones, manteniendo siempre claridad en los roles de cada pieza.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Subgraphs for components
    subgraph "CLI User Interface" 
        Main["Main.java\n• main()"]:::ui
    end

    subgraph "Conversion Module" 
        Conversion["Conversiones.java\n• pesosAM dolares()\n• dolaresAPesos()\n• dolaresABr reales()\n• realesAdolares()\n• dolaresAEuros()\n• eurosAdolares()"]:::logic
    end

    subgraph "Domain Model"
        Moneda["Moneda.java\n• tipo: String\n• cantidad: double\n• getters/setters"]:::model
    end

    subgraph "External Libraries / Config"
        Gson["gson-2.11.0.jar"]:::external
        Config["challengeConversor.iml"]:::external
    end

    %% Interactions
    Main -->|"solicita conversión"| Conversion
    Conversion -->|"retorna valor convertido"| Main
    Main -->|"crea instancia de Moneda"| Moneda
    Moneda -->|"devuelve objeto dominio"| Main
    Main -->|"muestra resultado por consola"| Main
    Conversion -->|"lee tasas (futuro)"| Gson
    Config -->|"configura proyecto/IDE"| Main
    Config -->|"configura proyecto/IDE"| Conversion

    %% Click Events
    click Main "https://github.com/serato12/challengeconversor/blob/main/challengeConversor/src/Main.java"
    click Conversion "https://github.com/serato12/challengeconversor/blob/main/challengeConversor/src/Conversiones.java"
    click Moneda "https://github.com/serato12/challengeconversor/blob/main/challengeConversor/src/Moneda.java"
    click Gson "https://github.com/serato12/challengeconversor/blob/main/gson-2.11.0.jar"
    click Config "https://github.com/serato12/challengeconversor/blob/main/challengeConversor/challengeConversor.iml"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0284C7,color:#000000;
    classDef logic fill:#DFFFE0,stroke:#05A04E,color:#000000;
    classDef model fill:#FFF8B0,stroke:#D4A500,color:#000000;
    classDef external fill:#E0E0E0,stroke:#6B6B6B,color:#000000;
```
