# em3rc0d/designpatternsdsi architecture

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

- Interactive diagram: https://gitdiagram.com/em3rc0d/designpatternsdsi
- Repository: https://github.com/em3rc0d/designpatternsdsi

## Overview

##### Project Type and Purpose
- This is a **standalone Java Swing desktop application** (“Tienda Online de Electrónicos”) designed to demonstrate and teach advanced object-oriented design patterns in the context of a simple online store.
- It’s **not** a distributed microservice system but a modular single-process app structured into logical layers and pattern-specific packages.

##### File Structure
- Top-level build files: `pom.xml`, Maven wrapper.
- `src/main/java/design_patterns` is split into subpackages by pattern:
- `gui` – GUI entry point (`OnlineStoreApp`, `StoreGUI`)
- `model` – Product entities (`Laptop`, `Smartphone`, etc.)
- `factory` & `brandFactory` – Factory Method and Abstract Factory
- `builder` – ProductBuilder
- `decorator` – WarrantyDecorator, ProductDecorator
- `adapter` – PaymentAdapter, ExternalPaymentService, Payment interface
- `singleton` – CartManager
- No external database or web server; state is held in memory.

##### README for Additional Insights
- Lists all patterns: Singleton, Factory Method, Abstract Factory, Builder, Adapter, Decorator.
- GUI driven by Java Swing.
- Simulated external payment via an Adapter wrapping an `ExternalPaymentService`.

##### Components
a. **GUI Layer**
- Component: **StoreGUI** (Swing frames, panels, event handlers)
- Component: **OnlineStoreApp** (main)
b. **Domain / Business Logic Layer**
- **Model**: Product, Laptop, Smartphone, Tablet, Smartwatch
- **Singleton**: CartManager (holds selected products and total)
- **Factory Packages**
- `ProductFactory` (Factory Method)
- `BrandFactory` (Abstract Factory)
- **Builder**: ProductBuilder (construct complex product instances)
- **Decorator**: ProductDecorator, WarrantyDecorator (dynamically extend products)
c. **Integration / External Services**
- **Adapter**: PaymentAdapter implements Payment → wraps ExternalPaymentService
- **ExternalPaymentService**: simulates remote payment gateway

##### Relationships and Interactions
- StoreGUI instantiates products via factories or builder, then calls `CartManager.getInstance().add(product)`
- CartManager notifies GUI to refresh total (pull by GUI or event callback).
- On “Process Payment”: GUI calls `PaymentAdapter.pay(amount)`, which delegates to `ExternalPaymentService.process(amount)`.
- Decorator can be applied before adding to cart (e.g., `new WarrantyDecorator(baseProduct)`).

##### Architectural Patterns & Principles
- **Layering**:
- Presentation (GUI)
- Domain / Business Logic (models, CartManager, factories, builders, decorators)
- Integration / Infrastructure (adapter, external service)
- **Design Patterns**: each package is a self-contained implementation of its pattern.
- **Single Responsibility**: GUI only handles UI; CartManager only handles cart state.

##### Technologies, Frameworks, Libraries
- **Java SE**
- **Java Swing** (GUI)
- **Maven** (build)
- No database / persistence layer

##### Essential Elements
- **Component Labels**: StoreGUI, OnlineStoreApp, CartManager, ProductFactory, BrandFactory, ProductBuilder, WarrantyDecorator, PaymentAdapter, ExternalPaymentService
- GUI → Factories / Builder (product creation)
- GUI → CartManager (add/remove/empty)
- GUI → PaymentAdapter (process payment)
- PaymentAdapter → ExternalPaymentService (delegate payment)
- **Annotations**: Pattern names next to each component (e.g., «Singleton» CartManager)

## Diagram (Mermaid)

```mermaid
graph TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        OnlineStoreApp["OnlineStoreApp"]:::frontend
        StoreGUI["StoreGUI"]:::frontend
    end

    %% Domain Layer
    subgraph "Domain / Business Logic Layer"
        direction TB
        subgraph "Models"
            direction TB
            Product["Product"]:::domain
            Laptop["Laptop"]:::domain
            Smartphone["Smartphone"]:::domain
            Tablet["Tablet"]:::domain
            Smartwatch["Smartwatch"]:::domain
        end
        subgraph "Factory Module"
            direction TB
            ProductFactory["ProductFactory\n«Factory Method»"]:::domain
            LaptopFactory["LaptopFactory"]:::domain
            SmartphoneFactory["SmartphoneFactory"]:::domain
            TabletFactory["TabletFactory"]:::domain
            SmartwatchFactory["SmartwatchFactory"]:::domain
            BrandFactory["BrandFactory\n«Abstract Factory»"]:::domain
            AppleFactory["AppleFactory"]:::domain
        end
        ProductBuilder["ProductBuilder\n«Builder»"]:::domain
        subgraph "Decorator Module"
            direction TB
            ProductDecorator["ProductDecorator\n«Decorator»"]:::domain
            WarrantyDecorator["WarrantyDecorator"]:::domain
        end
        CartManager["CartManager\n«Singleton»"]:::domain
    end

    %% Integration Layer
    subgraph "Integration / Infrastructure Layer"
        direction TB
        PaymentAdapter["PaymentAdapter\n«Adapter»"]:::integration
        ExternalPaymentService["ExternalPaymentService"]:::integration
    end

    %% Interactions
    OnlineStoreApp -->|"launch()"| StoreGUI
    StoreGUI -->|"createProduct()"| ProductFactory
    StoreGUI -->|"createBrandProduct()"| BrandFactory
    StoreGUI -->|"buildProduct()"| ProductBuilder
    StoreGUI -->|"decorate()"| WarrantyDecorator
    WarrantyDecorator -->|"extends"| Product
    StoreGUI -->|"add(product)"| CartManager
    CartManager -.->|"notifyRefresh()"| StoreGUI
    StoreGUI -->|"processPayment(amount)"| PaymentAdapter
    PaymentAdapter -->|"process(amount)"| ExternalPaymentService

    %% Click Events
    click StoreGUI "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/GUI/StoreGUI.java"
    click OnlineStoreApp "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/GUI/OnlineStoreApp.java"
    click Product "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/model/Product.java"
    click Laptop "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/model/Laptop.java"
    click Smartphone "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/model/Smartphone.java"
    click Tablet "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/model/Tablet.java"
    click Smartwatch "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/model/Smartwatch.java"
    click CartManager "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/singleton/CartManager.java"
    click ProductFactory "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/factory/ProductFactory.java"
    click LaptopFactory "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/factory/LaptopFactory.java"
    click SmartphoneFactory "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/factory/SmartphoneFactory.java"
    click TabletFactory "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/factory/TabletFactory.java"
    click SmartwatchFactory "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/factory/SmartwatchFactory.java"
    click BrandFactory "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/factory/BrandFactory.java"
    click AppleFactory "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/factory/AppleFactory.java"
    click ProductBuilder "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/builder/ProductBuilder.java"
    click ProductDecorator "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/decorator/ProductDecorator.java"
    click WarrantyDecorator "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/decorator/WarrantyDecorator.java"
    click PaymentAdapter "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/adapter/PaymentAdapter.java"
    click ExternalPaymentService "https://github.com/em3rc0d/designpatternsdsi/blob/main/src/main/java/design_patterns/adapter/ExternalPaymentService.java"

    %% Styles
    classDef frontend fill:#D0E1FF,stroke:#0366d6
    classDef domain fill:#DFFFE0,stroke:#228B22
    classDef integration fill:#FFE3B3,stroke:#FF8C00
```
