Skip to content

v1.0.0 - eBankify Project Creation

Latest

Choose a tag to compare

@elkhailihamza elkhailihamza released this 12 Dec 10:03
· 1 commit to main since this release
af2162e

eBankify - Version 1.0.0

Overview

eBankify is an online banking management application built with a modular RESTful architecture. It leverages Spring Boot, Spring Data JPA, Liquibase for database migrations, JUnit for unit testing, and centralized exception handling to ensure reliability and robustness.

New Features

1. User Roles and Permissions

  • ADMIN: Full access to the application, including user management (create, update, delete) and full control over bank accounts and transactions.
  • USER: Can create and manage their own accounts, perform transactions, and view their transaction history. Cannot access or modify other users' accounts.
  • EMPLOYEE: Can view customer accounts and approve/reject important transactions (e.g., large transfers). Cannot create or modify customer accounts.

2. Account Management

  • Users can create and manage multiple bank accounts.
  • Administrators can block or activate accounts.
  • Users can view the balance of their accounts.

3. Transactions

  • Types of Transactions:

    • Standard Transactions: Regular transfers between accounts.
    • Instant Transactions: Processed immediately.
    • Permanent Transfers: Scheduled transfers at predefined intervals (e.g., monthly, weekly).
  • Important transactions require approval from an EMPLOYEE.

  • Transaction Types:

    • Internal Transactions: Transfers within the same bank.
    • External Transactions: Transfers between banks, with transaction fees based on type.
  • Transaction Fees:

    • Classic Transactions: Regular fee for transfers between different banks.
    • Instant Transactions: Special fee for immediate transfers.
  • Transaction history is indexed in ElasticSearch for fast searching by amount, type, date, etc.

4. Bill and Loan Management

  • Bill Management: Users can view and manage their bills.
  • Loan Management: Users can apply for loans, with approval/rejection based on predefined criteria (e.g., credit history, income).

Loan Eligibility Criteria:

  • Minimum Age: 18 years.
  • Income: Proof of stable monthly income.
  • Credit History: Good credit history.
  • Debt-to-Income Ratio: Should not exceed a defined threshold (e.g., 40%).
  • Collateral: May be required for larger loans.
  • Relationship Duration: Minimum client-bank relationship duration (e.g., 6 months).

Technical Requirements

  • Spring Boot for API development.
  • Organized in a multi-layer architecture.
  • Liquibase for database migrations.
  • Centralized Exception Handling: Errors are returned as structured JSON messages.
  • Unit Testing: Essential for critical functionality.
  • Configuration Format: YAML.
  • Lombok: For reducing boilerplate code using the Builder pattern.
  • MapStruct: For converting Entities, DTOs, and ViewModels (VM).
  • Bcrypt: Password encryption.
  • SonarQube: Code quality checks.
  • ElasticSearch: For indexing and fast data searches.

Notable Changes

  • Database Migrations: The database schema is now managed by Liquibase.
  • Transaction History Search: Transactions are indexed in ElasticSearch for efficient querying.
  • Loan Management System: New functionality to manage loan applications and eligibility.

Bug Fixes

  • Fixed a bug with transaction fee calculation for external transactions.
  • Improved exception handling for failed login attempts.

Enhancements

  • Centralized exception handling across the API for consistent error responses.
  • Enhanced transaction history search functionality with ElasticSearch.

Installation and Setup

  1. Clone the repository.
  2. Run the application using Spring Boot.
  3. Configure the application settings in application.yml.
  4. Use Liquibase for database migration management.

Known Issues

  • No known issues at the moment.