How enry-cl/desafio-conversor-de-monedas works
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.