✨ MISK is a full-stack e-commerce platform for selling perfumes. This repository contains only the backend project; the frontend is implemented separately in an Angular project: MISK Ecommerce Angular Frontend
- 🔐 Authentication & Authorization: Secure JWT-based login with role-based access (User/Admin).
- 👤 User Profile Management: View and edit personal information.
- 📦 Product Management: View all products, product details, stock tracking, filtering by name or category, and pagination.
- 🛒 Cart & Billing: Add/remove product quantities, real-time total cost updates.
- 🧾 Order Management: Cash or Visa payment, payment validation, automatic confirmation emails.
- 🛠️ Admin Dashboard: Manage products, users, and orders efficiently.
- 📝 API Documentation: All endpoints documented using Swagger / Springdoc OpenAPI.
- Language: Java 21
- Frameworks: Spring Boot (including MVC, AOP, Security)
- Database & ORM: MySQL, JPA/Hibernate
- Build & Dependency Management: Maven
- Libraries & Tools: REST APIs, Lombok, MapStruct, JWT, Swagger/OpenAPI, Spring Mail
- Logging: SLF4J + Logback
The following diagram illustrates the core database structure and relationships used in the MISK backend:
Before running the project, make sure you have the following installed:
- Java 21
- MySQL
- Maven
Follow these steps to run the backend locally:
- Clone the repository:
git clone https://github.com/ghaidaaeldsoky/Restful-E-Commerce-App-Spring.git
cd Restful-E-Commerce-App-Spring- Create a MySQL database (e.g.,
misk_db) and update the database configuration insrc/main/resources/application.properties:
spring.datasource.url=jdbc:mysql://localhost:3306/misk_db
spring.datasource.username=YOUR_USERNAME
spring.datasource.password=YOUR_PASSWORD- Build and run the application using Maven:
mvn clean install
mvn spring-boot:runThe application runs on port 8085 by default.
-
Access the application at: http://localhost:8085
-
Test the REST APIs
- Use Postman or any REST client.
- API documentation is available via Swagger: http://localhost:8085/swagger-ui/index.html
The system supports role-based access control using JWT authentication:
- Register and authenticate securely
- Browse products and view product details
- Add products to cart and manage quantities
- Place orders using cash or Visa payment
- Receive order confirmation via email
- View and edit personal profile information
- Manage products, users, and orders (create, update, soft delete, stock tracking)
- Access secured admin-only endpoints
This project was developed as the graduation project at the Information Technology Institute (ITI) as part of the full-stack Java track. It was built collaboratively by a team of five members to simulate a real-world e-commerce platform environment.
📌 We welcome your questions, feedback, or collaboration opportunities!