ShopHive

A full-stack e-commerce platform built with Spring Boot and React, featuring secure authentication, product management, shopping cart, and order processing.

---

Overview

ShopHive is a full-stack e-commerce application that enables users to browse products, manage shopping carts, and place orders through a secure and intuitive interface.

The backend is built using Spring Boot with JWT-based authentication, while the frontend is developed using React. The platform demonstrates scalable backend architecture, secure REST APIs, and efficient database design for modern e-commerce systems.

---

Features

Authentication & Authorization

• User Registration & Login
• JWT Authentication
• Role-Based Access Control
• Secure Password Encryption

---

Product Management

• Browse Products
• Product Categories
• Product Search
• Product Details
• Inventory Management

---

Shopping Cart

• Add/Remove Products
• Quantity Management
• Price Calculation
• Persistent Cart

---

Order Management

• Place Orders
• Order History
• Order Tracking
• Order Status Management

---

Admin Features

• Manage Products
• Manage Categories
• View Orders
• Inventory Updates

---

System Architecture

                 React Frontend
                        │
                        ▼
                 REST Controllers
                        │
                        ▼
               Spring Boot Services
                        │
         ┌──────────────┴──────────────┐
         ▼                             ▼
 Business Logic                 Authentication
                                     │
                                     ▼
                            Spring Security + JWT
                                     │
                                     ▼
                             Spring Data JPA
                                     │
                                     ▼
                                   MySQL

---

Tech Stack

Backend

• Java
• Spring Boot
• Spring Security
• Spring Data JPA
• Hibernate

Frontend

• React
• Vite
• Tailwind CSS

Database

• MySQL

Authentication

• JWT

Tools

• Maven
• Git
• Postman

---

Core Modules

Authentication

• Registration
• Login
• JWT Token Generation
• Authorization

---

Product Service

Responsible for

• Product CRUD
• Category Management
• Search
• Inventory

---

Cart Service

Supports

• Add Item
• Remove Item
• Update Quantity
• Cart Total Calculation

---

Order Service

Handles

• Checkout
• Order Placement
• Order History
• Status Updates

---

Database Design

Main entities

• User
• Product
• Category
• Cart
• CartItem
• Order
• OrderItem

The schema is normalized to ensure efficient data storage and maintain referential integrity.

---

REST APIs

Authentication

POST /api/auth/register
POST /api/auth/login

---

Products

GET    /api/products
GET    /api/products/{id}
POST   /api/products
PUT    /api/products/{id}
DELETE /api/products/{id}

---

Cart

GET    /api/cart
POST   /api/cart/items
PUT    /api/cart/items/{id}
DELETE /api/cart/items/{id}

---

Orders

POST /api/orders
GET  /api/orders
GET  /api/orders/{id}

---

Performance Highlights

• JWT-secured REST APIs
• Normalized relational database design
• Modular service-oriented architecture
• Efficient order and inventory management
• Responsive React frontend

---

Future Enhancements

• Payment Gateway Integration
• Wishlist
• Product Reviews
• Email Notifications
• Redis Caching
• Elasticsearch
• Docker
• Kubernetes Deployment
• Recommendation Engine

---

Getting Started

Clone the repository

git clone https://github.com/AryanGupta833/ShopHive.git

Navigate to the project

cd ShopHive

Backend

mvn spring-boot:run

Frontend

npm install
npm run dev

---

Future Vision

ShopHive aims to evolve into a production-ready e-commerce platform with scalable microservices, cloud deployment, advanced search capabilities, and AI-powered product recommendations.

---

Author

Aryan Gupta

• GitHub: https://github.com/AryanGupta833
• LinkedIn: https://linkedin.com/in/aryan-gupta-316a35366