TrustMate-Ai Web Application Development

# TrustMate AI – Intelligent Expense Management System

TrustMate AI is a full-stack web application designed to simplify group expense tracking with smart automation, fraud detection, and seamless UPI-based payments.

It combines modern frontend technologies with a scalable backend architecture to deliver a secure and real-time financial collaboration experience.

---

## Key Features

### Expense Management
- Create and manage group expenses  
- Split bills dynamically between members  
- Track balances in real-time  

### Group System
- Create groups and add members  
- View group analytics and statistics  
- Manage shared transactions easily  

### Authentication & Security
- JWT-based authentication  
- Rate limiting and protected routes  
- Email verification and password reset  

### UPI Integration
- Generate UPI payment links  
- Verify payments via screenshots  
- UPI transaction validation system  

### OCR & Receipt Processing
- Upload receipts for automatic data extraction  
- Extract items, totals, and metadata using OCR  
- Reduce manual entry  

### Fraud Detection
- Analyze suspicious transactions  
- Fraud check APIs for validation  
- Trust score system for users  

### Settlement Optimization
- Smart debt simplification  
- Minimize number of transactions  
- Automated settlement suggestions  

---

## Project Architecture

---

## Frontend (React + Vite)

Located in: `/frontend`

### Tech Stack
- React.js with TypeScript  
- Vite (build tool)  
- Tailwind CSS  
- React Query (data fetching)  
- Zustand (state management)  

### Key Modules
- Dashboard and Analytics  
- Expense Management UI  
- Group Management  
- UPI Payment and Verification  
- Authentication pages (Login, Reset, Verify)  

---

## Backend (NestJS)

Located in: `/trustmate-ai-backend`

### Tech Stack
- NestJS (Node.js framework)  
- MongoDB  
- JWT Authentication  
- Swagger (API documentation)  

### Core Modules
- Auth (Login, Signup, JWT)  
- Users  
- Groups  
- Expenses  
- Settlements  
- Fraud Detection  
- OCR Processing  
- UPI Payments  
- Trust Score System  

---

## API Integration

- OpenAPI-based API generation  
- Fully typed frontend API client  
- Swagger documentation available  

---

## Security Features

- JWT authentication and guards  
- Rate limiting  
- Input validation using DTOs  
- MongoDB exception filters  

---

## Advanced Features

- Analytics dashboard  
- AI-based fraud detection logic  
- Trust scoring system  
- OCR-based receipt scanning  
- Smart settlement optimization  

---

## Installation and Setup

### 1. Clone the repository
```bash
git clone https://github.com/harsaa34/TrustMate-Ai.git
cd TrustMate-Ai

2. Setup Backend

cd trustmate-ai-backend
npm install
npm run start:dev

3. Setup Frontend

cd frontend
npm install
npm run dev

Environment Variables

MONGO_URI=your_database_url
JWT_SECRET=your_secret_key
EMAIL_SERVICE=your_email_config

Highlights

GitHub Repository

Author

License