Loading repository data…
Christfg1 / repository
Enterprise-style e-commerce REST API built with Java, Spring Boot, Spring Security, JPA/Hibernate, and MySQL. Features JWT authentication, category and product management, shopping cart functionality, role-based access control, and RESTful API design.
A complete backend for an online shopping platform featuring JWT authentication, role-based authorization, product and category management, shopping carts, user profiles, and checkout/order processing.
Spring Boot • Spring Security • JWT • MySQL • JPA • REST API
EasyShop API is the backend for an e-commerce web application. It provides secure authentication, public product browsing, admin-protected product and category management, persistent shopping carts, profile management, and checkout functionality.
The project follows a layered Spring Boot architecture:
Browse products, filter inventory, search items, and add products directly to the shopping cart.
Interactive API documentation for exploring and testing available endpoints.
View cart items, update quantities, review totals, and proceed to checkout.
Review order details and complete the checkout process.
Display a receipt after successfully placing an order.
| Feature | Description |
|---|---|
| Authentication | Users can register, log in, and access protected routes using JWT tokens. |
| Role-Based Authorization | Admin-only actions are restricted using Spring Security. |
| Product Search | Products can be filtered by category, price range, and subcategory. |
| Shopping Cart | Logged-in users can add products, update quantities, and clear their cart. |
| User Profile | Users can view and update their own profile information. |
| Checkout | Cart items are converted into an order with order line items. |
| API Documentation | Swagger UI documents and exposes all endpoints for testing. |
| Layer | Technology |
|---|---|
| Language | Java |
| Framework | Spring Boot |
| Security | Spring Security, JWT |
| Persistence | Spring Data JPA, Hibernate |
| Database | MySQL |
| Build Tool | Maven |
| API Testing | Insomnia |
| Documentation | Swagger |
| Version Control | Git, GitHub |
flowchart TD
A[Client Website / Insomnia / Swagger] --> B[REST Controllers]
B --> C[Service Layer]
C --> D[JPA Repositories]
D --> E[(MySQL Database)]
F[Spring Security + JWT Filter] --> B
sequenceDiagram
participant Client
participant Controller
participant Service
participant Repository
participant Database
Client->>Controller: HTTP Request
Controller->>Service: Call business logic
Service->>Repository: Request data operation
Repository->>Database: Query / Update
Database-->>Repository: Result
Repository-->>Service: Entity data
Service-->>Controller: Processed response
Controller-->>Client: JSON Response
src/main/java/org/yearup
│
├── controllers
│ ├── AuthenticationController
│ ├── CategoriesController
│ ├── ProductsController
│ ├── ShoppingCartController
│ ├── ProfileController
│ └── OrdersController
│
├── models
│ ├── Category
│ ├── Product
│ ├── CartItem
│ ├── ShoppingCart
│ ├── ShoppingCartItem
│ ├── Profile
│ ├── Order
│ ├── OrderLineItem
│ └── User
│
├── repository
│ ├── CategoryRepository
│ ├── ProductRepository
│ ├── ShoppingCartRepository
│ ├── ProfileRepository
│ ├── OrderRepository
│ ├── OrderLineItemRepository
│ └── UserRepository
│
├── security
│ ├── jwt
│ ├── WebSecurityConfig
│ ├── SecurityUtils
│ └── UserModelDetailsService
│
├── service
│ ├── CategoryService
│ ├── ProductService
│ ├── ShoppingCartService
│ ├── ProfileService
│ ├── OrderService
│ └── UserService
│
└── ECommerceApplication.java
| Method | Endpoint | Access | Description |
|---|---|---|---|
| POST | /register | Public | Register a new user |
| POST | /login | Public | Log in and receive a JWT |
| Method | Endpoint | Access | Description |
|---|---|---|---|
| GET | /categories | Public | Get all categories |
| GET | /categories/{id} | Public | Get category by ID |
| GET | /categories/{id}/products | Public | Get products by category |
| POST | /categories | Admin | Create category |
| PUT | /categories/{id} | Admin | Update category |
| DELETE | /categories/{id} | Admin | Delete category |
| Method | Endpoint | Access | Description |
|---|---|---|---|
| GET | /products | Public | Search or list products |
| GET | /products/{id} | Public | Get product by ID |
| POST | /products | Admin | Create product |
| PUT | /products/{id} | Admin | Update product |
| DELETE | /products/{id} | Admin | Delete product |
Optional product filters:
GET /products?cat=1
GET /products?minPrice=25
GET /products?minPrice=25&maxPrice=100
GET /products?cat=1&subCategory=Black
Example product response:
{
"productId": 1,
"name": "Smartphone",
"price": 499.99,
"categoryId": 1,
"description": "A powerful smartphone with advanced features.",
"subCategory": "Black",
"stock": 50,
"imageUrl": "smartphone.jpg",
"featured": false
}
| Method | Endpoint | Access | Description |
|---|---|---|---|
| GET | /cart | User | View current user's cart |
| POST | /cart/products/{productId} | User | Add product to cart |
| PUT | /cart/products/{productId} | User | Update product quantity |
| DELETE | /cart | User | Clear cart |
Example cart response:
{
"items": {
"1": {
"product": {
"productId": 1,
"name": "Smartphone",
"price": 499.99
},
"quantity": 2,
"discountPercent": 0,
"lineTotal": 999.98
}
},
"total": 999.98
}
| Method | Endpoint | Access | Description |
|---|---|---|---|
| GET | /profile | User | View logged-in user's profile |
| PUT | /profile | User | Update logged-in user's profile |
| Method | Endpoint | Access | Description |
|---|---|---|---|
| POST | /orders | User | Checkout and create an order |
Checkout creates an order, generates order line items from the shopping cart, and clears the cart after a successful purchase.
Protected endpoints require a JWT token.
POST /login
Content-Type: application/json
{
"username": "user",
"password": "password"
}
Authorization: Bearer <token>
Swagger UI also supports JWT authorization through the Authorize button.
git clone https://github.com/Christfg1/capstone-3-ecommerce-api.git
cd capstone-3-ecommerce-api
Run the EasyShop database script before starting the API.
mysql -u root -p < database/create_database_easyshop.sql
The database script creates the schema, sample products, categories, and default demo users.
Default demo accounts:
| Role | Username | Password |
|---|---|---|
| User | user | password |
| Admin | admin | password |
| User | george | password |
Update:
src/main/resources/application.properties
Example:
spring.datasource.url=jdbc:mysql://localhost:3306/easyshop
spring.datasource.username=root
spring.datasource.password=YOUR_PASSWORD
mvn spring-boot:run
or run:
ECommerceApplication.java
The API will start at:
http://localhost:8080
Swagger UI:
http://localhost:8080/swagger-ui/index.html
The frontend client is separate from the API project.
To run the EasyShop website:
capstone-client-easyshop folder.http://localhost:8080.The API was tested using:
Tested flows include:
The API uses JWT authentication instead of server-side sessions. After loggi
Selected from shared topics, language and repository description—not editorial ratings.
MuammadUmer /
An enterprise-style, cloud-native e-commerce application built while learning Java and Spring Boot, showcasing production-ready development practices with Clean Architecture, Spring Security, JPA, REST APIs, PostgreSQL, Docker, Kubernetes, Terraform, Google Cloud Platform (GCP), BigQuery, and comprehensive testing.