Sara Global Store - Django E-commerce Platform

Sara Global Store is a modern e-commerce platform specializing in cosmetics, beauty products, and lifestyle items in Nepal. Built with Django, this full-featured online shopping platform provides a seamless experience for both customers and administrators.

🌟 Features

Customer Features

• Product Browsing: Browse products by categories (Skincare, Beauty, Electronics, Miscellaneous)
• Search & Filter: Advanced search functionality with category filtering
• User Authentication: Secure registration, login, and profile management
• Wishlist: Save favorite products for later
• Shopping Cart: Add, remove, and manage items in cart
• Checkout Process: Streamlined checkout with multiple address support
• Order Tracking: Real-time order status updates (Pending → Received → Packed → On the Way → Delivered)
• Product Reviews: Rate and review purchased products
• Responsive Design: Mobile-friendly interface

Admin Features

• Product Management: Add, edit, and manage products with images
• Order Management: Track and update order status
• Customer Management: View customer details and order history
• Content Management: Manage homepage slides, banners, and promotional content
• Inventory Control: Track product availability and stock levels
• Promo Codes: Create and manage discount codes

Technical Features

• SEO Optimized: Meta tags, sitemaps, and search engine friendly URLs
• Email Integration: Order confirmations and notifications
• Media Management: Image upload and processing with Pillow
• Security: CSRF protection, secure user authentication
• Admin Interface: Django admin panel for easy management

🛠️ Technology Stack

• Backend: Django 3.2.5
• Database: SQLite (development), easily configurable for PostgreSQL/MySQL
• Frontend: HTML5, CSS3, JavaScript, jQuery
• Image Processing: Pillow 10.2.0
• Additional Libraries:
  • django-humanize (for better date/time formatting)
  • django-sitemaps (for SEO)

📁 Project Structure

saraglobalstore/
├── saraglobalstore/           # Main project directory
│   ├── settings.py           # Django settings
│   ├── urls.py              # Main URL configuration
│   ├── wsgi.py              # WSGI configuration
│   └── asgi.py              # ASGI configuration
├── home/                    # Main app for products and orders
│   ├── models.py           # Product, Cart, Order models
│   ├── views.py            # Business logic
│   ├── urls.py             # App URL patterns
│   ├── admin.py            # Admin interface configuration
│   └── migrations/         # Database migrations
├── registration/           # User authentication and profiles
│   ├── models.py          # Customer model
│   ├── views.py           # Authentication views
│   ├── forms.py           # User forms
│   └── urls.py            # Auth URL patterns
├── blog/                  # Blog functionality
├── templates/             # HTML templates
│   ├── base.html         # Base template
│   ├── home/             # Home app templates
│   ├── registration/     # Auth templates
│   └── emails/           # Email templates
├── static/               # Static files
│   ├── css/             # Stylesheets
│   ├── js/              # JavaScript files
│   └── img/             # Static images
├── media/                # User uploaded files
│   ├── slides/          # Homepage slides
│   ├── banners/         # Banner images
│   └── products/        # Product images
├── requirements.txt      # Python dependencies
└── manage.py            # Django management script

🚀 Installation & Setup

Prerequisites

• Python 3.8+
• pip (Python package manager)
• Virtual environment (recommended)

Installation Steps

1. Clone the repository

   git clone <repository-url>
   cd SaraECommerce

2. Create and activate virtual environment

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

3. Install dependencies

   pip install -r requirements.txt

4. Configure settings

   • Update SECRET_KEY in settings.py for production
   • Configure database settings if not using SQLite
   • Set up email backend for order notifications

5. Run migrations

   python manage.py makemigrations
   python manage.py migrate

6. Create superuser

   python manage.py createsuperuser

7. Collect static files (for production)

   python manage.py collectstatic

8. Run the development server

   python manage.py runserver

Visit http://127.0.0.1:8000 to view the application.

📋 Usage

Admin Panel

Access the admin panel at http://127.0.0.1:8000/admin/ to:

• Add products and categories
• Manage orders and customers
• Upload homepage content (slides, banners)
• Create promo codes

Customer Flow

1. Browse Products: Visit the homepage or product categories
2. Add to Cart: Select products and add them to cart
3. Checkout: Provide shipping address and place order
4. Track Order: Monitor order status in the orders section
5. Review Products: Rate and review delivered products

🔧 Configuration

Email Settings

Configure email settings in settings.py for order notifications:

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'your-smtp-host'
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = 'your-email@domain.com'
EMAIL_HOST_PASSWORD = 'your-password'

Media Files

Ensure proper media file handling for product images:

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

🌐 Production Deployment

Environment Variables

Set the following environment variables for production:

• SECRET_KEY: Django secret key
• DEBUG: Set to False
• ALLOWED_HOSTS: Your domain names
• Database credentials
• Email configuration

Security Considerations

• Use HTTPS in production
• Configure proper ALLOWED_HOSTS
• Set up database backups
• Enable Django security middleware
• Use environment variables for sensitive data

📱 API Endpoints

The application uses AJAX endpoints for dynamic functionality:

• /add-to-cart/: Add products to cart
• /remove-from-cart/: Remove items from cart
• /add-to-wishlist/: Manage wishlist
• /place-order/: Process orders
• /add-review/: Submit product reviews

🎨 Customization

Styling

• Modify CSS files in static/css/
• Update templates in templates/
• Customize admin interface through admin.py

Adding Features

• Extend models in models.py
• Add views in views.py
• Create URL patterns in urls.py
• Update templates as needed

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-feature)
3. Commit your changes (git commit -am 'Add new feature')
4. Push to the branch (git push origin feature/new-feature)
5. Create a Pull Request

📄 License

This project is proprietary software for Sara Global Store. All rights reserved.

🔄 Version History

• v1.0: Initial release with core e-commerce functionality
• Current version includes full product management, order processing, and customer features

---

Note: This is a production e-commerce platform. Ensure proper testing and security measures before deploying to a live environment.