🛍️ E-Commerce Backend API

A powerful, secure, and feature-rich Spring Boot-based e-commerce backend, built with modular architecture, role-based authentication, and complete RESTful APIs for managing products, carts, orders, payments, wishlist, users, and more.

---

📑 Table of Contents

• 🔑 Features
• 🛠️ Tech Stack
• 🔐 Authentication & Roles
• 🧩 Project Structure
• 🔗 API Overview
• 🚀 Getting Started
• 📬 Sample Credentials
• 📮 Postman Collection
• 👩‍💻 Author

---

🔑 Features

• ✅ User Registration & Login with JWT Authentication
• 👥 Role-Based Access for USER and ADMIN
• 📦 Product Management (CRUD + filtering, sorting, pagination)
• 🛒 Shopping Cart (Add, update, remove, clear cart items)
• ❤️ Wishlist (Add/remove favorite products)
• 💳 Payment Simulation (Fake payment with order creation)
• 📦 Order Placement & History
• 🔄 Order Status Update by Admin (PROCESSING, SHIPPED, DELIVERED)
• 🧠 Global Exception Handling

---

🛠️ Tech Stack

• Spring Boot (REST APIs)
• Spring Security (JWT Auth)
• Spring Data JPA (Hibernate ORM)
• MySQL (Database)
• Lombok (Boilerplate reduction)
• Postman (API testing)
• Maven (Build tool)

---

🔐 Authentication & Roles

• JWT-based stateless authentication
• Secure endpoints using Spring Security filters
• @PreAuthorize for method-level security
• Roles:
  • USER: Can manage cart, wishlist, orders
  • ADMIN: Can manage products and update order status

---

🧩 Project Structure

src ├── main │ ├── java │ │ └── org.ecommerce │ │ ├── config # JWT & Security config │ │ ├── controller # All REST controllers │ │ ├── entity # JPA Entities (User, Product, CartItem, etc.) │ │ ├── enums # Enum for OrderStatus │ │ ├── exception # GlobalExceptionHandler │ │ ├── repository # JPA Repositories │ │ ├── service # Business logic │ │ └── util # JWT utilities │ └── resources │ ├── application.properties │ └── data.sql

---

🔗 API Overview

👤 User & Auth

Method	Endpoint	Description
POST	/api/auth/register	Register new user
POST	/api/auth/login	Login & receive JWT token

📦 Products

Method	Endpoint	Description
GET	/api/products	List products with filters/sorting
GET	/api/products/{id}	Get product by ID
POST	/api/products	Create product (Admin)
PUT	/api/products/{id}	Update product (Admin)
DELETE	/api/products/{id}	Delete product (Admin)

🛒 Cart

Method	Endpoint	Description
GET	/api/cart	View cart items
POST	/api/cart	Add item to cart
PUT	/api/cart/{itemId}	Update item quantity
DELETE	/api/cart/{itemId}	Remove item from cart
DELETE	/api/cart/clear	Clear all cart items

❤️ Wishlist

Method	Endpoint	Description
GET	/api/wishlist	Get wishlist items
POST	/api/wishlist/{productId}	Add product to wishlist
DELETE	/api/wishlist/{productId}	Remove product from wishlist

🛍️ Orders

Method	Endpoint	Description
POST	/api/orders	Place order (with fake payment)
GET	/api/orders	View user’s order history
PUT	/api/orders/{id}	Update status (Admin)

---

🚀 Getting Started

🔧 Prerequisites

• Java 17+
• MySQL
• Maven

📦 Setup Instructions

1. Clone the repo bash git clone https://github.com/your-username/ecommerce-backend.git cd ecommerce-backend

Configure DB in application.properties properties

spring.datasource.url=jdbc:mysql://localhost:3306/ecommerce_db spring.datasource.username=root spring.datasource.password=yourpassword

Build and Run bash mvn clean install mvn spring-boot:run

📬 Sample Credentials Role Email Password User user@example.com user123 Admin admin@example.com admin123

👩‍💻 Author Built by Farheen