🏧 ATM Management System

A comprehensive Automated Teller Machine (ATM) Management System implemented in Java. This console-based application simulates real-world ATM operations with secure banking functionalities including account management, transactions, and balance inquiries.

📋 Table of Contents

Overview
Features
System Architecture
Technologies Used
Project Structure
Getting Started
Usage Guide
Core Functionalities
Security Features
Database Design
Testing
Future Enhancements
Contributing
License
Contact

🧠 Overview

The ATM Management System is a Java-based application that replicates the functionality of a real Automated Teller Machine. It provides a secure, user-friendly interface for performing various banking operations without the need for physical bank visits.

Key Highlights

✅ Secure Authentication - PIN-based account access
✅ Account Management - Create, update, and manage accounts
✅ Transaction Processing - Withdrawals, deposits, and transfers
✅ Balance Inquiry - Real-time account balance checking
✅ Transaction History - Detailed record of all operations
✅ Multi-Account Support - Handle multiple user accounts
✅ Data Persistence - File-based or database storage

✨ Features

User Operations

🔐 Authentication & Security

Secure PIN-based login system
Account number validation
Session management
Multiple failed login attempt handling
PIN change functionality

💰 Banking Transactions

Cash Withdrawal - Withdraw money with balance validation
Cash Deposit - Deposit funds into account
Fund Transfer - Transfer money between accounts
Balance Inquiry - Check current account balance
Mini Statement - View recent transaction history

👤 Account Management

Create new account
View account details
Update personal information
Change PIN/Password
Close account

Administrative Features

View all accounts
Generate reports
Monitor transactions
Account activation/deactivation
System logs and audit trails

🏗️ System Architecture

┌─────────────────────────────────────┐
│         User Interface              │
│      (Console/Terminal I/O)         │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│      Authentication Layer           │
│    (Login & Security Management)    │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│      Business Logic Layer           │
│  (Transaction Processing & Rules)   │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│      Data Access Layer              │
│   (File I/O / Database Operations)  │
└──────────────┬──────────────────────┘
               │
               ↓
┌─────────────────────────────────────┐
│      Data Storage                   │
│    (Files / Database)               │
└─────────────────────────────────────┘

🛠️ Technologies Used

Programming Language: Java (JDK 8 or higher)
Design Pattern: Object-Oriented Programming (OOP)
Data Storage: File System / MySQL Database
Development Approach: Console-based Application
Build Tool: Maven (optional) or direct compilation

Core Java Concepts Used

Classes and Objects
Inheritance and Polymorphism
Encapsulation and Abstraction
Exception Handling
File I/O Operations
Collections Framework
Date and Time API

📁 Project Structure

ATM-Management-System/
├── ATM-Management/
│   ├── src/
│   │   ├── main/
│   │   │   ├── ATMSystem.java              # Main application entry point
│   │   │   ├── Account.java                # Account entity class
│   │   │   ├── User.java                   # User entity class
│   │   │   ├── Transaction.java            # Transaction class
│   │   │   ├── Authentication.java         # Login/security handler
│   │   │   ├── AccountManager.java         # Account operations
│   │   │   ├── TransactionManager.java     # Transaction processing
│   │   │   ├── DatabaseHandler.java        # Data persistence
│   │   │   └── Utilities.java              # Helper methods
│   │   └── test/
│   │       └── ATMSystemTest.java          # Unit tests
│   ├── data/
│   │   ├── accounts.dat                    # Account data file
│   │   ├── transactions.dat                # Transaction records
│   │   └── users.dat                       # User information
│   ├── docs/
│   │   ├── design-document.md
│   │   └── user-manual.md
│   └── lib/                                # External libraries (if any)
├── .gitignore
├── README.md
└── LICENSE

🚀 Getting Started

Prerequisites

Ensure you have the following installed on your system:

Java Development Kit (JDK) 8 or higher
- Download from Oracle or OpenJDK
IDE (Optional but recommended)
- IntelliJ IDEA
- Eclipse
- NetBeans
- VS Code with Java extension
Git for version control

Installation

Clone the Repository

git clone https://github.com/mohamedshiras/ATM-Management-System.git
cd ATM-Management-System

Navigate to Source Directory

cd ATM-Management/src

Compile the Java Files

javac *.java

Or if using package structure:

javac -d ../bin main/*.java

Running the Application

Method 1: Direct Execution

java ATMSystem

Method 2: Using IDE

Open the project in your preferred IDE
Locate the ATMSystem.java file (main class)
Right-click and select "Run"

Method 3: Using JAR (if packaged)

java -jar ATM-Management-System.jar

💡 Usage Guide

First Time Setup

Launch the Application

Welcome to ATM Management System
================================

Create New Account
- Select "Create New Account" from main menu
- Enter required details:
  - Full Name
  - Date of Birth
  - Address
  - Phone Number
  - Email
  - Initial Deposit
  - Set PIN (4-6 digits)
- Account number will be auto-generated
Login to Your Account
- Enter Account Number
- Enter PIN
- Access granted upon successful authentication

Performing Transactions

Cash Withdrawal

1. Select "Withdraw" from menu
2. Enter amount to withdraw
3. Confirm transaction
4. Collect virtual cash
5. Receipt displayed

Cash Deposit

1. Select "Deposit" from menu
2. Enter amount to deposit
3. Confirm transaction
4. Balance updated
5. Receipt displayed

Fund Transfer

1. Select "Transfer" from menu
2. Enter beneficiary account number
3. Enter transfer amount
4. Confirm transaction
5. Both accounts updated
6. Receipt displayed

Check Balance

1. Select "Balance Inquiry"
2. Current balance displayed
3. Option to print mini statement

🔧 Core Functionalities

1. Account Creation

Account newAccount = new Account(
    accountNumber,
    customerName,
    pin,
    initialBalance,
    dateOfBirth,
    address,
    phoneNumber
);

Features:

Auto-generated unique account number
Minimum balance validation
Age verification (18+ years)
Input sanitization

2. Authentication System

boolean authenticate(String accountNumber, String pin) {
    // Verify account exists
    // Validate PIN
    // Check account status (active/frozen)
    // Log login attempt
    return isAuthenticated;
}

Security Measures:

Encrypted PIN storage
Maximum 3 login attempts
Account lockout after failed attempts
Session timeout

3. Transaction Processing

Transaction processWithdrawal(double amount) {
    // Check sufficient balance
    // Validate withdrawal limits
    // Update account balance
    // Create transaction record
    // Return transaction details
}

Validations:

Balance sufficiency check
Daily withdrawal limit
Minimum balance maintenance
Transaction limits

4. Data Persistence

File-Based Storage:

// Save account to file
void saveAccount(Account account) {
    ObjectOutputStream out = new ObjectOutputStream(
        new FileOutputStream("accounts.dat", true)
    );
    out.writeObject(account);
    out.close();
}

Database Storage (if implemented):

CREATE TABLE accounts (
    account_number VARCHAR(20) PRIMARY KEY,
    customer_name VARCHAR(100),
    pin_hash VARCHAR(64),
    balance DECIMAL(15,2),
    created_date TIMESTAMP,
    status VARCHAR(20)
);

🔒 Security Features

1. PIN Management

Encryption: PINs stored using hash algorithms (SHA-256)
Validation: 4-6 digit numeric PIN requirement
Change PIN: Secure PIN update functionality
Verification: PIN re-entry for confirmation

2. Transaction Security

Authentication: Required for all operations
Authorization: Account ownership verification
Audit Trail: All transactions logged
Limits: Daily transaction limits enforced

3. Session Management

Auto-logout: Inactive session timeout (5 minutes)
Single Session: One active session per account
Secure Exit: Proper logout procedure

4. Input Validation

Sanitization: Prevention of SQL injection
Type Checking: Numeric/String validation
Range Validation: Amount limits
Format Verification: Account number format

💾 Database Design

Entity-Relationship Model

ACCOUNT
├── account_number (PK)
├── customer_name
├── pin_hash
├── balance
├── account_type
├── created_date
├── last_modified
└── status

USER
├── user_id (PK)
├── account_number (FK)
├── name
├── dob
├── address
├── phone
├── email
└── id_proof

TRANSACTION
├── transaction_id (PK)
├── account_number (FK)
├── transaction_type
├── amount
├── balance_after
├── timestamp
└── description

🧪 Testing

Manual Testing Checklist

Running Unit Tests

If using JUnit:

javac -cp .:junit-4.13.2.jar ATMSystemTest.java
java -cp .:junit-4.13.2.jar:hamcrest-core-1.3.jar org.junit.runner.JUnitCore ATMSystemTest

🔮 Future Enhancements

Planned Features

Technical Improvements

Migrate to Spring Boot for better architecture
Implement RESTful API
Add database migration tools (Flyway/Liquibase)
Implement caching (Redis)
Add comprehensive logging (Log4j)
Containerization with Docker
CI/CD pipeline setup
Performance optimization
Load testing and stress testing

🤝 Contributing

Contributions are welcome and appreciated! Here's how you can contribute:

How to Contribute

Fork the Repository

Click the 'Fork' button at the top right of the page

Clone Your Fork

git clone https://github.com/YOUR-USERNAME/ATM-Management-System.git
cd ATM-Management-System

Create a Feature Branch
```
git checkout -b feature/AmazingFeature
```
Make Your Changes
- Write clean, well-documented code
- Follow Java naming conventions
- Add comments where necessary
- Update README if needed

Commit Your Changes

git add .
git commit -m "Add some AmazingFeature"

Push to Your Fork
```
git push origin feature/AmazingFeature
```
Open a Pull Request
- Go to the original repository
- Click "New Pull Request"
- Select your feature branch
- Describe your changes
- Submit the PR

Contribution Guidelines

Follow existing code style and conventions
Write meaningful commit messages
Add unit tests for new features
Update documentation as needed
Ensure all tests pass before submitting PR
Be respectful and constructive in discussions

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2026 Mohamed Shiras

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

👥 Contributors

Project Lead

Mohamed Shiras - Initial Development - @mohamedshiras

Special Thanks

Contributors who have helped improve this project
The Java community for excellent documentation
All users providing valuable feedback

📧 Contact

Mohamed Shiras

GitHub: @mohamedshiras
Project Link: https://github.com/mohamedshiras/ATM-Management-System

🙏 Acknowledgments

Inspired by real-world ATM systems
Built as a learning project to understand Java OOP concepts
Thanks to the open-source community for guidance and support
Java documentation and tutorials

📚 Additional Resources

Learning Resources

Related Projects

Online Banking System
Point of Sale (POS) System
Credit Card Management System
Digital Wallet Application

⭐ If you find this project helpful, please consider giving it a star! ⭐

Made with ☕ and ❤️ by Mohamed Shiras

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
ATM-Management		ATM-Management
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

🏧 ATM Management System

📋 Table of Contents

🧠 Overview

Key Highlights

✨ Features

User Operations

🔐 Authentication & Security

💰 Banking Transactions

👤 Account Management

Administrative Features

🏗️ System Architecture

🛠️ Technologies Used

Core Java Concepts Used

📁 Project Structure

🚀 Getting Started

Prerequisites

Installation

Running the Application

💡 Usage Guide

First Time Setup

Performing Transactions

Cash Withdrawal

Cash Deposit

Fund Transfer

Check Balance

🔧 Core Functionalities

1. Account Creation

2. Authentication System

3. Transaction Processing

4. Data Persistence

🔒 Security Features

1. PIN Management

2. Transaction Security

3. Session Management

4. Input Validation

💾 Database Design

Entity-Relationship Model

🧪 Testing

Manual Testing Checklist

Running Unit Tests

🔮 Future Enhancements

Planned Features

Technical Improvements

🤝 Contributing

How to Contribute

Contribution Guidelines

📄 License

👥 Contributors

Project Lead

Special Thanks

📧 Contact

🙏 Acknowledgments

📚 Additional Resources

Learning Resources

Related Projects

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages