https://github.com/anmol283/e-commerceministore
🛒 E-Commerce Mini Store | Spring Boot & Java backend ⚡ JWT Auth 🔐 | MySQL 💾 | REST APIs for Products, Cart & Orders 📦
https://github.com/anmol283/e-commerceministore
ecommerce-website java21 jwt-token springboot springsecurity-jwt
Last synced: 8 months ago
JSON representation
🛒 E-Commerce Mini Store | Spring Boot & Java backend ⚡ JWT Auth 🔐 | MySQL 💾 | REST APIs for Products, Cart & Orders 📦
- Host: GitHub
- URL: https://github.com/anmol283/e-commerceministore
- Owner: Anmol283
- License: mit
- Created: 2025-09-03T07:29:30.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-03T13:36:03.000Z (8 months ago)
- Last Synced: 2025-10-03T15:34:22.701Z (8 months ago)
- Topics: ecommerce-website, java21, jwt-token, springboot, springsecurity-jwt
- Language: HTML
- Homepage:
- Size: 243 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
🛒🛍️ E-commerce Mini Store
Secure shopping, smooth coding.
---
## ✨ Overview
E-Commerce Mini Store is a full-stack web application leveraging Spring Boot, Java, JWT, and MySQL, designed with a scalable microservices architecture. It provides a complete platform for product management, cart handling, order checkout, and user authentication with roles (CUSTOMER and MANAGER).
---
## 🌟 Features
- **👤 User Authentication**
- Register and login functionality
- Role-based access (CUSTOMER and MANAGER)
- JWT-based stateless authentication
- **🛍️ Product Mangement**
- Managers can add, update, and delete products
- Customers and Managers can view all available products
- **🛒 Cart System**
- Add, update, and remove items from cart
- Customers can checkout orders
---
## 🛠️ Tech Stack
| Category | Technologies |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Backend** | 
|
| **Database** | 
|
| **Security** | 
|
| **Frontend** | 
|
| **Microservices** | 
|
---
## 📁 Directory Structure
```
.idea/
├── .gitignore
├── compiler.xml
├── encodings.xml
├── jarRepositories.xml
├── misc.xml
└── vcs.xml
api-gateway/
├── .mvn/
└── wrapper/
└── maven-wrapper.properties
├── src/
├── main/
├── java/
└── com/
└── example/
└── api_gateway/
├── config/
├── CircuitBreakerConfig.java
└── GatewayConfig.java
├── fallback/
└── FallbackController.java
└── ApiGatewayApplication.java
└── resources/
└── application.properties
└── test/
└── java/
└── com/
└── example/
└── api_gateway/
└── ApiGatewayApplicationTests.java
├── .gitattributes
├── .gitignore
├── mvnw
├── mvnw.cmd
└── pom.xml
E-commerceMiniStore/
├── .mvn/
└── wrapper/
└── maven-wrapper.properties
├── src/
├── main/
├── java/
└── com/
└── example/
└── E_commerceMiniStore/
├── config/
└── PasswordConfig.java
├── controller/
├── AuthController.java
├── CartItemController.java
├── OrderController.java
├── ProductController.java
└── ViewController.java
├── entity/
├── CartItem.java
├── Order.java
├── Product.java
├── Role.java
└── User.java
├── repository/
├── CartItemRepository.java
├── OrderRepository.java
├── ProductRepository.java
└── UserRepository.java
├── security/
├── JwtAuthenticationFilter.java
├── JwtService.java
└── SecurityConfig.java
├── service/
├── CartItemService.java
├── OrderService.java
├── ProductService.java
└── UserService.java
└── ECommerceMiniStoreApplication.java
└── resources/
├── META-INF/
└── additional-spring-configuration-metadata.json
├── static/
├── Login.html
├── navbar.js
├── QR.jpeg
└── Register.html
├── templates/
├── cart.html
├── dashboard.html
├── inventory.html
├── login.html
├── payment.html
├── products.html
└── register.html
└── application.properties
└── test/
└── java/
└── com/
└── example/
└── E_commerceMiniStore/
└── ECommerceMiniStoreApplicationTests.java
├── .gitattributes
├── .gitignore
├── mvnw
├── mvnw.cmd
└── pom.xml
service-discovery/
├── .mvn/
└── wrapper/
└── maven-wrapper.properties
├── src/
├── main/
├── java/
└── ServiceDiscoveryApplication.java
└── resources/
└── application.properties
└── test/
└── java/
└── com/
└── example/
└── service_discovery/
└── ServiceDiscoveryApplicationTests.java
├── .gitattributes
├── .gitignore
├── mvnw
├── mvnw.cmd
└── pom.xml
LICENSE
README.md
```
---
## 🚀 Getting Started
### Prerequisites
- Java 21
- Maven
- MySQL
- Postman (for API testing)
### Installation
1. **Clone the Repository**:
```bash
git clone https://github.com/Anmol283/E-commerceMiniStore
cd E-Commerce-MiniStore
```
2. **Configure Database**:
Update `application.properties` with your `MySQL` credentials:
```bash
spring.datasource.url=jdbc:mysql://localhost:3306/ecommerce_db
spring.datasource.username=root
spring.datasource.password=your_password
spring.jpa.hibernate.ddl-auto=update
jwt.secret=YourSecretKey
jwt.expirationMs=3600000
```
4. **Build and run the application**:
```
mvn clean install
mvn spring-boot:run
```
---
## 🧭 API USAGE FOR TESTING IN POSTMAN
### Auth
- POST `/api/auth/register` – Register new user
- POST `/api/auth/login` – Login and get JWT
### Products
- GET `/api/products` – Get all products (any role)
- POST `/api/products` – Add product (MANAGER only)
- PUT `/api/products/{id}` – Update product (MANAGER only)
- DELETE `/api/products/{id}` – Delete product (MANAGER only)
### Cart
- GET `/api/cart?userId={id}` – Get cart items (CUSTOMER only)
- POST `/api/cart/add` – Add item to cart (CUSTOMER only)
- PUT `/api/cart/{id}` – Update cart item (CUSTOMER only)
- DELETE `/api/cart/{id}` – Remove cart item (CUSTOMER only)
### Orders
- GET `/api/orders/my?userId={id}` – Get user orders (CUSTOMER only)
- POST `/api/orders/checkout?userId={id}` – Checkout cart (CUSTOMER only)
---
## 🔒 Security Features
- JWT-based stateless authentication
- Role-based access `(CUSTOMER and MANAGER)`
- Password hashing with BCrypt
- Protected API routes using Spring Security
---
## 🌐 API Gateway
- **Routing:** All requests go through the API Gateway before reaching microservices
- **Load Balancing:** Can distribute traffic between service instances
- **Fallbacks:** Resilience4j circuit breakers ensure safe fallback responses if a service is down
---
## ⚡ Resilience & Fault Tolerance
- **Resilience4j Circuit Breaker:** Protects services from cascading failures
- **Fallback Mechanisms:** If a microservice fails, the gateway provides default/fallback responses
- **Timeouts & Retry Policies:** Ensures API responsiveness even during service downtime
---
## 🤝 Contributing
1. Fork the repository
2. Create a new branch (`git checkout -b feature-branch`)
3. Make your changes and commit (`git commit -m "Add feature"`)
4. Push to the branch (`git push origin feature-branch`)
5. Create a Pull Request
---
## 📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
---
⭐ **Star this repository if you find it useful!** ⭐