How jusep1983/s302_patterns_2 works
Para el ingeniero de software principal, aquí tienes una guía detallada para crear un diagrama de arquitectura/sistema que represente fielmente este proyecto educativo de patrones en Java. El proyecto consta de tres subsistemas independientes (niveles) que demuestran los patrones Builder, Observer y Callback. Sigue estos pasos:
Identificación del proyecto
• Tipo: Repositorio de ejemplos didácticos en Java que ilustran tres patrones de diseño.
• Propósito: Proveer implementaciones independientes de Builder (nivel1), Observer (nivel2) y Callback (nivel3).
Análisis de la estructura de archivos
• level1 (Builder):
• paquete builders: PizzaBuilder (interfaz) + HawaiianPizzaBuilder, PepperoniPizzaBuilder, VeganPizzaBuilder
• paquete director: PizzaMaster (director)
• paquete model: Pizza + enums (PizzaSize, PizzaDough, PizzaTopping)
• Main.java orquesta la construcción.
• level2 (Observer):
• paquete subjects: StockExchange (interfaz), ConcreteStockExchange (sujeto)
• paquete observers: Broker (interfaz), ConcreteBroker (observador)
• utils: ChangeSymbolFormatter
• Main.java simula actualizaciones.
• level3 (Callback):
• paquete model: Customer, Shoe, Purchase, ShoeStore (cliente que inicia pagos)
• paquete payment: PaymentMethod (interfaz funcional)
• paquete payment.gateway: PaymentGateway (invoca callbacks)
• paquete payment.methods: BankTransfer, CreditCardPayment, PaypalPayment
• Main.java ejecuta varias compras y pagos.
Estructura del diagrama
• Divide el lienzo en tres áreas (“Nivel 1”, “Nivel 2”, “Nivel 3”).
• Dentro de cada área, agrupa en “paquetes” (subrectángulos) según carpetas.
Componentes y relaciones
a. Nivel1 – Builder
• Componentes:
• PizzaMaster (Director)
• PizzaBuilder (<<interface>>)
• HawaiianPizzaBuilder, PepperoniPizzaBuilder, VeganPizzaBuilder (Builders concretos)
• Pizza (modelo) + enums
• Flujo:
Cliente (Main) → invoca PizzaMaster.setBuilder(builder) → PizzaMaster.build() → builder.build() → devuelve Pizza
• Anotaciones: marca “Builder Pattern”.
b. Nivel2 – Observer
• Componentes:
• StockExchange (<<interface>>)
• ConcreteStockExchange (sujeto)
• Broker (<<interface>>)
• ConcreteBroker (observador)
• ChangeSymbolFormatter (utilidad)
• Flujo:
ConcreteStockExchange.addBroker(broker)
ConcreteStockExchange.setQuote(…) → notifyBrokers() → ConcreteBroker.update(index, value, change)
• Anotaciones: marca “Observer Pattern”.
c. Nivel3 – Callback
• Componentes:
• PaymentMethod (<<functional interface>>)
• CreditCardPayment, PaypalPayment, BankTransfer (implementaciones)
• PaymentGateway (recibe PaymentMethod y monto, invoca pay())
• ShoeStore (modelo + cliente de pasarela)
• Customer, Shoe, Purchase (modelos de dominio)
• Flujo:
ShoeStore.createPurchase(...) → PaymentGateway.process(paymentMethod, amount) → paymentMethod.pay(amount) (callback) → regresa control
• Anotaciones: marca “Callback Pattern”.
Guía para el diagrama
• Usa rectángulos para componentes, interfaces con estereotipo «<<interface>>».
• Forma de flechas:
• Línea continua con punta de flecha normal para llamadas de método (build(), setQuote(), pay()).
• Línea punteada con punta de flecha abierta para dependencias.
• Interfaces (por ejemplo, PaymentMethod, PizzaBuilder, Broker, StockExchange) en azul claro.
• Clases concretas en verde.
• Modelos de dominio (Pizza, Customer, Purchase, Shoe) en amarillo.
• Utilidades (ChangeSymbolFormatter) en gris.
• Agrupa cada nivel en un contenedor con nombre y título del patrón.
• Añade etiquetas a las flechas indicando el nombre del método invocado y el sentido del flujo.
Puntos clave de detalle
• Muestra paquetes (nombres de carpetas) como agrupaciones lógicas.
• Resalta el “Director” en Builder y el “Sujeto” vs “Observador” en Observer.
• Indica que PaymentGateway no conoce la implementación concreta de PaymentMethod (dependency inversion).
• No olvides anotar el main() en cada nivel como punto de arranque.
Elementos de claridad
• Títulos claros para cada grupo de componentes.
• Flechas con etiquetas.
• Leyenda con colores y estereotipos.
• Notas o callouts breves que indiquen el patrón usado en cada subsistema.
Con esta estructura, el diagrama ofrecerá una visión clara de los tres ejercicios independientes y resaltará las partes esenciales de cada patrón de diseño empleado.