eCart Discount Shop: An eCommerce .NET and Angular Project

This is a full-stack eCommerce application built using .NET Core for the backend and Angular for the frontend. The application allows users to browse products, add items to the cart, and make purchases.

Table of Contents

• Project Overview
• Features
• Tech Stack
• Installation
  • Backend Setup
  • Frontend Setup
• Usage
• API Documentation
• Contributing
• License

Project Overview

This eCommerce platform allows customers to browse products, add them to the shopping cart, and proceed to checkout. The application is split into two parts:

• Backend: A RESTful API built using .NET 9.0 that handles product management, user authentication, and order processing.
• Frontend: A single-page application built with Angular that communicates with the backend API to display products, manage the cart, and handle user interactions.

Features

• User registration and login
• Product listing and search functionality
• Add products to the shopping cart
• Checkout and order management
• Admin panel to manage products and orders (upcoming by 15th Jan, 2025)

Tech Stack

• Backend:

  • .NET 9.0 (ASP.NET Core Web API)
  • Entity Framework Core
  • Redis for Caching as Performance Optimization
  • SQLite (for database storage)
  • Stripe for Payment Processing
  • Package Categorization

  Category	Packages
  Frameworks	1. Microsoft.AspNetCore.Identity 2. Microsoft.AspNetCore.Identity.EntityFrameworkCore 3. Microsoft.EntityFrameworkCore.Design 4. Microsoft.EntityFrameworkCore.Sqlite 5. Npgsql.EntityFrameworkCore.PostgreSQL 6. Microsoft.AspNetCore.Authentication.JwtBearer
  Tools	1. Swashbuckle.AspNetCore 2. AutoMapper.Extensions.Microsoft.DependencyInjection
  Libraries	1. AutoMapper 2. EPPlus 3. Microsoft.IdentityModel.Tokens 4. System.IdentityModel.Tokens.Jwt 5. StackExchange.Redis 6. SendGrid 7. SendWithBrevo 8. sib_api_v3_sdk 9. Stripe.net
  Hybrid	1. Microsoft.AspNetCore.OpenApi

• Frontend:

  • Angular 19
  • Angular Material for UI components
  • RxJS for reactive programming
  • Package Categorization

  Category	Packages
  Frameworks	1. @angular/animations 2. @angular/cdk 3. @angular/cli 4. @angular/common 5. @angular/compiler 6. @angular/compiler-cli 7. @angular/core 8. @angular/forms 9. @angular/platform-browser 10. @angular/platform-browser-dynamic 11. @angular/router
  Tools	1. @angular-devkit/build-angular 2. @types/jasmine 3. jasmine-core 4. karma 5. karma-chrome-launcher 6. karma-coverage 7. karma-jasmine 8. karma-jasmine-html-reporter 9. typescript 10. zone.js
  Libraries	1. @stripe/stripe-js 2. bootstrap 3. bootswatch 4. cuid 5. font-awesome 6. ngx-bootstrap 7. ngx-spinner 8. ngx-toastr 9. rxjs 10. tslib 11. xlsx 12. xng-breadcrumb

• Authentication:

  • JWT (JSON Web Tokens) for user authentication

Installation

Backend Setup

1. Clone the repository:

   git clone /~https://github.com/HaseebAhmed49/eCart
   cd eCart
   

2. Navigate to the backend folder and restore the dependencies:

   cd eCart.API/eCart.API
   dotnet restore
   

3. Set up the database and secret Keys for Email Notification and Stripe Payment in appsettings.json

(SQLite path "eCart.API/eCart.API/Data/Database"):

Secret Keys

5. Configure Redis for caching on your local machine as localhost as shown in the above image

6. Run the backend:

   dotnet run
   

7. The backend will be available at https://localhost:7167. Swagger Link: https://localhost:7167/swagger.html

Front Setup

1. Navigate to the frontend folder:

   cd eCart.SPA
   

2. Install the dependencies:

   npm install
   

3. Run the frontend:

   ng serve -o
   

The frontend will be available at https://localhost:4200.

Usage

Once both the backend and frontend are running, you can:

1. Open the frontend application in your browser (http://localhost:4200).
2. Register a new account or log in with an existing account.
3. Browse the product catalog, add items to the shopping cart, and proceed to checkout.
4. Admin users can log in to manage products and orders.

API Documentation

Controller: Account

1. | GET | paths['/api/Account']
2. | GET | paths['/api/Account/email']
3. | POST | paths['/api/Account/login']
4. | POST | paths['/api/Account/register']
5. | GET | paths['/api/Account/ConfirmEmail']
6. | GET | paths['/api/Account/address']
7. | PUT | paths['/api/Account/address']
8. | GET | paths['/api/Account/GetAllUsers']

Controller: Basket

1. | GET | paths['/api/Basket']
2. | POST | paths['/api/Basket']
3. | DELETE | paths['/api/Basket']

Controller: Excel

1. | POST | paths['/api/Excel/export']

Controller: Orders

1. | POST | paths['/api/Orders']
2. | GET | paths['/api/Orders']
3. | GET | paths['/api/Orders/{id}']
4. | GET | paths['/api/Orders/delivery']

Controller: Payments

1. | POST | paths['/api/Payments/{basketId}']
2. | POST | paths['/api/Payments/webHook']

Controller: Products

1. | GET | paths['/api/Products/get-products-without-pagination']
2. | GET | paths['/api/Products']
3. | GET | paths['/api/Products/{id}']
4. | GET | paths['/api/Products/brands']
5. | GET | paths['/api/Products/types']

Contributing

We welcome contributions! If you would like to contribute to the project, please fork the repository and submit a pull request. Make sure to follow the code style and add documentation for any new features or bug fixes.

License

This project is free to use for learning purposes.