Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ahmedukamel/e-commerce
Innovative e-commerce platform designed to revolutionize the digital shopping experience for both businesses and consumers.
https://github.com/ahmedukamel/e-commerce
i18n internationalization java jdbc-connector multi-language mysql oauth2 rest-api restful-api role-based-access-control spring-boot spring-data spring-data-jpa spring-framework spring-security springboot sql-database validation
Last synced: 1 day ago
JSON representation
Innovative e-commerce platform designed to revolutionize the digital shopping experience for both businesses and consumers.
- Host: GitHub
- URL: https://github.com/ahmedukamel/e-commerce
- Owner: AhmedUKamel
- License: mit
- Created: 2024-02-13T17:10:30.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-03-12T18:50:34.000Z (7 months ago)
- Last Synced: 2024-09-23T22:32:24.305Z (1 day ago)
- Topics: i18n, internationalization, java, jdbc-connector, multi-language, mysql, oauth2, rest-api, restful-api, role-based-access-control, spring-boot, spring-data, spring-data-jpa, spring-framework, spring-security, springboot, sql-database, validation
- Language: Java
- Homepage:
- Size: 566 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
E - Commerce
Introduction •
Overview •
Main Features •
Dependencies •
Configuration •
Download •
Start Application •
How To Use •
Documentation •
License
## Introduction
E-commerce, revolutionizes the way businesses and consumers interact in the digital age. It encompasses the buying and selling of products and services over the internet, making transactions seamless and accessible from anywhere with an internet connection.
## Overview
![]()
Information
![]()
Quantity
Lines of Code
7.5K+
Java Classes
240+
Endpoints
130+
Tables
30
- View database schema diagram on [dbdiagram.io](https://dbdiagram.io/d/E-Commerce-65ca0de8ac844320aef41179)
- Explore the database schema details on [dbdocs.io](https://dbdocs.io/ahmedukamel/E-Commerce)
## Main Features
- [x] Comprehensive Multilingual Support **(Internationalization - i18n)**
- platform offers robust multilingual support (i18n) implemented at both database and coding levels, ensuring seamless communication and user experience across languages
- [x] Guest Browsing
- Allow users to view and browse products and categories without requiring account creation, enhancing accessibility and user experience.
- [x] Role-Based Access Control **(RBAC)**
1. **_Customer:_** Represents the end-users who browse and make purchases on the platform
2. **_Super Admin:_** Manages system-wide user accounts, with the ability to enable or disable accounts and assign or modify user roles as needed
3. **_Admin:_**
- Manage categories and sub-categories
- Manage products and pricing
- Oversee customer notifications
- Monitor product reviews and review reports
- Track demand for unavailable products
4. **_Delivery:_**
- Access all prepared orders awaiting delivery
- Manage order statuses and shipment details
5. **_Content Creator:_** Manages advertisements and blog posts
- [x] Authentication via Json Web Tokens **(JWT)**
- [x] OAuth2 with **Google** and **Facebook**
- [x] Mail Sender Service
- Account Activation Email
- Forget Password Email
- [x] Account Management
- Allow users to manage their profiles, and addresses
- [x] Category and Sub-category Navigation
- Explore and refine search results effortlessly by organized categories and sub-categories
- [x] Wishlist
- list of favorite products for future reference or purchase, facilitating easy access and organization of desired items
- [x] Notifications
- Provide users with the option to receive alerts and notifications for price reductions or product restocks on items saved in their wishlist, ensuring they stay informed about relevant updates and opportunities
- [x] Product Review and Rating System
- Enable customers to provide feedback and ratings for products, facilitating informed decision-making for other shoppers
- Additionally, provide the functionality to report reviews as necessary
- [x] Order Tracking
- Allow customers to track the status of their orders in real-time, providing updates from processing to delivery.
- [x] Compatibility Across Platforms
- Supported on _Linux_, _macOS_, and _Windows_
## Dependencies
- **JDK 17**
- Visit the official Oracle website and choose an operating system file from [here](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)
- Follow the provided installation instructions tailored to your operating system
- **MySQL Installation**
- Download the installer from the official MySQL website [here](https://dev.mysql.com/downloads/mysql/)
- Proceed with the installation steps specific to your operating system
## Configuration
- Write the following commands in `MySQL Command Line Client` to create user, grant privileges, and create database.
```sql
CREATE USER 'ecommerce_user'@'localhost' IDENTIFIED BY 'password_ecommerce';
```
```sql
GRANT ALL PRIVILEGES ON * . * TO 'ecommerce_user'@'localhost';
```
```sql
FLUSH PRIVILEGES;
```
```sql
CREATE DATABASE e_commerce_api_database;
```
## Download
You can find the JAR file for download by accessing the repository. Simply click `Download ZIP` on the repository link or click [here](https://github.com/AhmedUKamel/E-Commerce/archive/refs/heads/main.zip) to access the repository files. Alternatively, you can use Git by following the command below:
```bash
git clone https://github.com/AhmedUKamel/E-Commerce.git
```
## Start Application
```bash
cd path/to/E-Commerce/output
```
```bash
java -jar ecommerce-0.0.1-SNAPSHOT.jar
```
**Output**
INFO 49785 --- [ restartedMain] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port 8080 (http) with context path ''
INFO 49785 --- [ restartedMain] o.a.ecommerce.EcommerceApplication : Started EcommerceApplication in x seconds (process running for x)
## How To Use
- Open preferred browser and go to **http://localhost:8080** or **http://127.0.0.1:8080**
**Output**
## Documentation
To utilize the e-commerce APIs effectively, please refer to the comprehensive documentation provided through Postman. This documentation offers detailed insights into the available endpoints, request parameters, and response formats.
Access the documentation here: [Documentation on Postman](https://documenter.getpostman.com/view/26297954/2s9YysBLzk#f94594c2-abc2-4ec9-a081-799976c08d65)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
Follow me on LinkedIn
@ahmedukamel