Skip to content

Pratham-U-dev/ShieldVision

Repository files navigation

๐Ÿ›ก๏ธ ShieldVision โ€” AI-Powered Debit Card Fraud Detection

Real-time fraud detection for debit card transactions using Machine Learning, IBM Cloud, Node.js, and a modern TypeScript frontend.

๐ŸŒ Live: Frontend on Vercel ยท Backend on Railway
๐Ÿ“ Repo: github.com/23e46pratham-lab/ShieldVision_Working
๐Ÿ“ backend repo: https://github.com/23e46pratham-lab/backend


๐Ÿ“Œ Overview

Financial fraud is rapidly increasing with the growth of digital banking โ€” especially in loan processing and debit card transactions. Traditional rule-based systems used in Indian banking fail to catch sophisticated fraud patterns.

ShieldVision is an end-to-end AI-powered fraud detection system that classifies debit card transactions as Fraudulent or Legitimate in real time using a Snap Random Forest Classifier hosted on IBM Cloud.


โœจ Features

  • โšก Real-time single transaction prediction
  • ๐Ÿ“‚ CSV batch detection
  • ๐Ÿ“Š Live dashboard with fraud analytics
  • ๐Ÿฅง Pie chart fraud/legitimate ratio
  • ๐Ÿ”” Latest fraud alerts panel
  • ๐Ÿ“‹ Full transaction history logs
  • โ˜๏ธ Cloud-deployed ML model (IBM Watson)
  • ๐Ÿ” Secure environment-based configuration
  • ๐Ÿšซ No mock data โ€” fully connected to live backend

๐Ÿ›  Tech Stack

Layer Technology Hosting
๐Ÿง  ML Model Snap Random Forest Classifier IBM Cloud (Watson ML)
๐Ÿ”ง Backend Node.js + Express Railway.app
๐Ÿ’ป Frontend TypeScript, HTML, JS Vercel
๐Ÿ“Š Charts Recharts โ€”

๐Ÿ” How It Works

User Input (Form / CSV)
        โ†“
Node.js Backend
  โ†’ Validates & formats transaction fields
  โ†’ Sends payload to IBM Cloud ML endpoint
        โ†“
IBM Watson ML
  โ†’ Snap Random Forest Classifier
  โ†’ Returns: { "prediction": "Fraud", "confidence": 0.92 }
        โ†“
Backend formats & logs result
        โ†“
Frontend Dashboard
  โ†’ Live prediction result
  โ†’ Updated analytics & charts

Transaction Fields Used

type ยท amount ยท nameOrig ยท oldbalanceOrg ยท newbalanceOrig
nameDest ยท oldbalanceDest ยท newbalanceDest

๐Ÿ“ Project Structure

ShieldVision_Working/
โ”œโ”€โ”€ frontend/
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ pages/
โ”‚   โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ services/api.ts
โ”‚   โ”‚   โ””โ”€โ”€ types.ts
โ”‚   โ””โ”€โ”€ vite.config.ts
โ”‚
โ””โ”€โ”€ backend/
    โ”œโ”€โ”€ server.js
    โ”œโ”€โ”€ routes/
    โ””โ”€โ”€ .env

๐Ÿš€ Running Locally

1. Clone the repo

git clone https://github.com/23e46pratham-lab/ShieldVision_Working.git
cd ShieldVision_Working

2. Start the backend

cd backend
npm install
npm start

3. Start the frontend

cd frontend
npm install
npm run dev

4. Environment Variables

Backend .env

IBM_API_KEY=your-ibm-api-key
IBM_URL=your-ibm-ml-endpoint
PORT=5000

Frontend .env

VITE_BACKEND_URL=https://your-backend.railway.app/api

๐Ÿ“Š Dashboard

  • Live fraud vs legitimate pie chart
  • Real-time prediction panel
  • Transaction history table
  • Latest fraud alerts
  • CSV batch result preview
  • Accuracy metrics

๐Ÿ”ฎ Future Enhancements

  • User authentication
  • Database integration (MongoDB / PostgreSQL)
  • Model monitoring dashboard
  • Advanced anomaly detection
  • Multi-card fraud correlation

๐ŸŽ“ Context

Developed as part of the CLPBL Initiative at St. Joseph Engineering College, Mangaluru โ€” addressing a real problem in India's rapidly expanding digital banking ecosystem.

About

ShieldVision is an end-to-end AI-powered fraud detection system that classifies debit card transactions as Fraudulent or Legitimate in real time using a Snap Random Forest Classifier hosted on IBM Cloud.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors