# kasroudra/simplecalculator architecture

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

- Interactive diagram: https://gitdiagram.com/kasroudra/simplecalculator
- Repository: https://github.com/kasroudra/simplecalculator

## Overview

##### Project type and purpose
- This is a self-contained Android mobile application (“Simple Android Calculator”)
- Purpose: Provide basic and advanced calculator functions (add, subtract, multiply, divide, percentage, logarithm, exponential, root, sin, cos, tan) via a single Activity

##### File structure
- Top-level files:
– AndroidManifest.xml: declares app entry, permissions, application/Activity configuration
– project.properties, proguard-project.txt, libs/android-support-v4.jar: build and compatibility support
- /res: resource subfolders
– /layout: XML definitions of UI screens (activity_calculator.xml, calculator.xml)
– /drawable: custom button backgrounds and ripple definitions
– /menu: overflow menu layout (About, Close)
- /src/com/kasroudra/kascalc/Calculator.java: the sole Java source file, implementing the Activity and calculator logic

##### Examination of README
- Confirms single-Activity architecture
- No external services, no network calls, no database – purely in-memory computation
- UI uses round buttons with ripple effect and an About menu via Android’s Toast

##### Main components
a. UI Layer
– Activity (Calculator.java)
– Layout XML resources (activity_calculator.xml)
– Custom Drawable resources (custombutton.xml, etc.)
b. Business-Logic Layer
– In-class computation methods (add, sub, mul, div, etc.)
– Input parsing and output formatting
c. Android Framework Layer
– Android SDK (Activity lifecycle, View rendering)
– Support v4 library for backwards compatibility
– Resource manager (inflates XML, applies styles)
d. External Dependencies
– None (all computation and UI are in-app)

##### Relationships and data flows
– User taps a button → Event propagated to Activity (onClick handler) → Activity invokes Business-Logic methods → Computation result returned → Activity updates View (TextView/display)
– Menu selection “About” or “Close” → Activity triggers Toast or finish()
– Activity lifecycle events (onCreate, onPause) managed by Android OS

##### Architectural patterns and design principles
– Light MVC or “Thin-View/Controller” pattern:
- View: XML layouts and drawables
- Controller: Calculator Activity handles user events and view updates
- Model: Inline methods in Activity or a dedicated helper class for arithmetic functions
– Single responsibility per component:
- XML for UI structure/style
- Java for behavior/logic

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors
    User["User"]:::external

    %% Android Framework Layer
    subgraph "Android Framework Layer"
        AndroidOS["Android OS / Dalvik"]:::framework
        AndroidSDK["Android SDK"]:::framework
        SupportLib["Support Lib (android-support-v4.jar)"]:::framework
    end

    AndroidOS --> AndroidSDK
    AndroidSDK --> SupportLib

    %% Application Layer (APK)
    AndroidSDK --> APK["APK (SimpleCalculator)"]:::app
    APK --> AndroidManifest

    click SupportLib "https://github.com/kasroudra/simplecalculator/blob/main/libs/android-support-v4.jar"

    %% Manifest
    AndroidManifest["AndroidManifest.xml"]:::config
    click AndroidManifest "https://github.com/kasroudra/simplecalculator/blob/main/AndroidManifest.xml"

    %% Application Components
    subgraph "Application (APK)" 
        RM[(Resource Manager)]:::resource
        Activity["Calculator Activity"]:::controller
        BizLogic["Business Logic Module"]:::logic

        RM --> activity_layouts
        RM --> drawable_resources
        RM --> menu_resources
        RM --> values_resources
        RM --> mipmap_resources
        RM --> config_files
    end

    APK --> RM
    APK --> Activity
    APK --> BizLogic

    %% Resource subdivisions
    subgraph "Layout Resources" 
        direction TB
        activity_layouts["activity_calculator.xml"]:::resource
        calculator_layout["calculator.xml"]:::resource
    end
    click activity_layouts "https://github.com/kasroudra/simplecalculator/blob/main/res/layout/activity_calculator.xml"
    click calculator_layout "https://github.com/kasroudra/simplecalculator/blob/main/res/layout/calculator.xml"

    subgraph "Drawable Resources"
        direction TB
        cb1["custombutton.xml"]:::resource
        cb2["custombutton2.xml"]:::resource
        cb3["custombutton3.xml"]:::resource
        rb["redbutton.xml"]:::resource
        roundb["roundbutton.xml"]:::resource
    end
    click cb1 "https://github.com/kasroudra/simplecalculator/blob/main/res/drawable/custombutton.xml"
    click cb2 "https://github.com/kasroudra/simplecalculator/blob/main/res/drawable/custombutton2.xml"
    click cb3 "https://github.com/kasroudra/simplecalculator/blob/main/res/drawable/custombutton3.xml"
    click rb "https://github.com/kasroudra/simplecalculator/blob/main/res/drawable/redbutton.xml"
    click roundb "https://github.com/kasroudra/simplecalculator/blob/main/res/drawable/roundbutton.xml"

    subgraph "Menu Resource"
        menu["activity_calculator.xml"]:::resource
    end
    click menu "https://github.com/kasroudra/simplecalculator/blob/main/res/menu/activity_calculator.xml"

    subgraph "Values Resources"
        colors["colors.xml"]:::resource
        strings["strings.xml"]:::resource
        styles_base["styles.xml"]:::resource
        styles_v11["styles.xml (v11)"]:::resource
        styles_v14["styles.xml (v14)"]:::resource
    end
    click colors "https://github.com/kasroudra/simplecalculator/blob/main/res/values/colors.xml"
    click strings "https://github.com/kasroudra/simplecalculator/blob/main/res/values/strings.xml"
    click styles_base "https://github.com/kasroudra/simplecalculator/blob/main/res/values/styles.xml"
    click styles_v11 "https://github.com/kasroudra/simplecalculator/blob/main/res/values-v11/styles.xml"
    click styles_v14 "https://github.com/kasroudra/simplecalculator/blob/main/res/values-v14/styles.xml"

    subgraph "Mipmap Resources"
        mipmaps["res/mipmap-*"]:::resource
    end
    click mipmaps "https://github.com/kasroudra/simplecalculator/tree/main/res/mipmap-hdpi/"

    subgraph "Build & Config Files"
        projectProps["project.properties"]:::config
        proguard["proguard-project.txt"]:::config
    end
    click projectProps "https://github.com/kasroudra/simplecalculator/blob/main/project.properties"
    click proguard "https://github.com/kasroudra/simplecalculator/blob/main/proguard-project.txt"

    %% Interactions
    User -->|"tap button (onClick)"| Activity
    Activity -->|"compute()"| BizLogic
    BizLogic -->|"result"| Activity
    Activity -->|"inflate()"| RM
    Activity -->|"setText()"| RM
    AndroidSDK -->|"lifecycle events"| Activity

    %% Click Activity
    click Activity "https://github.com/kasroudra/simplecalculator/blob/main/src/com/kasroudra/kascalc/Calculator.java"

    %% Styles
    classDef external fill:#dddddd,stroke:#888888
    classDef framework fill:#f2f2f2,stroke:#bbbbbb
    classDef app fill:#cce5ff,stroke:#66a3ff
    classDef controller fill:#d4edda,stroke:#28a745
    classDef logic fill:#e2f0d9,stroke:#7bb661
    classDef resource fill:#ffe5cc,stroke:#ff9933
    classDef config fill:#f0e6ff,stroke:#b399ff
```
