ShopGuard AI - E-Commerce Automation Testing Platform

Project Overview

ShopGuard AI is a portfolio MVP that includes a simple React + TypeScript storefront and a Java Spring Boot backend, plus a standalone Java Selenium automation framework with TestNG and AI-assisted failure analysis.

Features

• Customer, Seller, and Admin roles
• Product browsing, search, categories, cart, mock checkout, order history
• Seller product management
• Admin user/product/order overview
• JWT authentication
• Java Selenium automation with Page Object Model
• TestNG + ExtentReports reporting
• Automatic screenshot capture on failure
• AI Failure Analyzer with OpenAI fallback

Architecture

• frontend/: React + Vite + TypeScript + Tailwind CSS
• backend/: Java Spring Boot REST API with H2 database
• automation/: Java Selenium TestNG framework

Tech Stack

• React, TypeScript, Vite, Tailwind CSS
• Java, Spring Boot, Spring Security, JPA, H2
• Selenium WebDriver, TestNG, WebDriverManager, ExtentReports

Run Application

1. Start backend
   • cd backend
   • mvn spring-boot:run
2. Start frontend
   • cd frontend
   • npm install
   • Copy .env.example to .env and set VITE_API_BASE_URL if needed, for example:
     • VITE_API_BASE_URL=http://localhost:8080/api
   • npm run dev

Default frontend URL: http://localhost:5173 Default backend URL: http://localhost:8080

The frontend is wired to the backend using frontend/src/services/api.ts and supports VITE_API_BASE_URL for deployed environments.

Run Automation Tests

1. cd automation
2. mvn test

Configure AI

Set environment variable OPENAI_API_KEY to use AI failure analysis. If not set, the automation framework uses a local fallback analyzer.

Future Improvements

• Add REST Assured API test module
• Replace H2 with MySQL
• Add GitHub Actions CI workflow