https://github.com/fintech-lsi/transaction-service
A robust transaction processing microservice built with Spring Boot that handles all financial transactions for the FinTechPro platform. This service manages deposits, withdrawals, transfers, and maintains transaction history with real-time event processing.
https://github.com/fintech-lsi/transaction-service
Last synced: over 1 year ago
JSON representation
A robust transaction processing microservice built with Spring Boot that handles all financial transactions for the FinTechPro platform. This service manages deposits, withdrawals, transfers, and maintains transaction history with real-time event processing.
- Host: GitHub
- URL: https://github.com/fintech-lsi/transaction-service
- Owner: Fintech-LSI
- Created: 2025-01-12T18:50:31.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-20T00:04:55.000Z (over 1 year ago)
- Last Synced: 2025-01-30T14:41:07.637Z (over 1 year ago)
- Language: Java
- Homepage:
- Size: 467 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 💸 Transaction Service
[](https://jenkins-url)
[](http://54.86.47.1:9000)
[](https://hub.docker.com/r/your-repo/transaction-service)
[](https://opensource.org/licenses/MIT)
## 📋 Table of Contents
- [Overview](#-overview)
- [Features](#-features)
- [Architecture](#-architecture)
- [Tech Stack](#-tech-stack)
- [Project Structure](#-project-structure)
- [Pipeline](#-pipeline)
- [Getting Started](#-getting-started)
- [API Documentation](#-api-documentation)
- [Configuration](#-configuration)
- [Deployment](#-deployment)
- [Contributing](#-contributing)
- [Team](#-team)
- [License](#-license)
## 🎯 Overview
A robust transaction processing microservice built with Spring Boot that handles all financial transactions for the FinTechPro platform. This service manages deposits, withdrawals, transfers, and maintains transaction history with real-time event processing.
## ✨ Features
- 💰 **Multiple Transaction Types**
- Deposits
- Withdrawals
- Transfers
- 📊 **Transaction Status Tracking**
- 🔄 **Real-time Processing**
- 📱 **Wallet Integration**
- 📨 **Notification Service**
- 📈 **Transaction History**
- 🔍 **Advanced Filtering**
- 📊 **Status Monitoring**
- 🔐 **Secure Processing**
- 📝 **Audit Logging**
## 🏗 Architecture
The service follows a microservices architecture with the following components:
```
┌─────────────┐
┌──▶│Wallet Service│
┌──────────────┐ REST │ └─────────────┘
│ Transaction │◀──────────▶│ ┌─────────────┐
│ Service │ Kafka └──▶│Notification │
└──────────────┘ Messages │ Service │
└─────────────┘
```
## 🛠 Tech Stack
## 📂 Project Structure
```
src/
├── 📱 main/java/com/lsi/transaction/
│ ├── 📊 config/
│ ├── 🎮 controller/
│ │ └── TransactionController.java
│ ├── 📦 dto/
│ │ ├── request/
│ │ └── response/
│ ├── 🏢 entity/
│ │ ├── Deposit.java
│ │ ├── MoneyMethods.java
│ │ ├── Transaction.java
│ │ ├── TransactionStatus.java
│ │ ├── Transfer.java
│ │ └── WithDraw.java
│ ├── 📚 repository/
│ ├── 🔧 service/
│ │ ├── TransactionService.java
│ │ ├── feign_clients/
│ │ └── kafka_service/
│ └── TransactionServiceApplication.java
├── 📝 main/resources/
│ ├── application.yaml
│ └── application-local.yaml
└── 🧪 test/
```
## 🔄 Pipeline
Our CI/CD pipeline ensures secure and reliable deployments:
1. 📥 **Code Checkout**: Source code retrieval
2. 🔍 **SonarQube Analysis**: Code quality and security checks
3. 🏗️ **Maven Build**: Compilation and package creation
4. 🐳 **Docker Build & Push**: Container image creation and ECR upload
5. ☸️ **EKS Deployment**: Kubernetes deployment with proper configurations
## 🚀 Getting Started
```bash
# Clone the repository
git clone https://github.com/your-org/transaction-service.git
# Navigate to the project directory
cd transaction-service
# Build the project
mvn clean install
# Run locally
mvn spring-boot:run -Dspring.profiles.active=local
# Run tests
mvn test
```
## 📚 API Documentation
Available endpoints:
```
GET /api/transaction - Get all transactions
GET /api/transaction/type/{type} - Get transactions by type (withdraw/deposit/transfer)
GET /api/transaction/wallet/{id} - Get transactions by wallet ID
GET /api/transaction/status/failed - Get failed transactions
GET /api/transaction/status/success - Get successful transactions
GET /api/transaction/status/pending - Get pending transactions
```
Detailed API documentation is available at `/swagger-ui.html` when running the service.
## ⚙️ Configuration
Key configuration parameters in `application.yaml`:
```yaml
spring:
application:
name: transaction-service
kafka:
bootstrap-servers: ${KAFKA_SERVERS}
consumer:
group-id: transaction-group
datasource:
url: ${DB_URL}
username: ${DB_USERNAME}
password: ${DB_PASSWORD}
feign:
wallet-service:
url: ${WALLET_SERVICE_URL}
```
## 🚢 Deployment
The service is deployed on AWS EKS using Kubernetes manifests in the `k8s/` directory:
- `configmap.yaml`: Environment variables
- `secrets.yaml`: Sensitive data
- `deployment.yaml`: Pod specifications
- `service.yaml`: Service configuration
## 👥 Team
| Avatar | Name | Role | GitHub |
|---------------------------------------------------------------------------------------------------------|------|------|--------|
| 
| Zakariae Azarkan | DevOps Engineer | [@zachary013](https://github.com/zachary013) |
| 
| El Mahdi Id Lahcen | Frontend Developer | [@goalaphx](https://github.com/goalaphx) |
| 
| Hodaifa | Cloud Architect | [@hodaifa-ech](https://github.com/hodaifa-ech) |
| 
| Khalil El Houssine | Backend Developer | [@khalilh2002](https://github.com/khalilh2002) |
| 
| Mohamed Amine BAHASSOU | ML Engineer | [@Medamine-Bahassou](https://github.com/Medamine-Bahassou) |
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
Built with ❤️ by the FinTech Team