🛍️ DeshiCommerce - Django eCommerce Web Application

DeshiCommerce is a full-featured, dynamic eCommerce web application built using Django and PostgreSQL. It includes everything you need to run an online store: product listings, variations (color/size), add-to-cart functionality, customer reviews and ratings, user authentication, admin controls, and more.

Designed to be clean, professional, and fully scalable.

---

🚀 Features

• 🛒 Product listing with category filtering
• 🔍 Product detail pages with image gallery and variations
• 🛍️ Add to cart with stock check
• 🧾 Dynamic cart system
• ⭐ Customer reviews and star-based rating system (0.5 to 5 stars)
• 🔐 User registration, login, and logout
• 🧑 Admin dashboard via Django Admin
• 🖼️ Media uploads for product images
• 📅 Auto timestamps for reviews and products
• 🧠 Smart review handling (only one review per user per product; updatable)
• 📱 Responsive UI using Bootstrap

---

🧑‍💻 Tech Stack

• Backend: Django 5.x
• Frontend: HTML5, Bootstrap, Font Awesome
• Database: PostgreSQL
• Authentication: Django’s built-in auth system
• Reviews & Ratings: Custom ReviewRating model with rating radio buttons
• Cart System: Session-based, supports variations

---

📁 Project Structure

deshiCommerce/
├── accounts/               # User model and auth views
├── store/                  # Product, Category, ReviewRating models
├── carts/                  # Cart and cart items
├── templates/
│   ├── base.html
│   ├── store/
│   │   ├── product_detail.html
│   │   ├── category.html
├── static/                 # CSS, JS, and images
├── media/                  # Uploaded product images
├── manage.py
├── requirements.txt
└── db.postgresql

---

⚙️ Setup Instructions

1. Clone the Repository

git clone https://github.com/your-username/deshiCommerce.git
cd deshiCommerce

2. Create Virtual Environment

python -m venv venv
# Activate virtualenv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

3. Install Requirements

pip install -r requirements.txt

4. PostgreSQL Configuration

Update the DATABASES section in settings.py:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_db_name',
        'USER': 'your_db_user',
        'PASSWORD': 'your_db_password',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

5. Migrate Database & Create Superuser

python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser

6. Run Server

python manage.py runserver

Then visit: http://127.0.0.1:8000

---

✨ Admin Panel

• URL: /admin/
• Manage:
  • Products
  • Categories
  • Variations
  • Review ratings
  • Users

---

⭐ Review & Rating System

Each product has its own review section:

• Logged-in users can:
  • Submit one review per product
  • Edit their review later
• Rating uses 0.5 to 5 stars
• Star icons rendered dynamically with logic
• Review model:

class ReviewRating(models.Model):
    product = models.ForeignKey(Product, on_delete=models.CASCADE)
    user = models.ForeignKey(Account, on_delete=models.CASCADE)
    subject = models.CharField(max_length=100, blank=True)
    review = models.TextField(max_length=500, blank=True)
    rating = models.DecimalField(max_digits=2, decimal_places=1)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

---

🧾 Cart System

• Session-based cart with variation handling
• Select color and size (if applicable) before adding to cart
• Quantity and stock managed dynamically
• Cart stored per user (or session if not logged in)

---

🖼️ Media Uploads

Images for products are stored in /media/. Make sure to configure:

MEDIA_URL = '/media/'
MEDIA_ROOT = BASE_DIR / 'media'

Add in urls.py:

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

---

🔐 Authentication

• Register/Login via accounts/
• CSRF-protected forms
• Custom user model for future scalability

---

🌍 Deployment (Heroku/Render)

Environment Variables Needed:

• DEBUG=False
• ALLOWED_HOSTS=['yourdomain.com']
• SECRET_KEY=your_secret_key
• DATABASE_URL for PostgreSQL

Production Steps:

1. Install gunicorn, whitenoise, and dj-database-url
2. Set DEBUG=False and configure static/media settings
3. Use collectstatic
4. Add Procfile for Heroku

---

📦 requirements.txt

Django>=5.0
psycopg2-binary
Pillow
django-crispy-forms
gunicorn
whitenoise
dj-database-url

Generate with:

pip freeze > requirements.txt

---

👨‍💻 Author

Rahat
Django Developer
📧 Email / LinkedIn / Portfolio (add your links here)

---