Skip to content

Nino1508/blitzshop

Repository files navigation

BlitzShop - Full-Stack E-Commerce Platform

React Python Flask PostgreSQL

Production e-commerce platform with admin dashboard, invoice system, and real-time analytics

🌐 Live Demo: https://blitzshop.netlify.app
💻 Source Code: https://github.com/Nino1508/blitzshop
📊 Admin Dashboard: Full access available for recruiters (see below)


🎯 Quick Demo Access

Customer Experience

Visit https://blitzshop.netlify.app to explore the shopping experience

  • Test card for checkout: 4242 4242 4242 4242 (any future date, any CVC)

Admin Dashboard (Full Access)

URL: https://blitzshop.netlify.app/login
Email: demo@blitzshop.com
Password: admin123

For Recruiters: This demo account provides read-only access to explore all admin features including analytics, product management, and order processing. Delete operations are restricted for security.


✨ Key Features

Business Features

  • 📊 Real-time Analytics Dashboard - Sales metrics, revenue tracking, top products
  • 🧾 Invoice Generation System - Automatic PDF invoices with fiscal numbering
  • 🎟️ Coupon Management - Percentage/fixed discounts with validation rules
  • 📦 Inventory Management - Stock tracking with low-stock alerts
  • 👥 Customer Management - B2B/B2C profiles with company data
  • 📈 Order Processing - 6 order states with status tracking

Technical Features

  • 🔐 JWT Authentication - Secure auth with refresh tokens
  • 💳 Payment Processing - Stripe integration in test mode (use card: 4242 4242 4242 4242)
  • 🛒 Persistent Shopping Cart - Survives login/logout cycles
  • 📱 Fully Responsive - Mobile-first design with Shopify Polaris
  • 🚀 CI/CD Pipeline - Automated deployments via GitHub
  • 🌍 Production Ready - 99% uptime, <200ms response time
  • 🔄 65+ API Endpoints - Complete RESTful API with room for growth

🛠️ Tech Stack

Layer Technologies
Frontend React 18.3.1, Redux, Shopify Polaris, Axios
Backend Python 3.13, Flask 3.0, JWT, SQLAlchemy
Database PostgreSQL 16, Flask-Migrate, Supabase
Payments Stripe API (test mode)
Deployment Netlify (Frontend), Render (Backend), GitHub Actions

📸 Screenshots

Admin Dashboard

  • Complete analytics with revenue charts
  • Product management interface
  • Order processing system
  • Customer database

Customer Interface

  • Product catalog with categories
  • Shopping cart with real-time updates
  • Checkout process with Stripe integration
  • Responsive mobile experience

🚀 Quick Start

Prerequisites

  • Python 3.11+
  • Node.js 18+
  • PostgreSQL

Installation

  1. Clone the repository
git clone https://github.com/Nino1508/blitzshop.git
cd blitzshop
  1. Backend Setup
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
python run.py
  1. Frontend Setup
cd ../frontend
npm install
npm start
  1. Access

📊 Project Statistics

  • Development Time: 400+ hours over 6 weeks
  • Lines of Code: ~20,000
  • API Endpoints: 65+
  • React Components: 45+
  • Database Tables: 9 with complex relationships
  • Test Coverage: In progress
  • Lighthouse Score: 85+

🏗️ Architecture Highlights

  • Modular Backend: Blueprint-based Flask architecture for scalability
  • State Management: Redux for complex state, Context API for auth
  • Database Design: Normalized schema with proper indexes
  • Security: Password hashing (bcrypt), parameterized queries, CORS configuration
  • Error Handling: Comprehensive error handling with proper HTTP status codes
  • Code Quality: Clean, documented, production-ready code

🎓 What This Project Demonstrates

This isn't a tutorial project. Every feature was built to solve real e-commerce challenges:

  • Complex State Management: Cart persistence across sessions
  • Business Logic: Invoice generation with fiscal compliance
  • Payment Integration: Stripe implementation in test mode
  • Data Relationships: Orders, items, users, products interconnected
  • Security Implementation: JWT refresh tokens, secure password storage
  • Production Deployment: CI/CD pipeline with monitoring
  • Performance Optimization: Indexed queries, optimized renders

🔮 Planned Enhancements

Features Roadmap

  • Product reviews and ratings system
  • Wishlist/favorites functionality
  • User management in admin dashboard
  • Email notifications (order confirmation, shipping updates)
  • Advanced search with filters and sorting
  • Multi-language support (i18n)

Technical Improvements

  • Automated Testing - Jest for React components, Pytest for API endpoints (target: 80% coverage)
  • API Documentation - OpenAPI/Swagger specification for all endpoints
  • Performance Optimization
    • Database query optimization (eliminate N+1 queries)
    • Redis caching implementation
    • Image optimization and lazy loading
    • Code splitting for faster initial load
  • Error Handling & Monitoring
    • React Error Boundaries
    • Sentry integration for error tracking
    • Structured logging with Winston/Python logging
  • Security Enhancements
    • Rate limiting on API endpoints
    • OWASP security best practices audit
    • Input sanitization improvements
  • DevOps & Infrastructure
    • Docker containerization
    • GitHub Actions for automated testing
    • Database backup automation

👨‍💻 About the Developer

Full-Stack Developer with a passion for building production-ready applications. This project represents 400+ hours of dedicated development, focusing on clean code, scalability, and real-world functionality.

Available for: Remote opportunities worldwide or relocation within Europe. Immediate availability.


📬 Contact


💼 Note for Technical Recruiters

This project is currently running in production with real users. The code follows industry best practices and is ready for team collaboration. Feel free to explore the admin dashboard to see the full functionality. Delete operations are restricted for the demo account to maintain system integrity.

About

Lightning-speed commerce platform

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors