How serato12/challengeconversor works
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.