E-commerce store website application

Overview

This E-commerce store web application is built for a business and their customers. It allows admin users to list the business products and customer users to make purchases.

Features

• RESTful APIs to support CRUD operations.
• A search bar to find specific products, categories, and brands
• PayPal payment integrations.
• Responsive user interface.

Prerequisites

• Node.js: 22.12.0 (or newer).

Structure

This website is composed of 3 sections:

• Frontend: The frontend section of this application is build with Vue.js framework features and its components.
• Backend: Built with express.js framework.It is the main part of the website as it houses controllers, endpoints, and middlewares to Create RESTful APIs that interact with the frontend and perform CRUD operations on the database.
• Database: The websites' backend is connected to MongoDB Atlas database, a noSQL database in a cloud servers, to securely store data. The database Schema is consisted of 5 models:
  • Product
  • Category
  • Brand
  • Purchase
  • User

How to run

1. Open terminal in a directory of choice and Clone the project by running "git clone https://github.com/Abdullahmohammadaref/e-commerce_web_application"
2. Run "cd e-commerce_web_application"
3. Run "cd backend"
4. Run "npm install"
5. Run "npm run dev"
6. Open another terminal in the project root directory "e-commerce_web_application"
7. Run "cd frontend"
8. Run "npm run dev"
9. Open the localhost url shown in terminal (its usually "http://localhost:5173/") )

The following are admin user credentials that are required to access admin forms:

• Username: admin
• Password: admin

How to deploy in a server

1. Open terminal inside frontend application directory and run "npm run build"
2. Move newly generated "dist" folder contents to "public" folder inside backend directory
3. Run "npm start" inside the backend directory