# bhawana-dahal/java-calculator architecture

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

- Interactive diagram: https://gitdiagram.com/bhawana-dahal/java-calculator
- Repository: https://github.com/bhawana-dahal/java-calculator

## Overview

This is a Java Swing reverse-Polish natural-number calculator organized around MVC. A user operates the two displayed operands through the view; the view dispatches events to the controller, which coordinates model changes and display updates. The documented operation set includes arithmetic, power, root, digit entry, clear, swap, and enter. The supplied controller and view implementations contain TODOs, and model getters are unfinished, so the code shown does not yet realize the full documented workflow. Wiring and event-dispatch edges are supported by excerpts; no external service or persistent store is shown.

Main entry points: [`NNCalcView1.java`](https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcView1.java) (Swing Calculator View), [`NNCalcController1.java`](https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcController1.java) (Calculator Controller), [`NaturalNumberCalculator.java`](https://github.com/bhawana-dahal/java-calculator/blob/main/NaturalNumberCalculator.java) (Application Setup), [`NNCalcModel1.java`](https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcModel1.java) (Operand Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_view["Swing Calculator View<br/>[NNCalcView1.java]"]
  node_view_contract["View Contract<br/>[NNCalcView.java]"]
end

subgraph group_control["Calculation Control"]
  node_controller["Calculator Controller"]
  node_controller_contract["Controller Contract"]
end

subgraph group_state["Operand State"]
  node_model["Operand Model<br/>[NNCalcModel1.java]"]
  node_model_contract["Model Contract<br/>[NNCalcModel.java]"]
end

node_user(("Calculator User"))
node_app["Application Setup"]
node_natural_number["NaturalNumber Library"]

node_user -->|"presses buttons"| node_view
node_app -->|"creates"| node_model
node_app -->|"creates"| node_view
node_app -->|"creates"| node_controller
node_app -->|"registers controller"| node_view
node_view -->|"dispatches events"| node_controller
node_controller -->|"reads and updates"| node_model
node_controller -->|"refreshes display"| node_view
node_controller -->|"implements"| node_controller_contract
node_view -->|"implements"| node_view_contract
node_model -->|"implements"| node_model_contract
node_model -->|"stores operands as"| node_natural_number
node_view -->|"displays values as"| node_natural_number
node_controller -->|"uses arithmetic values"| node_natural_number

click node_app "https://github.com/bhawana-dahal/java-calculator/blob/main/NaturalNumberCalculator.java"
click node_view "https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcView1.java"
click node_view_contract "https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcView.java"
click node_controller "https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcController1.java"
click node_controller_contract "https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcController.java"
click node_model "https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcModel1.java"
click node_model_contract "https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcModel.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_view,node_view_contract,node_user toneBlue
class node_controller,node_controller_contract toneAmber
class node_model,node_model_contract toneMint
class node_app toneTeal
class node_natural_number toneIndigo
```

## Components

### User Interface

- [Swing Calculator View](https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcView1.java): `NNCalcView1.java`
- [View Contract](https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcView.java): `NNCalcView.java`

### Calculation Control

- [Calculator Controller](https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcController1.java): `NNCalcController1.java`
- [Controller Contract](https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcController.java): `NNCalcController.java`

### Operand State

- [Operand Model](https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcModel1.java): `NNCalcModel1.java`
- [Model Contract](https://github.com/bhawana-dahal/java-calculator/blob/main/NNCalcModel.java): `NNCalcModel.java`

### Other components

- **Calculator User**
- [Application Setup](https://github.com/bhawana-dahal/java-calculator/blob/main/NaturalNumberCalculator.java): `NaturalNumberCalculator.java`
- **NaturalNumber Library**

## Connections

- Calculator User → Swing Calculator View: presses buttons (evidence: `NNCalcView1.java`)
- Application Setup → Operand Model: creates (evidence: `NaturalNumberCalculator.java`)
- Application Setup → Swing Calculator View: creates (evidence: `NaturalNumberCalculator.java`)
- Application Setup → Calculator Controller: creates (evidence: `NaturalNumberCalculator.java`)
- Application Setup → Swing Calculator View: registers controller (evidence: `NaturalNumberCalculator.java`)
- Swing Calculator View → Calculator Controller: dispatches events (evidence: `NNCalcView1.java`)
- Calculator Controller → Operand Model: reads and updates (evidence: `NNCalcController1.java`)
- Calculator Controller → Swing Calculator View: refreshes display (evidence: `NNCalcController1.java`)
- Calculator Controller → Controller Contract: implements (evidence: `NNCalcController1.java`)
- Swing Calculator View → View Contract: implements (evidence: `NNCalcView1.java`)
- Operand Model → Model Contract: implements (evidence: `NNCalcModel1.java`)
- Operand Model → NaturalNumber Library: stores operands as (evidence: `NNCalcModel1.java`)
- Swing Calculator View → NaturalNumber Library: displays values as (evidence: `NNCalcView1.java`)
- Calculator Controller → NaturalNumber Library: uses arithmetic values (evidence: `NNCalcController1.java`)
