# rioacosta/s3.02--patterns-2 architecture

> Architecture diagram of the GitHub repository rioacosta/s3.02--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/rioacosta/s3.02--patterns-2
- Repository: https://github.com/rioacosta/s3.02--patterns-2

## Overview

##### Project Type and Purpose
- This is a standalone Java console application whose sole purpose is educational: to demonstrate three classic GoF design patterns (Builder, Observer, Callback). It is not a web or distributed system but a monolithic demo project.

##### File-Structure Analysis
- Top-level: README.md plus `src/main/java`.
- Under `src/main/java` you have three sibling packages:
- builder – the Builder-pattern demo
- observer – the Observer-pattern demo
- callback – the Callback-pattern demo
- Each package follows the same micro-structure:
– A Main.java (or StartDemo.java) as entry point
– Subpackages for entities/models, interfaces, concrete implementations, and “director” or “logic” classes

##### Key README Insights
- Three “levels,” each mapping to one pattern demo:
1. Builder → pizza order system
2. Observer → stock‐market notifications
3. Callback → payment gateway for a shoe store
- Java 21, console execution

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Builder Pattern Subsystem
    subgraph "Builder Pattern"
        direction TB
        StartDemo_Builder["StartDemo (Entry)"]:::builder
        Main_Builder["Main"]:::builder
        Director["PizzaMasterDirector"]:::director
        PizzaBuilder["«interface» PizzaBuilder"]:::builderInterface
        PizzaDeluxe["PizzaDeluxeBuilder"]:::builder
        PizzaMenu["PizzaMenuBuilder"]:::builder
        Pizza["Pizza"]:::builder

        StartDemo_Builder -->|"invokes main()"| Main_Builder
        Main_Builder -->|"uses"| Director
        Director -->|"buildPizza() calls"| PizzaBuilder
        PizzaBuilder -->|"implemented by"| PizzaDeluxe
        PizzaBuilder -->|"implemented by"| PizzaMenu
        PizzaDeluxe -->|"build() returns"| Pizza
        PizzaMenu -->|"build() returns"| Pizza
    end

    %% Observer Pattern Subsystem
    subgraph "Observer Pattern"
        direction TB
        StartDemo_Observer["StartDemo (Entry)"]:::observer
        Main_Observer["Main"]:::observer
        StockAgency["StockAgency"]:::observer
        StockListener["«interface» StockListener"]:::observerInterface
        StockObserver["StockMarketObserver"]:::observer

        StartDemo_Observer -->|"invokes main()"| Main_Observer
        Main_Observer -->|"attach() registers"| StockAgency
        StockAgency -.->|"notifies() on change"| StockListener
        StockListener -->|"implemented by"| StockObserver
    end

    %% Callback Pattern Subsystem
    subgraph "Callback Pattern"
        direction TB
        Main_Callback["Main"]:::callback
        DemoApp["DemoApp"]:::callback
        TheShoeStore["TheShoeStore"]:::callback
        PaymentIntermediary["PaymentIntermediary"]:::callback
        PaymentCallBack["«interface» PaymentCallBack"]:::callbackInterface
        PaymentMethod["«interface» PaymentMethod"]:::callbackInterface
        CreditCard["CreditCardPayment"]:::callback
        PayPal["PayPalPayment"]:::callback
        BankTransfer["BankTransferPayment"]:::callback

        Main_Callback -->|"runs"| DemoApp
        DemoApp -->|"creates"| TheShoeStore
        TheShoeStore -->|"calls pay(callback)"| PaymentIntermediary
        PaymentIntermediary -->|"executes pay() on"| PaymentMethod
        PaymentMethod -->|"implemented by"| CreditCard
        PaymentMethod -->|"implemented by"| PayPal
        PaymentMethod -->|"implemented by"| BankTransfer
        PaymentIntermediary -->|"invokes callback() on"| PaymentCallBack
    end

    %% Click events for Builder module
    click StartDemo_Builder "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/builder/demoApp/StartDemo.java"
    click Main_Builder "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/builder/Main.java"
    click Pizza "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/builder/pizzaAndPizzaBuilder/Pizza.java"
    click PizzaBuilder "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/builder/pizzaAndPizzaBuilder/PizzaBuilder.java"
    click PizzaDeluxe "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/builder/specificBuilders/PizzaDeluxeBuilder.java"
    click PizzaMenu "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/builder/specificBuilders/PizzaMenuBuilder.java"
    click Director "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/builder/directorBuilder/PizzaMasterDirector.java"

    %% Click events for Observer module
    click StartDemo_Observer "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/observer/demoApp/StartDemo.java"
    click Main_Observer "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/observer/Main.java"
    click StockAgency "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/observer/entities/StockAgency.java"
    click StockListener "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/observer/interfaces/StockListener.java"
    click StockObserver "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/observer/entities/StockMarketObserver.java"

    %% Click events for Callback module
    click Main_Callback "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/callback/Main.java"
    click PaymentIntermediary "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/callback/entities/PaymentIntermediary.java"
    click PaymentCallBack "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/callback/interfaces/PaymentCallBack.java"
    click PaymentMethod "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/callback/interfaces/PaymentMethod.java"
    click CreditCard "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/callback/entities/CreditCardPayment.java"
    click PayPal "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/callback/entities/PayPalPayment.java"
    click BankTransfer "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/callback/entities/BankTransferPayment.java"
    click DemoApp "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/callback/logic/DemoApp.java"
    click TheShoeStore "https://github.com/rioacosta/s3.02--patterns-2/blob/master/src/main/java/callback/logic/TheShoeStore.java"

    %% Styles
    classDef builder fill:#D0E8FF,stroke:#005BBB,color:#005BBB;
    classDef builderInterface fill:#E6F2FF,stroke:#3399FF,color:#3399FF,stroke-dasharray: 5 5;
    classDef director fill:#B3D9FF,stroke:#0073E6,color:#0073E6,shape:diamond;
    classDef observer fill:#DFF2D8,stroke:#4CAF50,color:#4CAF50;
    classDef observerInterface fill:#EDFFED,stroke:#8BC34A,color:#8BC34A,stroke-dasharray: 5 5;
    classDef callback fill:#FFE8CC,stroke:#FF9800,color:#FF9800;
    classDef callbackInterface fill:#FFF3E0,stroke:#FFB74D,color:#FFB74D,stroke-dasharray: 5 5;
```
