Skip to content

ShopZone is a feature-rich e-commerce application designed to provide a smooth online shopping experience. It features a dynamic product catalog, advanced search and filtering capabilities, and a complete checkout workflow, making it a robust platform for digital retail.

Notifications You must be signed in to change notification settings

SanjayMarathi/ShopZone

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

πŸ“Έ Screenshots

πŸ›οΈ Product Catalog Page (Home)

  Product Catalog

  The main product catalog page. Displays all items with name, price (discounted), image, and stock status in the dark theme. Includes pagination and a search bar.


πŸ” Search & Filter Bar

  Search and Filter Bar

  High-contrast search bar that allows filtering of products by item name. Integrated directly into the main product catalog page.


πŸ’Ž Item Detail View

  Item Detail View

  Opens when a customer taps on a product. Shows a larger image, full description, and clear display of original vs. discount price.


πŸ›’ Shopping Cart Management

  Shopping Cart

  Displays selected items, quantity controls, and calculates the total price using the discount price. The final button initiates the two-step checkout process.


πŸ’³ Checkout Summary & Payment Step

  Checkout Summary

  The mandatory final step showing the order summary, total price, and the PAY NOW & CONFIRM ORDER button which triggers transactional stock deduction.


πŸ’³ UPI Payment QR Code Payment

  UPI QR Payment

  This feature provides a **seamless and secure instant payment** option. When selected, the system instantly generates a unique QR code. Customers can scan this code with any UPI app (like Google Pay or PhonePe), and the application will automatically pre-fill the **exact total amount** of the order, allowing for a quick, error-free transaction with a single tap.


πŸ›’ Shopping Information

  Checkout Summary

  Displays essential shopping details such as cart items, total price, quantity updates, remove item option, and checkout flow. Styled in the same dark/yellow theme for consistency. It ensures a smooth shopping experience with real-time updates.


πŸŽ‰ Order Successful Page

  Order Status Success

  Final confirmation page shown after a successful transaction. Confirms that stock has been deducted and prompts the user to continue shopping (clearing the local storage cart).


πŸ›’ ShopZone – High-Contrast E-Commerce Platform

ShopZone is a modern Django project that provides:

βœ… A high-contrast, dark-themed online product catalog.

βœ… A secure, transactional checkout system with atomic stock deduction.

βœ… Comprehensive inventory and product management (via Django Admin).

This is not a simple template β€” it is a secure e-commerce solution focusing on premium presentation and data integrity.

βœ… Key Features

πŸ’» Backend / Inventory Integrity

β€’ **Atomic Stock Deduction:** Uses Django transactions to guarantee stock reduction or full rollback.
β€’ **Concurrency Safety:** Employs select_for_update() to prevent overselling during simultaneous checkouts.
β€’ **Discount Logic:** Checkout automatically validates and applies the discount_price if it's lower than the original price.
β€’ **Stock Tracking:** Stock is checked client-side and verified again server-side at checkout.

πŸ“± Shopper Experienc

β€’ High-Contrast UI: Dark theme accented by vibrant Orange/Yellow for a premium feel.
β€’ Persistent Cart: Uses local storage (JS/jQuery) to maintain cart items across sessions.
β€’ Price Clarity: Clearly displays original price with a strike-through next to the discounted price.
β€’ Two-Step Checkout: Provides an Order Summary step before final payment confirmation.  

πŸ’» Technology Stack

Backend: Django 5 (Python)
Database Safety: django.db.transaction + select_for_update
Frontend: Bootstrap 5 + Custom CSS (Dark Theme/Orange Accents)
Client Cart: JavaScript (localStorage) / jQuery
Database: SQLite (Development)  

βš™οΈ Setup & Installation

1️⃣ Clone Repository

git clone https://github.com/SanjayMarathi/ShopZone.git
cd ShopZone

2️⃣ Create & Activate Virtual Environment

python -m venv venv

Windows

.\venv\Scripts\activate

macOS/Linux

source venv/bin/activate

3️⃣ Install Dependencies

pip install -r requirements.txt

4️⃣ Apply Migrations

python manage.py makemigrations myapp
python manage.py migrate

5️⃣ Create Superuser

python manage.py createsuperuser

6️⃣ Run Server

python manage.py runserver

App opens at:

http://127.0.0.1:8000/

🚦 Usage Guide

βœ… Staff / Admin Workflow

1. Login to Admin Panel β†’ http://127.0.0.1:8000/admin/
2. **Manage Products:** Add, edit, or delete items, setting price, discount, and stock.
3. **Monitor Database:** All successful transactions lead to atomic stock deduction.

Dashboard:

http://127.0.0.1:8000

βœ… Customer Workflow

1. Login to Admin Panel β†’ http://127.0.0.1:8000/admin/
2. **Manage Products:** Add, edit, or delete items, setting price, discount, and stock.
3. **Monitor Database:** All successful transactions lead to atomic stock deduction.

βœ… Project Structure

ShopZone/
│── shop/
β”‚   β”œβ”€β”€ templates/shop/
β”‚   β”‚   β”œβ”€β”€ index.html       # Product Catalog
β”‚   β”‚   β”œβ”€β”€ cart.html        # Cart Management
β”‚   β”‚   β”œβ”€β”€ checkout.html    # Summary / Status Page
β”‚   β”‚   β””── detail.html      # Individual Product View
β”‚   β”œβ”€β”€ static/shop/
β”‚   β”‚   β””── style.css        # Custom Dark Theme
β”‚   β”œβ”€β”€ models.py            # Products (with stock and discount_price)
β”‚   β””── views.py             # Transactional Checkout logic
β”‚
│── ecomsite/
β”‚   β”œβ”€β”€ settings.py
β”‚   β””── urls.py

βœ… Author

Developed by: Sanjay Marathi
GitHub: https://github.com/SanjayMarathi

About

ShopZone is a feature-rich e-commerce application designed to provide a smooth online shopping experience. It features a dynamic product catalog, advanced search and filtering capabilities, and a complete checkout workflow, making it a robust platform for digital retail.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published