https://github.com/viiku/fraud-detection

Case Study:- A real-time fraud detection tool built with Java and Spring Boot, designed for extremely high throughput and scalable microservices environments. This project demonstrates modern fraud detection techniques, including rule-based and anomaly-based detection, leveraging Kafka, Redis, PostgreSQL, and container orchestration.
https://github.com/viiku/fraud-detection

docker grafana java21 kafka maven prometheus redis

Last synced: about 2 months ago
JSON representation

Case Study:- A real-time fraud detection tool built with Java and Spring Boot, designed for extremely high throughput and scalable microservices environments. This project demonstrates modern fraud detection techniques, including rule-based and anomaly-based detection, leveraging Kafka, Redis, PostgreSQL, and container orchestration.

• Host: GitHub
• URL: https://github.com/viiku/fraud-detection
• Owner: viiku
• Created: 2025-08-14T04:07:02.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2025-09-06T12:10:28.000Z (9 months ago)
• Last Synced: 2025-09-06T14:21:39.946Z (9 months ago)
• Topics: docker, grafana, java21, kafka, maven, prometheus, redis
• Language: Java
• Homepage:
• Size: 217 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 17
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🚨 Fraud Detection System

# Fraud Detection

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=viiku_fraud-detection&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=viiku_fraud-detection)

[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=viiku_fraud-detection&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=viiku_fraud-detection)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=viiku_fraud-detection&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=viiku_fraud-detection)

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=viiku_fraud-detection&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=viiku_fraud-detection)

[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=viiku_fraud-detection&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=viiku_fraud-detection)

[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=viiku_fraud-detection&metric=bugs)](https://sonarcloud.io/summary/new_code?id=viiku_fraud-detection)

[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=viiku_fraud-detection&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=viiku_fraud-detection)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=viiku_fraud-detection&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=viiku_fraud-detection)

A **real-time fraud detection tool** built with **Java** and **Spring Boot**, designed for extremely high throughput and scalable microservices environments. This project demonstrates modern fraud detection techniques, including rule-based and anomaly-based detection, leveraging Kafka, Redis, PostgreSQL, and container orchestration.

---

## Flow Diagram

![img.png](arch.png)

## ✨ Features

- **Real-time transaction analysis** via Kafka event streaming

- **Rule-based & anomaly-based fraud detection**

- **Scalable microservices architecture** (Docker, Kubernetes)

- **Metrics & monitoring** (Prometheus, Grafana)

- **RESTful APIs** for transaction and alert management

- **OpenAPI documentation** for easy integration

---

## 🚀 Quick Start

### 1. Clone the repository

```sh

git clone https://github.com/viiku/fraud-detection.git

cd fraud-detection

```

### 2. Build the project

```sh

./mvnw clean package

```

### 3. Run with Docker Compose

```sh

cd deploy

docker-compose up --build

```

### 4. Access the application

- **API:** [http://localhost:8080/api/v1/transactions](http://localhost:8080/api/v1/transactions)

- **Swagger UI:** [http://localhost:8080/swagger-ui.html](http://localhost:8080/swagger-ui.html)

- **Grafana:** [http://localhost:3000](http://localhost:3000) (default user: admin / admin)

- **Prometheus:** [http://localhost:9090](http://localhost:9090)

---

## 📚 Documentation

- [API Docs (Swagger)](http://localhost:8080/swagger-ui.html)

- [Prometheus Metrics](http://localhost:8080/actuator/prometheus)

---

## 🛠️ Technologies Used

- Java 21, Spring Boot

- Kafka, Redis, PostgreSQL

- Docker, Kubernetes

- Prometheus, Grafana

---

## 🤝 Contributing

Feel free to open issues or submit pull requests for improvements!