💳 CardShield AI

Intelligent Credit Card Benefit Detection, Recommendation & Claim Assistance System

A full-stack web application that automatically analyzes credit card transactions, identifies eligible credit card protection benefits, and assists users in filing claims through an interactive multi-step workflow.

---

🌐 Overview

Many credit card users miss valuable protection benefits such as Device Insurance, Travel Insurance, Extended Warranty, and Purchase Protection because they are unaware of their eligibility.

CardShield AI helps users discover these hidden benefits by analyzing credit card transactions using a rule-based eligibility engine and guiding them through an intelligent claim submission process.

The application features an interactive dashboard, dynamic transaction management, OCR-assisted receipt upload, claim tracking, and a Spring Boot REST API backed by a MySQL database.

---

🚀 Project Highlights

• Built a full-stack web application using Spring Boot, Hibernate, MySQL, HTML, CSS, and JavaScript.
• Developed a rule-based engine to detect eligible credit card protection benefits.
• Implemented an interactive multi-step claim submission workflow with OCR-assisted receipt processing.
• Designed a responsive dashboard for transaction monitoring, benefit detection, and claim tracking.
• Integrated RESTful APIs for seamless frontend-backend communication.

✨ Features

💳 Transaction Management

• Add new credit card transactions
• Dynamic transaction history
• Persistent MySQL storage
• Real-time dashboard updates

---

🛡️ Intelligent Benefit Detection

Automatically detects eligible benefits including:

• ✅ Device Insurance
• ✅ Travel Insurance
• ✅ Purchase Protection (future-ready)
• ✅ Extended Warranty (future-ready)
• ✅ Return Protection (future-ready)

Features:

• Rule-Based Eligibility Engine
• Benefit Confidence Scoring
• Real-time Detection
• Benefit Recommendation

---

📄 Smart Claim Assistant

Interactive multi-step claim workflow:

• Benefit Detection
• Receipt Upload
• OCR-Assisted Receipt Processing (with intelligent fallback)
• Claim Review
• Duplicate Claim Detection
• Claim Submission
• Claim Tracking

---

📊 Dashboard

Provides real-time analytics including:

• Eligible Transactions
• Recoverable Value
• Claims Filed
• Detection Statistics

---

🤖 AI Benefit Assistant

Built-in chatbot that helps users understand:

• Benefit eligibility
• Required documents
• Coverage windows
• Claim timelines

---

🏗️ System Architecture

                +----------------------+
                |      Frontend        |
                | HTML • CSS • JS      |
                +----------+-----------+
                           |
                     REST API Calls
                           |
                +----------v-----------+
                |   Spring Boot API    |
                | Controller Layer     |
                +----------+-----------+
                           |
                +----------v-----------+
                |    Service Layer     |
                | Benefit Detection    |
                +----------+-----------+
                           |
                +----------v-----------+
                | Repository Layer     |
                | Spring Data JPA      |
                +----------+-----------+
                           |
                +----------v-----------+
                |      MySQL DB        |
                +----------------------+

---

🔄 Application Workflow

User
   │
   ▼
Add Transaction
   │
   ▼
Spring Boot REST API
   │
   ▼
Rule-Based Benefit Detection
   │
   ▼
Eligible Benefit Identified
   │
   ▼
File Claim
   │
   ▼
Upload Receipt
   │
   ▼
OCR Processing
   │
   ├───────────────┐
   │               │
Text Found     No Text Found
   │               │
   └──────┬────────┘
          ▼
 Review Claim
          ▼
Duplicate Claim Check
          ▼
Submit Claim
          ▼
Claims Tracker Updated
          ▼
Dashboard Updated

---

🖥️ Modules

Dashboard

• Benefit Overview
• Claims Summary
• Recoverable Value
• Detection Statistics

---

Transaction Ledger

• Dynamic Transaction History
• Real-Time Benefit Detection
• Claim Initiation

---

Claim Management

• Multi-Step Claim Wizard
• OCR-Assisted Receipt Upload
• Duplicate Claim Prevention
• Claim Status Tracking

---

AI Assistant

• Benefit Guidance
• Coverage Information
• Claim Assistance

---

🛠️ Technology Stack

Backend

• Java
• Spring Boot
• Spring MVC
• Spring Data JPA
• Hibernate
• Maven

Frontend

• HTML5
• CSS3
• JavaScript

Database

• MySQL

OCR

• Tesseract.js

API

• REST APIs

Tools

• VS Code
• MySQL Workbench
• Postman
• Git
• GitHub

---

📂 Project Structure

CardShield/
│
├── backend/
│   ├── src/
│   ├── pom.xml
│   └── application.properties
│
├── frontend/
│   ├── index.html
│   └── ...
│
├── database/
│   └── schema.sql
│
├── README.md
└── LICENSE

---

🚀 Getting Started

1. Clone Repository

git clone https://github.com/<your-username>/CardShield-AI.git

---

2. Configure MySQL

Create a database.

CREATE DATABASE cardshield;

Import:

database/schema.sql

---

3. Configure Backend

Update:

backend/src/main/resources/application.properties

with your MySQL credentials.

---

⚙️ Configuration

Before running the backend, update the database credentials in:

backend/src/main/resources/application.properties

Replace:

spring.datasource.username=your_username
spring.datasource.password=your_password

with your local MySQL username and password.

Example:

spring.datasource.username=root
spring.datasource.password=your_mysql_password

Also ensure that:

• MySQL is running.
• A database named cardshield exists.

4. Run Spring Boot

cd backend
mvn spring-boot:run

Backend runs at:

http://localhost:9090

---

5. Run Frontend

Open:

frontend/index.html

using Live Server.

---

🔗 REST API Endpoints

Method	Endpoint	Description
POST	/api/transactions/ingest	Add a new transaction
GET	/api/transactions/card/{cardId}	Retrieve all transactions

---

📸 Screenshots

📸 Application Screenshots

📊 Dashboard

The dashboard provides an overview of eligible transactions, recoverable value, claims filed, and transaction history.

---

➕ Simulate Transaction

Users can simulate incoming card transactions to test the rule-based benefit detection engine.

---

🛡️ Benefit Detection

The system analyzes newly added transactions and automatically detects eligible credit card protection benefits.

---

📄 Claim Workflow

Step 1 – Benefit Detection

The application explains why the transaction qualifies for a protection benefit.

---

Step 2 – Receipt Upload

Users upload a purchase receipt for OCR-assisted claim processing.

---

Step 3 – Review Claim

Users can verify and edit the extracted claim details before submission.

---

Step 4 – Claim Submitted

A unique claim reference is generated and the claim is added to the tracker.

---

📈 Dashboard After Claim Submission

The dashboard updates automatically after successful claim submission.

🌱 Future Enhancements

• Authentication & Authorization
• Email Notifications
• Cloud Deployment
• AI/ML-Based Benefit Recommendation
• Advanced AI-powered OCR and document verification
• Mobile Application
• Fraud Detection Engine
• Admin Dashboard

---

📚 Learning Outcomes

Through this project, I gained practical experience in:

• Full-Stack Web Development
• Spring Boot REST API Development
• MVC Architecture
• Hibernate & Spring Data JPA
• MySQL Database Design
• Frontend-Backend Integration
• Rule-Based Recommendation Systems
• OCR Integration
• Interactive UI Development
• RESTful API Design
• Git & GitHub Version Control

---

👩‍💻 Author

Monika Athukuri

Final Year B.Tech – Computer Science Engineering (AI & ML)

---

📄 License

This project is licensed under the MIT License.

---

⭐ If you found this project useful, consider giving it a star!