A full-stack, enterprise-grade e-commerce platform with AI-powered recommendations, chatbot support, fraud detection, sentiment analysis, price prediction, and more.

Built with Django + Oracle SQL + Redis + Groq AI + HTML/CSS/JavaScript

• Features
• Tech Stack
• Screenshots
• Prerequisites — What You Need Before Starting
• Step-by-Step Installation Guide
• Running the Application
• Login Credentials
• All Pages & URLs
• Project Structure
• AI Features Explained
• API Endpoints
• Oracle SQL Setup (Optional)
• Redis Setup (Optional)
• Troubleshooting
• Contributing
• License

After running the app, visit http://127.0.0.1:8000/ to see:

• Home Page — Hero section, featured products, categories, deals
• Product Listing — Grid layout with filters and sorting
• Product Detail — Reviews, AI price prediction, related products
• Shopping Cart — Item management with order summary
• Checkout — Shipping address form with saved addresses
• Payment — Card/UPI/COD payment options
• Admin Analytics — Revenue charts, fraud alerts, AI insights
• Warehouse — Inventory levels, stock alerts, shipments

⚠️ IMPORTANT: Read this section carefully if you have never used Python or Django before.

Python is the programming language this project is built with. You need version 3.10 or higher.

1. Go to the official Python website: https://www.python.org/downloads/
2. Click the big yellow "Download Python 3.x.x" button
3. Run the downloaded installer (.exe file)
4. ⚠️ VERY IMPORTANT: On the first screen of the installer, check the box that says:

   ☑ Add Python to PATH
   

   This is at the bottom of the installer window. If you miss this, nothing will work!
5. Click "Install Now"
6. Wait for installation to complete, then click "Close"

Open Command Prompt (press Win + R, type cmd, press Enter) and type:

python --version

You should see something like:

Python 3.10.x

If you see Python was not found or an error, Python was not added to PATH. Reinstall and make sure to check "Add Python to PATH".

# Install Homebrew first (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python
brew install python@3.10

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

Git is needed to download (clone) this project.

1. Go to: https://git-scm.com/download/win
2. Download and run the installer
3. Click "Next" through all options (defaults are fine)
4. Click "Install"

git --version

You should see: git version 2.x.x

brew install git

sudo apt install git

To view or edit the code, install one of these:

• VS Code (Recommended): https://code.visualstudio.com/
• Notepad++: https://notepad-plus-plus.org/

Any modern browser works: Chrome, Firefox, Edge, or Safari.

Follow these steps exactly in order. Copy-paste each command.

• Windows: Press Win + R, type cmd, press Enter
• macOS: Press Cmd + Space, type Terminal, press Enter
• Linux: Press Ctrl + Alt + T

Navigate to where you want the project. For example, your Desktop:

# Windows
cd %USERPROFILE%\Desktop

# macOS / Linux
cd ~/Desktop

git clone https://github.com/vasistacv/Ecommerce.git

This creates a folder called Ecommerce with all the project files.

cd Ecommerce

A virtual environment keeps this project's packages separate from your system Python.

# Windows
python -m venv .venv

# macOS / Linux
python3 -m venv .venv

# Windows (Command Prompt)
.venv\Scripts\activate

# Windows (PowerShell)
.venv\Scripts\Activate.ps1

# macOS / Linux
source .venv/bin/activate

After activation, you should see (.venv) at the beginning of your command line:

(.venv) C:\Users\YourName\Desktop\Ecommerce>

⚠️ You must activate the virtual environment every time you open a new terminal window to run the project.

pip install -r requirements.txt

This will download and install Django, Groq AI, and all other dependencies. Wait for it to finish (may take 1-2 minutes).

You should see Successfully installed ... at the end.

⚠️ Note: The .env file in the repository is committed with a placeholder key. Anyone cloning the repo needs to add their own Groq API key. Your real key is safe locally and .env is in .gitignore for future commits.

To use the AI features (Chatbot, Recommendations, Fraud Detection, etc.), you need a free Groq API key:

1. Go to the Groq Console
2. Create a free account or log in
3. Click on "Create API Key" and copy the generated key
4. Open the .env file in the project folder
5. Replace the placeholder value with your actual key:

   GROQ_API_KEY=gsk_your_actual_api_key_here

# Create database tables
python manage.py makemigrations accounts products cart orders payments ai_engine warehouse

python manage.py migrate

python manage.py seed_data

You should see:

Seeding database...
  [OK] Superuser created (admin/admin123)
  [OK] Test users created
  [OK] Categories created
  [OK] 16 products created
  [OK] Reviews created
  [OK] Price history created
  [OK] Warehouses & inventory created
  [OK] Addresses created

Database seeded successfully!
   Admin Login: admin / admin123
   Test User:   user1 / password123

python manage.py runserver

You should see:

Starting development server at http://127.0.0.1:8000/

Open your web browser and go to:

👉 http://127.0.0.1:8000/

🎉 The SmartShop e-commerce platform is now running on your computer!

Every time you want to run the application after the first setup:

# 1. Open Command Prompt / Terminal

# 2. Go to the project folder
cd path\to\Ecommerce

# 3. Activate the virtual environment
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate

# 4. Start the server
python manage.py runserver

# 5. Open http://127.0.0.1:8000/ in your browser

To stop the server, press Ctrl + C in the terminal.

You can also create your own account via the Sign Up page!

Ecommerce/
│
├── manage.py                  # Django management script
├── requirements.txt           # Python package dependencies
├── setup.bat                  # Windows auto-setup script
├── .env                       # Environment variables (API keys, DB config)
├── db.sqlite3                 # SQLite database (auto-generated)
│
├── config/                    # Django project configuration
│   ├── settings.py            #   Main settings (DB, cache, apps, AI config)
│   ├── urls.py                #   Root URL routing
│   ├── wsgi.py                #   WSGI entry point
│   └── asgi.py                #   ASGI entry point
│
├── accounts/                  # User authentication & profiles
│   ├── models.py              #   UserProfile, Address, UserActivity models
│   ├── views.py               #   Login, Register, Profile, Address views
│   ├── forms.py               #   Registration, Login, Profile forms
│   ├── urls.py                #   URL routing
│   └── admin.py               #   Admin panel registration
│
├── products/                  # Product catalog
│   ├── models.py              #   Product, Category, Review, PriceHistory
│   ├── views.py               #   Product list, detail, search, review
│   ├── urls.py                #   URL routing
│   ├── admin.py               #   Admin panel registration
│   └── management/commands/   #   seed_data command
│
├── cart/                      # Shopping cart
│   ├── models.py              #   Cart, CartItem models
│   ├── views.py               #   Add, update, remove, clear cart
│   ├── urls.py                #   URL routing
│   └── context_processors.py  #   Cart count in navbar
│
├── orders/                    # Order management
│   ├── models.py              #   Order, OrderItem, OrderTracking
│   ├── views.py               #   Checkout, order list, detail, tracking
│   ├── urls.py                #   URL routing
│   └── admin.py               #   Admin with inline items & tracking
│
├── payments/                  # Payment processing
│   ├── models.py              #   Payment model (Card, UPI, COD, etc.)
│   ├── views.py               #   Payment processing & success page
│   ├── urls.py                #   URL routing
│   └── admin.py               #   Admin panel registration
│
├── ai_engine/                 # 🤖 AI/ML features (Groq API)
│   ├── groq_client.py         #   Groq API client wrapper
│   ├── recommender.py         #   AI product recommendation engine
│   ├── chatbot.py             #   AI customer support chatbot
│   ├── fraud_detection.py     #   AI fraud risk scoring
│   ├── sentiment.py           #   AI review sentiment analysis
│   ├── price_prediction.py    #   AI price trend prediction
│   ├── fake_review.py         #   AI fake review detection
│   ├── views.py               #   API endpoints for all AI features
│   └── urls.py                #   URL routing
│
├── analytics/                 # Admin analytics dashboard
│   ├── views.py               #   Dashboard with metrics & charts
│   └── urls.py                #   URL routing
│
├── warehouse/                 # Warehouse management
│   ├── models.py              #   Warehouse, Inventory, Shipment
│   ├── views.py               #   Warehouse dashboard
│   ├── urls.py                #   URL routing
│   └── admin.py               #   Admin panel registration
│
├── templates/                 # HTML templates
│   ├── base.html              #   Master template (navbar, footer, chatbot)
│   ├── home.html              #   Homepage
│   ├── accounts/              #   Login, register, profile, address forms
│   ├── products/              #   Product list & detail pages
│   ├── cart/                  #   Shopping cart page
│   ├── orders/                #   Checkout, order list, detail, tracking
│   ├── payments/              #   Payment form & success page
│   ├── analytics/             #   Admin analytics dashboard
│   └── warehouse/             #   Warehouse management dashboard
│
├── static/                    # Static assets
│   ├── css/style.css          #   Main stylesheet (glassmorphism theme)
│   └── js/
│       ├── main.js            #   Core JavaScript (cart AJAX, search)
│       ├── chatbot.js         #   AI chatbot widget
│       └── analytics.js       #   Dashboard charts (Chart.js)
│
└── sql/                       # Database scripts
    └── schema.sql             #   Oracle SQL schema (all tables)

All AI features are powered by the Groq API using the LLaMA 3.3 70B model.

• Analyzes user browsing history, purchases, and cart activity
• Recommends products based on preferences, categories, and price range
• Provides personalized reasons for each recommendation

• Available on every page via the 💬 floating button
• Knows about orders, shipping policies, returns, and products
• Context-aware: sees user's recent orders and loyalty points
• Maintains conversation history for natural dialog

• Analyzes orders for suspicious patterns
• Considers: order value vs history, new accounts, unusual quantities
• Returns risk score (0-1) with approve/review/reject recommendation
• Flags high-risk orders in admin dashboard

• Automatically analyzes review text for sentiment
• Scores from -1 (negative) to +1 (positive)
• Labels: positive / negative / neutral
• Extracts key points from each review

• Analyzes 30-day price history and market factors
• Predicts price trend: up / down / stable
• Provides buy now / wait / neutral recommendation
• Available on each product detail page

• Checks reviews for signs of inauthenticity
• Analyzes: vague language, mismatched rating/content, generic text
• Flags suspicious reviews with confidence score
• Visible in admin dashboard

curl -X POST http://127.0.0.1:8000/api/ai/chat/ \
  -H "Content-Type: application/json" \
  -d '{"message": "What are your shipping policies?"}'

Note: The project runs on SQLite by default — no Oracle needed for development. Oracle is for production deployment.

If you want to use Oracle SQL:

Download from: https://www.oracle.com/database/technologies/xe-downloads.html

-- Connect as SYSDBA
sqlplus sys/password@localhost:1521/XEPDB1 as sysdba

-- Create user
CREATE USER ecommerce_user IDENTIFIED BY ecommerce_pass;
GRANT CONNECT, RESOURCE, DBA TO ecommerce_user;
ALTER USER ecommerce_user QUOTA UNLIMITED ON USERS;

@sql/schema.sql

In config/settings.py, uncomment the Oracle database config and comment out SQLite:

# Oracle SQL (uncomment this)
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.oracle',
        'NAME': 'XEPDB1',
        'USER': 'ecommerce_user',
        'PASSWORD': 'ecommerce_pass',
        'HOST': 'localhost',
        'PORT': '1521',
    }
}

pip install oracledb

Redis provides faster caching and session management.

1. Download Redis for Windows: https://github.com/microsoftarchive/redis/releases
2. Install and start Redis service
3. Install Python Redis packages:

   pip install redis django-redis

brew install redis
brew services start redis

sudo apt install redis-server
sudo systemctl start redis

Redis is automatically detected — if running, the app uses it; if not, it falls back to in-memory cache.

• Python is not in your PATH
• Reinstall Python and check "Add Python to PATH"
• Or use the full path: C:\Users\YourName\AppData\Local\Programs\Python\Python310\python.exe

• Virtual environment is not activated
• Run: .venv\Scripts\activate (Windows) or source .venv/bin/activate (Mac/Linux)
• Then: pip install -r requirements.txt

• Database tables not created
• Run: python manage.py migrate

• Make sure you're in the project root directory (where manage.py is)
• Check that the templates/ folder exists

• Another process is using port 8000
• Use a different port: python manage.py runserver 8080
• Then visit: http://127.0.0.1:8080/

• Check your Groq API key in .env file
• Ensure you have internet connection
• The chatbot will show a fallback message if the API is unreachable

• Run: python manage.py collectstatic
• Or ensure DEBUG = True in config/settings.py

• This is a Windows console encoding issue
• The application itself works fine in the browser
• Emojis display correctly in web pages

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

This project is open source and available under the MIT License.

Vasista CV

• GitHub: @vasistacv

Built with ❤️ using Django + Groq AI
SmartShop — Where AI Meets Shopping