# jusep1983/s302_patterns_2 architecture

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

- Interactive diagram: https://gitdiagram.com/jusep1983/s302_patterns_2
- Repository: https://github.com/jusep1983/s302_patterns_2

## Overview

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) + Hawai­ianPizzaBuilder, 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>>)
- Hawai­ianPizzaBuilder, 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.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Nivel 1 - Builder Pattern
    subgraph "Nivel 1 - Builder Pattern"
        direction TB
        subgraph " Paquete builders"
            direction TB
            PB["<<interface>> PizzaBuilder"]:::interface
            HB["HawaiianPizzaBuilder"]:::concrete
            PPB["PepperoniPizzaBuilder"]:::concrete
            VB["VeganPizzaBuilder"]:::concrete
        end
        subgraph " Paquete director"
            direction TB
            PM["PizzaMaster (Director)"]:::concrete
        end
        subgraph " Paquete model"
            direction TB
            PZ["Pizza"]:::model
            PS["PizzaSize"]:::model
            PD["PizzaDough"]:::model
            PT["PizzaTopping"]:::model
        end
        M1["Main"]:::concrete
        M1 -->|"setBuilder(builder)"| PM
        PM -->|"build()"| PB
        PB -->|"build()"| PZ
    end

    %% Nivel 2 - Observer Pattern
    subgraph "Nivel 2 - Observer Pattern"
        direction TB
        subgraph " Paquete subjects"
            direction TB
            SE["<<interface>> StockExchange"]:::interface
            CSE["ConcreteStockExchange"]:::concrete
        end
        subgraph " Paquete observers"
            direction TB
            BR["<<interface>> Broker"]:::interface
            CBR["ConcreteBroker"]:::concrete
        end
        subgraph " Paquete utils"
            direction TB
            CSF["ChangeSymbolFormatter"]:::util
        end
        M2["Main"]:::concrete
        M2 -->|"addBroker(broker)"| CSE
        CSE -->|"notifyBrokers()"| CBR
        CSE -->|"setQuote()"| CSE
        CBR -->|"update(index,value,change)"| CSF
    end

    %% Nivel 3 - Callback Pattern
    subgraph "Nivel 3 - Callback Pattern"
        direction TB
        subgraph " Paquete payment"
            direction TB
            PMF["<<interface>> PaymentMethod"]:::interface
        end
        subgraph " Paquete payment/methods"
            direction TB
            BT["BankTransfer"]:::concrete
            CC["CreditCardPayment"]:::concrete
            PP["PaypalPayment"]:::concrete
        end
        subgraph " Paquete payment/gateway"
            direction TB
            PG["PaymentGateway"]:::concrete
        end
        subgraph " Paquete model"
            direction TB
            SS["ShoeStore"]:::concrete
            CU["Customer"]:::model
            SH["Shoe"]:::model
            PU["Purchase"]:::model
        end
        M3["Main"]:::concrete
        M3 -->|"createPurchase()"| SS
        SS -->|"process(method,amount)"| PG
        PG -->|"pay(amount)"| PMF
    end

    %% Click events Nivel1
    click PM "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/director/PizzaMaster.java"
    click PB "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/builders/PizzaBuilder.java"
    click HB "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/builders/HawaiianPizzaBuilder.java"
    click PPB "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/builders/PepperoniPizzaBuilder.java"
    click VB "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/builders/VeganPizzaBuilder.java"
    click PZ "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/model/Pizza.java"
    click PS "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/model/enums/PizzaSize.java"
    click PD "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/model/enums/PizzaDough.java"
    click PT "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/model/enums/PizzaTopping.java"
    click M1 "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level1/Main.java"

    %% Click events Nivel2
    click SE "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level2/subjects/StockExchange.java"
    click CSE "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level2/subjects/ConcreteStockExchange.java"
    click BR "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level2/observers/Broker.java"
    click CBR "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level2/observers/ConcreteBroker.java"
    click CSF "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level2/utils/ChangeSymbolFormatter.java"
    click M2 "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level2/Main.java"

    %% Click events Nivel3
    click PMF "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/payment/PaymentMethod.java"
    click BT "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/payment/methods/BankTransfer.java"
    click CC "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/payment/methods/CreditCardPayment.java"
    click PP "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/payment/methods/PaypalPayment.java"
    click PG "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/payment/gateway/PaymentGateway.java"
    click SS "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/model/ShoeStore.java"
    click CU "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/model/Customer.java"
    click SH "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/model/Shoe.java"
    click PU "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/model/Purchase.java"
    click M3 "https://github.com/jusep1983/s302_patterns_2/blob/main/src/main/java/level3/Main.java"

    %% Styles
    classDef interface fill:#bbdefb,stroke:#000,stroke-width:1px
    classDef concrete fill:#c8e6c9,stroke:#000,stroke-width:1px
    classDef model fill:#fff9c4,stroke:#000,stroke-width:1px
    classDef util fill:#e0e0e0,stroke:#000,stroke-width:1px
```
