Fruitkha – Full-Stack E-Commerce Platform

🚀 Architecture & Technical Achievements

Secure & Scalable Infrastructure

The platform is built on a resilient, multi-container architecture. Services including the Django Web app, PostgreSQL database, and Nginx server are orchestrated via Docker Compose. It utilizes Cloudflare Tunnels to expose the application to the internet securely, establishing a Zero-Trust environment that prevents direct external network attacks.

Modern Media Handling & Processing

To ensure lightning-fast page loads and reduce server bandwidth, the backend utilizes Pillow (PIL) to automatically resize and optimize product images on-the-fly during upload. This ensures the frontend UI remains snappy even over slower connections.

Passwordless Authentication System

Eliminated the friction and security risks of traditional passwords by implementing a custom dynamic Email OTP (One-Time Password) flow. This approach significantly reduces the risk of credential stuffing and brute-force attacks, offering users a secure and seamless login experience with auto-expiring tokens.

---

🌟 Comprehensive Page-by-Page Walkthrough

🏠 Public Storefront Experience

1. Homepage & Discovery

• Dynamic Hero Section: A highly visual, conversion-optimized landing area featuring the latest seasonal offers and clear call-to-actions.
• Featured Collections: Algorithmic display of trending products, new arrivals, and top-selling categories.
• Promotional Banners: Data-driven banner placement for active site-wide sales and coupon codes.

2. Shop & Product Listing

• Category Navigation: Intuitive browsing by departments and categories.
• Advanced Filtering & Sorting: Users can seamlessly filter products by price range, attributes, and sort by relevance, price, or newest arrivals.
• Responsive Grid: A fluid, mobile-first grid system ensuring products look stunning on any device size.

3. Single Product Experience

• Media Showcase: High-resolution product image gallery (optimized via Pillow) with zoom capabilities.
• Dynamic Pricing: Automatically reflects discounted prices if the product is tied to an active promotional offer.
• Inventory Awareness: Real-time stock status preventing users from adding out-of-stock items to their cart.
• Related Products: Suggestive cross-selling algorithms displaying similar items to increase Average Order Value (AOV).

🔐 Authentication & Checkout Flow

4. Passwordless Login & Registration

• OTP Verification Entry: Clean interface requesting the user's email.
• Secure Token Flow: The system generates a time-sensitive, one-time passcode sent directly to the user's email, eliminating the need to remember passwords or worry about data breaches.

5. Shopping Cart

• Smart Cart Calculations: Real-time subtotal, tax, and shipping calculations.
• Coupon Validation Engine: Users can apply promo codes, with the system dynamically validating expiry dates, minimum spend requirements, and usage limits before applying the discount.

6. Multi-Gateway Checkout

• Address Management: Select, edit, or add new shipping addresses with validation.
• Flexible Payments: Integration with Razorpay for secure Credit/Debit card and UPI payments, a Digital Wallet option for instant one-click checkout using stored funds, and a traditional Cash on Delivery option.

👤 Customer Dashboard

7. Integrated Digital Wallet

• Wallet Overview: A dedicated dashboard displaying the current available balance.
• Transaction History: A granular, ledger-style view of all wallet activities, distinguishing between credits (refunds, deposits) and debits (purchases).

8. Order Management

• Order Tracking: Detailed timelines for active orders (Processing, Shipped, Delivered).
• Invoice Generation: One-click automated PDF invoice downloads for past orders.
• Cancellation Workflow: Users can submit formal cancellation requests for unfulfilled orders, triggering automated refund flows directly to their Digital Wallet.

⚙️ Administrator & Store Management Experience

9. Custom Analytics Dashboard

• Visual Sales KPIs: Overhauled the standard Django admin panel to include interactive graphical charts mapping daily/weekly sales trends.
• Fulfillment Overview: Real-time metrics on pending orders, processed shipments, and revenue totals.

10. Advanced Sales Reporting & Exports

• Data Querying: Powerful administrative tools to filter sales data by specific date ranges, categories, or payment methods.
• Business Intelligence Export: One-click export functionality to generate comprehensive Excel/CSV reports for accounting and stakeholder meetings.

11. Marketing & Promotions Engine

• Dynamic Offers System: Admins can attach percentage or flat discounts to specific products or categories with strict start/end timestamps. The platform automatically activates and deactivates these prices in real-time.
• Coupon Management: Create complex discount codes with specific constraints (e.g., "First-time buyers only," "Minimum cart value $50").

---

✨ Key Features Summary

• Integrated Digital Wallet: Easily store funds, instantly receive order refunds, and pay for new purchases with zero friction.
• Multi-Method Checkout: Razorpay for secure card/UPI, Wallet Balance, and Cash on Delivery.
• Comprehensive Order Management: Track active orders, download PDF invoices, and submit Cancellation Requests.
• Advanced Admin Analytics: Interactive sales charts, graphical trends, and one-click data exports.
• Marketing & Promotions: Flexible coupon engine and automated time-based product offers.

🛠️ Tech Stack Matrix