Skip to content

README.md

Latest commit

 

History

History
217 lines (174 loc) · 8.22 KB

README.md

File metadata and controls

217 lines (174 loc) · 8.22 KB

Bank Management System

A comprehensive console-based banking application built in C++ that provides complete client and user management functionality with banking operations.

🏦 Overview

This Bank Management System is a feature-rich console application that demonstrates solid object-oriented programming principles and clean architecture. It provides a complete banking solution with user authentication, client management, and financial transactions.

✨ Features

🔐 Authentication & Authorization

  • User Login System: Secure username/password authentication
  • Permission-Based Access Control: Granular permissions for different system functions
  • Session Management: Maintains user session throughout the application

👥 Client Management

  • Complete CRUD Operations: Create, Read, Update, Delete client records
  • Client Search: Find clients by account number
  • Client Information: Personal details, account numbers, PIN codes, and balances
  • Soft Delete: Safe deletion with recovery capability

💰 Banking Operations

  • Deposits: Add money to client accounts
  • Withdrawals: Remove money with balance validation
  • Balance Inquiries: View individual and total account balances
  • Transaction History: Track all financial operations

👤 User Management

  • User Administration: Add, update, and delete system users
  • Permission Management: Assign specific permissions to users
  • User List: View all system users

💾 Data Persistence

  • File-Based Storage: Reliable data storage using text files
  • Data Serialization: Custom format for data storage and retrieval
  • Backup Capability: Easy data backup and restore

🏗️ Architecture

Design Patterns

  • Screen-Based Navigation: Clean separation of UI screens
  • Inheritance Hierarchy: Proper OOP with base classes
  • Factory Pattern: Object creation and management
  • Data Access Layer: Centralized data operations

Class Structure

clsPerson (Base Class)
├── clsBankClient (Client Management)
└── clsUser (User Management)

Screen Classes
├── clsMainScreen (Main Menu)
├── clsLoginScreen (Authentication)
├── clsTransactionsScreen (Banking Operations)
├── clsClientListScreen (Client Display)
├── clsAddNewClientScreen (Client Creation)
├── clsUpdateClientScreen (Client Updates)
├── clsDeleteClientScreen (Client Deletion)
├── clsFindClientScreen (Client Search)
├── clsDepositScreen (Deposit Operations)
├── clsWithdrawScreen (Withdrawal Operations)
├── clsTotalBalancesScreen (Balance Display)
└── clsManageUsersScreen (User Management)

🚀 Getting Started

Prerequisites

  • Visual Studio 2019 or later (with C++ support)
  • Windows 10/11 (uses Windows-specific console commands)
  • C++17 or later standard

Installation

  1. Clone or Download the project to your local machine
  2. Open BankSystem.sln in Visual Studio
  3. Build the solution (Ctrl+Shift+B)
  4. Run the application (F5 or Ctrl+F5)

First Run Setup

  1. The application will create Users.txt and Clients.txt files automatically
  2. Default admin credentials may be available in the Users.txt file
  3. Create your first user account through the user management system

📁 Project Structure

BankSystem/
├── BankSystem.cpp              # Main application entry point
├── Global.h                    # Global variables and constants
├── clsPerson.h                 # Base class for person data
├── clsBankClient.h             # Client management class
├── clsUser.h                   # User management class
├── clsMainScreen.h             # Main menu screen
├── clsLoginScreen.h            # Login authentication screen
├── clsTransactionsScreen.h     # Banking transactions menu
├── clsClientListScreen.h       # Client list display
├── clsAddNewClientScreen.h     # Add new client screen
├── clsUpdateClientScreen.h     # Update client screen
├── clsDeleteClientScreen.h     # Delete client screen
├── clsFindClientScreen.h       # Find client screen
├── clsDepositScreen.h          # Deposit operations screen
├── clsWithdrawScreen.h         # Withdrawal operations screen
├── clsTotalBalancesScreen.h    # Balance display screen
├── clsManageUsersScreen.h      # User management screen
├── clsScreen.h                 # Base screen class
├── clsInputValidate.h          # Input validation utilities
├── clsString.h                 # String manipulation utilities
├── clsUtil.h                   # General utilities
├── clsDate.h                   # Date handling utilities
├── Users.txt                   # User data storage
├── Clients.txt                 # Client data storage
└── README.md                   # This documentation file

🔧 Usage Guide

Login Process

  1. Start the application
  2. Enter your username and password
  3. Access the main menu upon successful authentication

Main Menu Options

  1. Show Client List - View all registered clients
  2. Add New Client - Register a new bank client
  3. Delete Client - Remove a client from the system
  4. Update Client Info - Modify existing client information
  5. Find Client - Search for a specific client
  6. Transactions - Access banking operations
  7. Manage Users - Administer system users
  8. Logout - End current session

Banking Transactions

  • Deposits: Select client and enter amount to deposit
  • Withdrawals: Select client and enter amount (validates sufficient funds)
  • Balance Inquiry: View total balances across all accounts

🔒 Security Considerations

Current Implementation

  • Plain Text Storage: Passwords and PINs are stored in plain text
  • File-Based Security: Relies on file system permissions
  • No Encryption: Data is not encrypted at rest

Recommended Improvements

  • Password Hashing: Implement bcrypt or SHA-256 hashing
  • Data Encryption: Encrypt sensitive data in files
  • Input Validation: Add comprehensive input sanitization
  • Audit Logging: Track all system operations
  • Database Migration: Consider moving to a proper database

🛠️ Technical Details

Data Format

Client and user data is stored in delimited text format:

FirstName#//#LastName#//#Email#//#Phone#//#AccountNumber#//#PinCode#//#Balance

File Structure

  • Users.txt: Contains all system user accounts
  • Clients.txt: Contains all bank client records
  • Build Output: Executable and debug files in x64/Debug/

Memory Management

  • Stack Allocation: Uses RAII principles
  • No Dynamic Memory: Avoids memory leaks
  • Automatic Cleanup: Proper resource management

🐛 Known Issues

  1. Security: Passwords stored in plain text
  2. Concurrency: No protection against simultaneous access
  3. Error Handling: Limited error recovery mechanisms
  4. Data Validation: Basic input validation only
  5. Platform Dependency: Windows-specific console commands

🔮 Future Enhancements

Short Term

  • Implement password hashing
  • Add comprehensive input validation
  • Improve error handling and recovery
  • Add transaction logging
  • Create data backup functionality

Long Term

  • Migrate to database storage
  • Add web-based interface
  • Implement multi-user concurrent access
  • Add reporting and analytics
  • Create mobile application

👥 Contributing

This project serves as an educational example of C++ application development. Contributions are welcome for:

  • Security improvements
  • Code optimization
  • Additional features
  • Documentation enhancements
  • Bug fixes

📄 License

This project is provided as-is for educational purposes. Feel free to use, modify, and distribute according to your needs.

📞 Support

For questions or issues:

  1. Review the code documentation
  2. Check the class comments for implementation details
  3. Examine the data files for format understanding
  4. Test with sample data to understand functionality

Note: This is a demonstration project showcasing C++ programming concepts and should not be used in production environments without proper security enhancements.