🛒 Trader - E-commerce Platform

Trader is a full-featured modern e-commerce platform built with Django and PostgreSQL.
Inspired by Noon, it provides product and order management, integrated payment systems (e.g. Vodafone Cash), advanced filtering, CSV tools, and a responsive UI using Bootstrap.

---

🚀 Features

• 🧾 Product & Category Management with inventory control
• 💳 Secure Payments, including Vodafone Cash integration
• 🛍️ Shopping Cart & Order Management
• 📊 CSV Import/Export for product data
• ⏱️ Background Tasks using Redis (e.g., order notifications)
• 🎨 Responsive Frontend (Bootstrap + HTML5 + CSS3)
• 🧪 Pytest-based Test Coverage
• 💌 Email Notifications (orders, password resets, promotions)
• 📄 PDF Invoice Generation
• 💬 Product Reviews & Ratings
• 💚 Wishlist System
• 👤 User Profiles with multi-address support
• 🔍 Advanced Filtering (price, rating, brand...)
• 📦 Order Tracking (Processing → Shipped → Delivered)
• 🛒 Related Products & "Bought Together" Suggestions
• 📃 Static Pages (About, Terms, Privacy...)
• 🚚 Region-Based Shipping Calculations
• ⚡ Redis Caching for Products/Categories
• 🔐 Admin Activity Logging

---

🧪 Upcoming Features

• 📢 Advertisements System for Products
• 🧵 Product Variants (Size, Color, etc.)
• ⚖️ Shipping Weight Calculations
• 📊 Admin Tools (Sales Dashboard, Bulk Edits, Discount Codes)
• 🌐 Multi-Language & Multi-Currency Support
• 🔐 JWT / OAuth2 Authentication, Rate Limiting, API Security

---

🛠️ Tech Stack

Layer	Tech
Backend	Django (Python)
Database	PostgreSQL
Frontend	HTML, CSS, JS, Bootstrap
Async Tasks	Celery + Redis
Testing	Pytest

---

⚙️ Getting Started

🔹 1. Install Python

Linux:

sudo apt update
sudo apt install python3 python3-pip python3-venv

Windows: Download from python.org

---

🔹 2. Install PostgreSQL

Linux:

sudo apt install postgresql postgresql-contrib
sudo service postgresql start

Windows: Install PostgreSQL

Create database and user:

CREATE DATABASE trader_db;
CREATE USER trader_user WITH PASSWORD 'yourpassword';
GRANT ALL PRIVILEGES ON DATABASE trader_db TO trader_user;

---

🔹 3. Clone & Setup Project

git clone https://github.com/AhmedHashim04/Trader-Fullstack-Project.git
cd Trader-Fullstack-Project
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

---

🔹 4. Apply Migrations

python manage.py migrate
python manage.py runserver

---

🔹 5. Redis & Celery (Linux)

sudo apt install redis
sudo service redis start
celery -A trader worker -l info

---

🧪 Run Tests

pytest

---

📁 Project Structure

<<<<<<< HEAD

Click to view simplified structure

======= > _UI screenshots and GIFs below to showcase the frontend._ 

• 
• 
• 
• 
• 

---

📁 Project Structure (simplified)

a4a338fc396ea5dab7f786828a5492b82e42ef94

├── account/
├── cart/
├── contact/
├── coupon/
├── features/
├── home/
├── logs/
├── manage.py
├── media/
├── order/
├── payment/
├── product/
├── project/     # settings & URLs
├── static/
├── templates/
├── README.md
└── requirements.txt

---

🖼️ Screenshots

👤 Author

Ahmed Hashim
GitHub Profile

---

📄 License

This project is licensed under the MIT License.

---

⭐ Support & Contribution

If you like this project, please ⭐ the repo and feel free to fork or contribute via PR.
Suggestions, bug reports, and feature requests are always welcome!