🛍️ ShopSphere – Full Stack Django E-Commerce Web Application

ShopSphere is a fully functional e-commerce web application built using Django.
It allows users to browse products, filter by categories, manage shopping carts, and place orders through a dynamic and responsive interface.

This project demonstrates strong understanding of Django backend development, database management, authentication systems, and frontend integration.

---

🚀 Live Features

• 🔐 User Registration & Login Authentication
• 🛍️ Dynamic Product Listing from Database
• 🗂️ Category-Based Product Filtering (?cat=category_name)
• 🔎 Product Search Functionality
• 🛒 Add to Cart / Remove from Cart
• 📦 Product Image Upload & Media Handling
• 🧑‍💼 Django Admin Panel for Product Management
• 📱 Responsive UI using HTML & CSS
• 🧠 Clean URL Routing & Template Rendering

---

🧠 Tech Stack

Layer	Technology Used
Backend	Django (Python)
Frontend	HTML, CSS
Database	SQLite (Django Default DB)
Authentication	Django Built-in Auth
Media Handling	Pillow
Deployment Ready	Yes (with production settings changes)

---

📂 Project Structure

ShopSphere/
│
├── manage.py
├── db.sqlite3
│
├── ShopSphere/          # Main project configuration
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
│
├── store/               # Core application
│   ├── models.py
│   ├── views.py
│   ├── urls.py
│   ├── templates/
│   └── static/
│
├── static/              # CSS & static assets
└── media/               # Uploaded product images

---

⚙️ Installation & Setup

1️⃣ Clone Repository

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

2️⃣ Create Virtual Environment (Recommended)

python -m venv venv
venv\Scripts\activate   # Windows

3️⃣ Install Dependencies

pip install -r requirements.txt

If requirements.txt is not available:

pip install django pillow

---

🛠️ Run the Project

Apply Migrations

python manage.py makemigrations
python manage.py migrate

Create Admin User

python manage.py createsuperuser

Start Development Server

python manage.py runserver

Open in browser:

http://127.0.0.1:8000/

Admin Panel:

http://127.0.0.1:8000/admin/

---

🧪 Example Functionalities

URL Example	Purpose
/	Homepage
/base/?cat=car	Category filtering
/admin/	Admin product management
/cart/	Shopping cart view

---

🔧 Key Django Concepts Implemented

• Django ORM & Model Relationships
• Migrations & Database Schema Management
• Authentication System
• Static & Media File Handling
• URL Routing & Dynamic Templates
• Query Parameter Filtering
• CRUD Operations
• Admin Panel Customization

---

🔐 Settings Configuration

Ensure the following is added in settings.py:

STATIC_URL = 'static/'

STATICFILES_DIRS = [
    BASE_DIR / "static"
]

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

---

📦 Dependencies

• Django
• Pillow

---

🚀 Future Enhancements

• 💳 Payment Gateway Integration (Razorpay / Stripe)
• ⭐ Product Reviews & Ratings
• ❤️ Wishlist System
• 📦 Order Tracking Dashboard
• 🔔 Email Notifications
• 🔐 JWT Authentication
• 🌍 Deployment on AWS / Render / Railway
• 🔄 REST API using Django REST Framework

---

🎯 Why This Project Matters

This project demonstrates:

• Strong backend development using Django
• Real-world e-commerce logic implementation
• Clean project structure
• Understanding of database design
• Authentication & session management
• Practical full-stack development capability

---

👨‍💻 Author

Saswata Pradhan
B.Tech – Computer Science & Engineering
Interested in Full Stack Development & Data Analytics

---

📜 License

This project is licensed under the MIT License.

---

📌 Project Description (Short Version for GitHub About Section)

A Django-based full stack e-commerce web application implementing authentication, product management, category filtering, cart system, and admin control panel.