# vaibhav-pant/atm-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/vaibhav-pant/atm-management-system
- Repository: https://github.com/vaibhav-pant/atm-management-system

## Overview

##### Project Type and Purpose
- This is a standalone desktop ATM Management System written in Java, using JSwing and AWT for the GUI.
- It simulates ATM operations (sign-up, login, deposit, withdraw, balance inquiry, fast cash, mini statement, PIN change) and persists data in a MySQL database.

##### Analysis of File Structure
- Top-level Java classes each correspond to a GUI screen or transaction:
- SignUp1.java, SignUp2.java, SignUp3.java – three-step user registration
- LoginPage.java – authentication screen
- deposit.java, withdraw.java, FastCash.java – cash operations
- BalanceEnq.java – balance enquiry
- MiniStatement.java – transaction history
- PinChange.java – PIN update
- transaction.java – core transaction logic
- mysql.java holds JDBC connection and query execution code.
- mysqlQueries.sql defines the database schema and initial data.
- images/ contains UI graphics.
- Two JARs for third-party dependencies: jcalendar-tz and MySQL connector.

##### Key Components
a. Presentation Layer (Swing/AWT GUIs)
- Sign-up forms, Login page, Dashboard, Transaction screens.
b. Application Logic Layer
- transaction.java orchestrates operations.
- Each Java class handles its own event listeners and invokes transaction methods.
c. Data Access Layer (DAL)
- mysql.java uses JDBC to run SQL statements defined in mysqlQueries.sql.
d. Database
- MySQL server hosting user, account, and transaction tables.
e. External Libraries
- mysql-connector-java.jar for JDBC.
- jcalendar-tz.jar for date-picker UI component.

##### Relationships and Data Flows
- User interacts with a GUI screen → Controller code in the same Java class validates input.
- Controller calls methods in transaction.java for business rules.
- transaction.java uses mysql.java to execute SQL queries via JDBC.
- JDBC returns results, which propagate back to the GUI for display.
- All screens share a single MySQL connection (or connection pool) managed by mysql.java.

##### Architectural Patterns and Principles
- Layered architecture: Presentation → Business Logic → Data Access → Database.
- Single-process monolith: all modules in one JVM.
- Separation of concerns: GUI classes vs. transaction logic vs. database connectivity.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Presentation Layer"
        SS1["SignUp1"]:::presentation
        SS2["SignUp2"]:::presentation
        SS3["SignUp3"]:::presentation
        LP["LoginPage"]:::presentation
        Dep["deposit"]:::presentation
        Wdr["withdraw"]:::presentation
        FC["FastCash"]:::presentation
        BE["BalanceEnq"]:::presentation
        MS["MiniStatement"]:::presentation
        PC["PinChange"]:::presentation
    end

    subgraph "Business Logic"
        TL["transaction.java\nCore ATM Operations"]:::business
    end

    subgraph "Data Access Layer"
        DA["mysql.java\nJDBC Connection & Query Execution"]:::dataaccess
    end

    subgraph "Database"
        DB["MySQL Database\n(users, accounts, transactions)"]:::db
        SQL["mysqlQueries.sql"]:::db
    end

    subgraph "External Libraries"
        JAR1["mysql-connector-java-8.0.28.jar"]:::external
        JAR2["jcalendar-tz-1.3.3-4.jar"]:::external
        IMGS["images/"]:::external
    end

    %% Data Flows
    SS1 -->|"validateInput()"| TL
    SS2 -->|"validateInput()"| TL
    SS3 -->|"validateInput()"| TL
    LP -->|"validateInput()"| TL
    Dep -->|"validateInput()"| TL
    Wdr -->|"validateInput()"| TL
    FC -->|"validateInput()"| TL
    BE -->|"validateInput()"| TL
    MS -->|"validateInput()"| TL
    PC -->|"validateInput()"| TL

    TL -->|"executeTransaction()"| DA
    DA -->|"SELECT/UPDATE SQL"| DB
    SQL -.->|"schema setup"| DB

    DB -->|"query results"| DA
    DA -->|"results"| TL
    TL -->|"display results"| SS1

    %% External library connections
    JAR1 --> DA
    JAR2 --> SS1
    JAR2 --> SS2
    JAR2 --> SS3
    JAR2 --> LP
    JAR2 --> Dep
    JAR2 --> Wdr
    JAR2 --> FC
    JAR2 --> BE
    JAR2 --> MS
    JAR2 --> PC
    IMGS --> SS1
    IMGS --> SS2
    IMGS --> SS3
    IMGS --> LP
    IMGS --> Dep
    IMGS --> Wdr
    IMGS --> FC
    IMGS --> BE
    IMGS --> MS
    IMGS --> PC

    %% Click Events
    click SS1 "https://github.com/vaibhav-pant/atm-management-system/blob/main/SignUp1.java"
    click SS2 "https://github.com/vaibhav-pant/atm-management-system/blob/main/SignUp2.java"
    click SS3 "https://github.com/vaibhav-pant/atm-management-system/blob/main/SignUp3.java"
    click LP "https://github.com/vaibhav-pant/atm-management-system/blob/main/LoginPage.java"
    click Dep "https://github.com/vaibhav-pant/atm-management-system/blob/main/deposit.java"
    click Wdr "https://github.com/vaibhav-pant/atm-management-system/blob/main/withdraw.java"
    click FC "https://github.com/vaibhav-pant/atm-management-system/blob/main/FastCash.java"
    click BE "https://github.com/vaibhav-pant/atm-management-system/blob/main/BalanceEnq.java"
    click MS "https://github.com/vaibhav-pant/atm-management-system/blob/main/MiniStatement.java"
    click PC "https://github.com/vaibhav-pant/atm-management-system/blob/main/PinChange.java"
    click TL "https://github.com/vaibhav-pant/atm-management-system/blob/main/transaction.java"
    click DA "https://github.com/vaibhav-pant/atm-management-system/blob/main/mysql.java"
    click SQL "https://github.com/vaibhav-pant/atm-management-system/blob/main/mysqlQueries.sql"
    click JAR1 "https://github.com/vaibhav-pant/atm-management-system/blob/main/mysql-connector-java-8.0.28.jar"
    click JAR2 "https://github.com/vaibhav-pant/atm-management-system/blob/main/jcalendar-tz-1.3.3-4.jar"
    click IMGS "https://github.com/vaibhav-pant/atm-management-system/tree/main/images/"

    %% Styles
    classDef presentation fill:#ccffcc,stroke:#333;
    classDef business fill:#ccf,stroke:#333;
    classDef dataaccess fill:#ffcc99,stroke:#333;
    classDef db fill:#dddddd,stroke:#333;
    classDef external fill:#fff,stroke:#333,stroke-dasharray: 5 5;
```
