.

Angular Node Express Mongodb ecommerce website!

Content

• How to use this project ?

• Overview

• Features

• Architecture

• Frontend

• Backend

• Styling

• API's testing

How to use this project ?

• Clone the project in your local

• make sure you clone the project from the stable-main branch, then install node modules with npm:

npm install

• due to the use of monorepo, the shop and admin app are divided, you can run each of them with the following commands:

nx serve skshop --port=4100

nx serve admin --port=4200

• Make sure to use those exact ports please !

• Don't hesitate to fork the project and add more functionalities and send a pull request on the project

Overview

First of all my motivations that let me go for this project, and commit every single functionnality, is having a clear idea about how the MEAN stack works and how a Monorepo can affect the organization of my project. The project is an ecommerce platform, with all functionalities but payment, you can see it as a Cash on Delivery Platform.

• Skshop :
• Admin :

Features

In this project you can find, the following:

• JWT Authentication and Authorization

  • Admin user: Super admin Role
  • Guest user: Can be used to buy without creating personal account
  • Normal users: Personal accounts users's create

• Models: Products, Categories, Users, Reviews, Orders

• Rest API's by Role

  • Get, Add, update, delete
  • Admin can:
    • Get (Products, users, categories, orders),
    • Add (Products, users, categories),
    • Update (Products, users, categories),
    • Delete (Products, users, categories, reviews, orders)
  • Guest can:
    • Get (Products, categories),
    • Add (order),
    • Update (),
    • Delete ()
  • Normal User can:
    • Get (Products, categories, orders, user(Only himself) ),
    • Add (order),
    • Update ( user(Only himself) ),
    • Delete ()
  • Visitors with no account:
    • Get (Products, categories),
    • Add (),
    • Update (),
    • Delete ()

TO BE NOTED: the admin can not have access to the shop and buy products as an admin, it is denied from this functionnality, ans vice versa !

Architecture

The Project's architecture is based on the MonoRepo NX Architecture:

One of the best things about NX is the ability to generate modules, services Libraries etc.. without CLI command.

Quick Start & Documentation Of NX

Nx Documentation 10-minute video showing all Nx features Interactive Tutorial

The important things I did about the architecture of the project is avoiding the traditional way of Angular where every TS file is followed by its own CSS or SCSS file, instead i've created a global folder called Styles and placed all SCSS files inside with the same hierarchy, also i avoided generating Test file because i was focusing just on Developement without testing. Here is a clear idea about the architecture of the project:

Frontend

In the front end part I've used

• ANGULAR 14.5.7,
• typescript 4.7.2,
• Node v16.15.1,
• Npm 8.13.2,
• Nx 14.5.7,

Backend

In the back end part I've used

• Node v16.15.1,
• Express JS 4.18.1,
• Npm 8.13.2,
• Nodemon 2.0.19

Styling

For tyling I've used something very new for me,NG PRIME by PRIME FACES which i didn't know it even exist xD, It is so good, and can replace MATERIAL UI and TAILWIND, You can check it out here: https://www.primefaces.org/ http://primefaces.org/primeng/setup

API’s testing

For API Testing, Ive user the most famous Postman, and I've organized my api's requests as follows: