# opficdev/swiftui_calculator architecture

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

- Interactive diagram: https://gitdiagram.com/opficdev/swiftui_calculator
- Repository: https://github.com/opficdev/swiftui_calculator

## Overview

##### Project type and purpose
- This is a native iOS calculator app built in SwiftUI using the MVVM pattern.
- Front‑end: SwiftUI views. Back‑end: Swift model/business logic.
- Features: basic & scientific modes, history persistence via UserDefaults, orientation detection, operator precedence via a stack.

##### File structure
- Top level:
- Calculator.xcodeproj (Xcode project files)
- Calculator/ (app source )
– CalculatorApp.swift (app entry point)
– ContentView.swift (root SwiftUI view)
– Info.plist (app config)
– Image/ (static images)
– Model/ (data structures & business logic)
– View/ (UI components)
– ViewModel/ (presentation logic)
– Preview Content/ (Xcode previews)

- Third‑party:
- RxSwift integrated via SwiftPM (seen under xcshareddata/swiftpm).
- Persistence:
- UserDefaults used to store and retrieve history.

##### Key architectural insights from the README
- MVVM is the chosen pattern.
- RxSwift powers asynchronous change‑detection in both calculation results and device orientation.
- A stack data structure implements operator precedence.
- History stored in in‑app memory (UserDefaults), exposed via RxSwift observables to the View.

a. Main components
- iOS Platform Layer
- App Entry (CalculatorApp)
- SwiftUI View Layer (ContentView → PortraitView, LandscapeView, ModeView, HistoryView, ButtonLabelView)
- ViewModel Layer (CalculatorViewModel, HistoryViewModel, OrientationViewModel)
- Model Layer (BtnGrid, BtnType, Token, History, iPhonePointRes, CalculationEngine/Stack)
- Service Layer
– PersistenceService (wraps UserDefaults)
– OrientationService (wraps device orientation events)
- External Library: RxSwift

b. Interactions & data flow
1. App Launch → CalculatorApp initializes root ContentView
2. ContentView binds to CalculatorViewModel & OrientationViewModel
3. User taps a button → View sends event to CalculatorViewModel
4. CalculatorViewModel updates Model (uses CalculationEngine + stack)
5. Model emits new result/history via RxSwift observables
6. PersistenceService saves history to UserDefaults
7. HistoryViewModel observes changes in PersistenceService → updates HistoryView
8. OrientationService observes device rotation via RxSwift → OrientationViewModel → View updates UI layout

c. Architectural patterns & principles
- MVVM separation of concerns: Views only do layout & binding; ViewModels hold all UI state & logic; Models encapsulate pure business logic.
- Reactive programming with RxSwift: unidirectional, observable streams for both calculation state and orientation events.
- Single‐source‐of‐truth for history in PersistenceService (UserDefaults wrapper).

d. Key technologies & frameworks
- SwiftUI for declarative UI
- RxSwift for asynchronous/event handling
- UserDefaults for lightweight persistence
- Xcode/Swift Package Manager for dependency management

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer" 
        direction TB
        AppEntry["CalculatorApp"]:::ui
        ContentView["ContentView"]:::ui
        PortraitView["PortraitView"]:::ui
        LandscapeView["LandscapeView"]:::ui
        ModeView["ModeView"]:::ui
        HistoryView["HistoryView"]:::ui
        ButtonLabelView["ButtonLabelView"]:::ui
    end

    %% ViewModel Layer
    subgraph "ViewModel Layer"
        direction TB
        CalcVM["CalculatorViewModel"]:::viewmodel
        HistVM["HistoryViewModel"]:::viewmodel
        OrientVM["OrientationViewModel"]:::viewmodel
    end

    %% Model & Service Layer
    subgraph "Model & Service Layer"
        direction TB
        BtnGrid["BtnGrid"]:::model
        BtnType["BtnType"]:::model
        Token["Token"]:::model
        HistoryModel["History"]:::model
        iPhonePointRes["iPhonePointRes"]:::model
        CalcEngine["CalculationEngine (Stack)"]:::model
        OrientationService["OrientationService"]:::service
    end

    %% External Libraries
    subgraph "External Libraries"
        direction TB
        RxSwift["RxSwift"]:::external
    end

    %% Connections
    AppEntry -->|launch| ContentView
    ContentView -->|binds to| CalcVM
    ContentView -->|binds to| OrientVM
    ContentView -->|renders| PortraitView
    ContentView -->|renders| LandscapeView
    ContentView -->|renders| ModeView
    ContentView -->|renders| HistoryView
    ContentView -->|renders| ButtonLabelView

    ContentView -->|"onButtonTap()"| CalcVM
    CalcVM -->|"execute()"| CalcEngine
    CalcEngine -.->|"onNext(result)"| CalcVM
    CalcVM -->|"updateHistory()"| HistVM
    HistVM -->|"save to UserDefaults"| HistVM
    OrientVM -->|"updateLayout()"| ContentView
    OrientationService -.->|"onNext(orientation)"| OrientVM

    RxSwift -.-> CalcVM
    RxSwift -.-> HistVM
    RxSwift -.-> OrientVM
    RxSwift -.-> OrientationService
    RxSwift -.-> CalcEngine

    %% Click Events
    click AppEntry "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/CalculatorApp.swift"
    click ContentView "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/ContentView.swift"
    click PortraitView "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/View/PortraitView.swift"
    click LandscapeView "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/View/LandscapeView.swift"
    click ModeView "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/View/ModeView.swift"
    click HistoryView "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/View/HistoryView.swift"
    click ButtonLabelView "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/View/ButtonLabelView.swift"
    click CalcVM "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/ViewModel/CalculatorViewModel.swift"
    click HistVM "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/ViewModel/HistoryViewModel.swift"
    click OrientVM "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/ViewModel/OrientationViewModel.swift"
    click BtnGrid "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/Model/BtnGrid.swift"
    click BtnType "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/Model/BtnType.swift"
    click Token "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/Model/Token.swift"
    click HistoryModel "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/Model/History.swift"
    click iPhonePointRes "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator/Model/iPhonePointRes.swift"
    click RxSwift "https://github.com/opficdev/swiftui_calculator/blob/main/Calculator.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved"

    %% Styles
    classDef ui fill:#E3F2FD,stroke:#2196F3,color:#0D47A1
    classDef viewmodel fill:#E8F5E9,stroke:#4CAF50,color:#1B5E20
    classDef model fill:#FFF3E0,stroke:#FB8C00,color:#E65100
    classDef service fill:#F3E5F5,stroke:#9C27B0,color:#4A148C
    classDef external fill:#ECEFF1,stroke:#90A4AE,color:#455A64
```
