How jhuina/challenge-conversor-monedas works
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”.