🏦 BM-BankAccountSystem

📌 Overview

This is a Spring Boot bank account system that supports:

• Customers & accounts management
• Deposits & withdrawals
• Money transfers
• Transaction tracking

It uses Spring Boot, Spring Data JPA, DTOs, validation, and follows REST best practices.
Postman tests and ERD diagram are included in the repo.

---

✅ Quick Status

• Spring Boot 3.5.4 (Java 17, Maven) with BankApplication main class
• Entities: Customer, Account, Transaction (JPA annotated)
• Repositories: CustomerRepository, AccountRepository, TransactionRepository
• Services: Create, read, update, delete; deposit, withdraw, transfer logic
• Controllers:
  • CustomerController
  • AccountController
• DTOs: Mapping with basic validation
• Database: H2 in-memory (default config)
• ERD: Provided in /ERD folder

🛠 Technologies

• Java 17
• Spring Boot (Web, Data JPA)
• H2 Database / MySQL
• Maven
• ModelMapper (for DTOs)
• Postman (for testing)

---

🚀 How to Run

Requirements

• Java 17 JDK
• Maven 3.6+
• Optional: IntelliJ IDEA / VS Code

Steps

git clone https://github.com/IsraaXx/Bank-Account-System.git
cd Bank-Account-System
mvn clean spring-boot:run

App starts at: http://localhost:8080
Base API path: /api → http://localhost:8080/api
H2 console: http://localhost:8080/h2-console
JDBC URL: jdbc:h2:mem:bankdb (user: sa, no password)

---

📡 API Endpoints

Customers

• POST /customers – Create customer
• GET /customers – List customers
• GET /customers/{id} – Get by ID
• PUT /customers/{id} – Update
• DELETE /customers/{id} – Delete

Accounts

• POST /accounts – Create account
• GET /accounts – List accounts (paged)
• GET /accounts/{id} – Get by ID
• DELETE /accounts/{id} – Delete
• POST /accounts/{id}/deposit – Deposit
• POST /accounts/{id}/withdraw – Withdraw
• POST /accounts/transfer – Transfer money
• GET /accounts/type/{type} – Find by type

---

🧾 Postman Testing Plan

All requests use header: Content-Type: application/json

1. Create Customer A

{
  "name": "Alice Example",
  "email": "alice@example.com",
  "phone": "0123456789"
}

Expected: 201 Created → save customerAId

2. Create Customer B (different email/phone) → save customerBId

3. Create Account for Customer A

{
  "accountType": "SAVINGS",
  "initialBalance": 500,
  "customerId": {{customerAId}}
}

Expected: 201 Created → save accountAId

4. Create Account for Customer B → save accountBId

5. Deposit into Account A

{ "amount": 200.0 }

Expected: Balance +200

6. Withdraw from Account A

{ "amount": 100.0 }

Expected: Balance -100

7. Transfer from Account A to Account B

{
  "senderAccountId": {{accountAId}},
  "receiverAccountId": {{accountBId}},
  "amount": 150.0
}

Expected: 204 No Content → Check balances

8. Get Account Balances

• GET /accounts/{{accountAId}}
• GET /accounts/{{accountBId}}

9. List Accounts

• GET /accounts?page=0&size=10

10. Find by Type

• GET /accounts/type/SAVINGS

11. Customer CRUD

• List, update, delete customers

---

📊 ERD

Located in /ERD folder → Bank Application.png

---