A secure, production-grade RESTful Banking System API built with Spring Boot, PostgreSQL, and Docker. Includes robust banking features like JWT authentication, transactions, statement PDFs, and AWS S3 integration.
Explore all endpoints interactively using Swagger:
URL: http://localhost:8080/swagger-ui.html
- ✅ User Registration & Login (JWT-secured)
- ✅ Role-based Security (Spring Security)
- ✅ Create & Manage Bank Accounts
- ✅ Deposit, Withdraw & Transfer Money
- ✅ Generate PDF Statements
- ✅ Upload to AWS S3 & Email Download Link
- ✅ Pagination, Sorting, Filtering
- ✅ Input Validation & Global Error Handling
- ✅ DB Versioning with Flyway
- ✅ Dockerized for Easy Deployment
| Layer | Technology |
|---|---|
| Language | Java 17 |
| Framework | Spring Boot, Spring Security |
| Database | PostgreSQL |
| ORM | Hibernate / Spring Data JPA |
| Auth | JWT Token |
| DB Migration | Flyway |
| Storage | AWS S3 |
| PDF Export | iText |
| JavaMail | |
| Container | Docker, Docker Compose |
| Build Tool | Maven |
| Endpoint | Method | Description |
|---|---|---|
/api/auth/register |
POST | Register a new user |
/api/auth/login |
POST | Login & get JWT |
| Endpoint | Method | Description |
|---|---|---|
/api/accounts |
POST | Create a new account |
/api/accounts/{id} |
GET | Get account balance/info |
| Endpoint | Method | Description |
|---|---|---|
/api/transactions/deposit |
POST | Deposit money |
/api/transactions/withdraw |
POST | Withdraw money |
/api/transactions/transfer |
POST | Transfer money |
| Endpoint | Method | Description |
|---|---|---|
/api/statements/download |
GET | Download PDF statement |
/api/statements/email |
POST | Email statement link (S3 upload) |
git clone https://github.com/lokhandesh/BankingSystemAPI.git
cd BankingSystemAPI
docker-compose up --buildEasily deploy the BankingSystemAPI on a secure AWS EC2 instance using Docker Compose.
- An Ubuntu-based EC2 instance
- Docker & Docker Compose installed
- Your Docker image is pushed to DockerHub
- Optional: PostgreSQL running on the EC2 instance or via Amazon RDS
ssh ubuntu@<EC2_PUBLIC_IP>