# wameeee/calculator architecture

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

- Interactive diagram: https://gitdiagram.com/wameeee/calculator
- Repository: https://github.com/wameeee/calculator

## Overview

##### Project type and purpose
- This is a small Java CLI “calculator” application demonstrating the Factory Method pattern. It isn’t a multi-tier web app or microservice; it’s a design-pattern‐focused tool with a single client (Calculator.java), a family of factories, and a family of products (operation implementations).

##### File structure
- Top-level: `Calculator.java` acts as the client.
- `factory` package: contains the `OperationFactory` interface plus concrete factories (`AddFactory`, `SubtractFactory`, `MultiplyFactory`, `DivideFactory`, `ModuloFactory`) and `FactoryProducer`.
- `operation` package: contains the `Operation` interface plus concrete products (`AddOperation`, `SubtractOperation`, `MultiplyOperation`, `DivideOperation`, `ModuloOperation`).

##### README
- Confirms use of Factory Method (creating products via factory subtypes).
- Describes each component’s role (product interface vs. concrete products, factory interface vs. concrete factories, the producer, and the client).

##### Detailed elements
- Component names and stereotypes («interface», «class»).
- Method signatures where relevant (e.g., `OperationFactory.createOperation()`, `Operation.compute(int,int)`).
- Data flow: user input → Calculator → FactoryProducer → ConcreteFactory → ConcreteOperation → result back to Calculator → console output.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client
    Calculator["Calculator «class»"]:::client

    %% Factory package
    subgraph "factory package"
        FactoryProducer["FactoryProducer «class»"]:::factory
        OperationFactory["OperationFactory «interface»"]:::interface
        AddFactory["AddFactory «class»"]:::factory
        SubtractFactory["SubtractFactory «class»"]:::factory
        MultiplyFactory["MultiplyFactory «class»"]:::factory
        DivideFactory["DivideFactory «class»"]:::factory
        ModuloFactory["ModuloFactory «class»"]:::factory
    end

    %% Operation package
    subgraph "operation package"
        Operation["Operation «interface»"]:::interface
        AddOperation["AddOperation «class»"]:::operation
        SubtractOperation["SubtractOperation «class»"]:::operation
        MultiplyOperation["MultiplyOperation «class»"]:::operation
        DivideOperation["DivideOperation «class»"]:::operation
        ModuloOperation["ModuloOperation «class»"]:::operation
    end

    %% Relationships
    Calculator -->|"getFactory()→OperationFactory"| FactoryProducer
    FactoryProducer -->|"returns OperationFactory"| OperationFactory
    Calculator -->|"createOperation()"| OperationFactory
    OperationFactory -->|"creates Operation"| Operation
    Calculator -->|"compute(a,b)"| Operation
    Operation -->|"returns result"| Calculator

    %% Implements relationships
    AddFactory -.->|«implements»| OperationFactory
    SubtractFactory -.->|«implements»| OperationFactory
    MultiplyFactory -.->|«implements»| OperationFactory
    DivideFactory -.->|«implements»| OperationFactory
    ModuloFactory -.->|«implements»| OperationFactory

    AddOperation -.->|«implements»| Operation
    SubtractOperation -.->|«implements»| Operation
    MultiplyOperation -.->|«implements»| Operation
    DivideOperation -.->|«implements»| Operation
    ModuloOperation -.->|«implements»| Operation

    %% Click Events
    click Calculator "https://github.com/wameeee/calculator/blob/master/src/main/java/Calculator.java"
    click FactoryProducer "https://github.com/wameeee/calculator/blob/master/src/main/java/factory/FactoryProducer.java"
    click OperationFactory "https://github.com/wameeee/calculator/blob/master/src/main/java/factory/OperationFactory.java"
    click AddFactory "https://github.com/wameeee/calculator/blob/master/src/main/java/factory/AddFactory.java"
    click SubtractFactory "https://github.com/wameeee/calculator/blob/master/src/main/java/factory/SubtractFactory.java"
    click MultiplyFactory "https://github.com/wameeee/calculator/blob/master/src/main/java/factory/MultiplyFactory.java"
    click DivideFactory "https://github.com/wameeee/calculator/blob/master/src/main/java/factory/DivideFactory.java"
    click ModuloFactory "https://github.com/wameeee/calculator/blob/master/src/main/java/factory/ModuloFactory.java"
    click Operation "https://github.com/wameeee/calculator/blob/master/src/main/java/operation/Operation.java"
    click AddOperation "https://github.com/wameeee/calculator/blob/master/src/main/java/operation/AddOperation.java"
    click SubtractOperation "https://github.com/wameeee/calculator/blob/master/src/main/java/operation/SubtractOperation.java"
    click MultiplyOperation "https://github.com/wameeee/calculator/blob/master/src/main/java/operation/MultiplyOperation.java"
    click DivideOperation "https://github.com/wameeee/calculator/blob/master/src/main/java/operation/DivideOperation.java"
    click ModuloOperation "https://github.com/wameeee/calculator/blob/master/src/main/java/operation/ModuloOperation.java"

    %% Styles
    classDef client fill:#f9f,stroke:#333,stroke-width:2px;
    classDef factory fill:#ccf,stroke:#333,stroke-width:2px;
    classDef operation fill:#cfc,stroke:#333,stroke-width:2px;
    classDef interface fill:#ffc,stroke:#333,stroke-width:2px,stroke-dasharray: 5 5;
```
