Back to Projects
Live Link Github
Project Screenshot 1

MossX: High-Performance Modular Monolith

A lightning-fast E-Commerce platform that guarantees zero duplicate charges and sub-50ms catalog load times.

The Problem

Modern retail platforms either bloat your codebase or crash during high-traffic checkout events, leading to duplicate charges, lost carts, and furious customers.

The Outcome

A seamless, production-ready monolithic platform handling guest cart merging, secure multi-gateway payments, and real-time analytics. Shoppers get a frictionless experience, and administrators get full control.

How It Works (The Mechanism)

  1. Zero Duplicate Charges: Integrated Razorpay and Stripe with custom idempotency logic to guarantee that users are never charged twice, even if their network drops mid-request.
  2. Instant Product Loading: Intelligent Redis caching for the product catalog and user sessions drastically reduces read pressure on MongoDB.
  3. Frictionless Shopping: Intelligent cart merging allows users to build a cart anonymously and seamlessly sync it upon login.
  4. Bulletproof Security: Dual-Token Authentication (JWT + HttpOnly refresh tokens) mitigates CSRF and XSS risks.

System Design Decisions

  • MongoDB as the Primary Data Store: E-commerce catalogs often require flexible schemas for diverse product attributes (e.g., bundles vs. standalone products). MongoDB's document model handles this polymorphism natively without complex SQL joins.
  • Redis Caching Layer: To handle traffic spikes during sales events, Redis is employed to cache heavily requested endpoints (like featured products and category lists). This dramatically reduces MongoDB read pressure and latency.
  • Dual-Token Authentication: Instead of relying purely on session cookies, we use a short-lived JWT Access Token paired with a long-lived, HttpOnly Refresh Token. This mitigates CSRF and XSS risks while providing a smooth UX.
  • Guest Cart Merging Strategy: To lower the friction of shopping, users can build their cart anonymously. The state is temporarily held, and upon authentication, the system intelligently merges the guest cart with their persistent cloud cart.
  • Multi-Gateway Payment Architecture: Relying on a single payment provider can be a single point of failure. MossX abstracts payment logic to seamlessly toggle or support both Stripe and Razorpay based on regional requirements.

Architecture

Database Design

MossX revolves around a highly relational NoSQL design utilizing Mongoose references.

The Value Stack

  • Frontend: React 18, Vite, Zustand, TailwindCSS, Framer Motion
  • Backend: Node.js, Express
  • Database & Caching: MongoDB, Upstash Redis
  • Payments & Storage: Stripe, Razorpay, Cloudinary
  • Deployment: Docker

Detailed Features

User Features

  • Seamless Shopping Flow: Browse products by category, search with price ranges, and view tailored recommendations.
  • Advanced Cart System: Fully featured cart supporting both authenticated users and anonymous guest sessions with intelligent cart merging upon login.
  • Secure Authentication: Robust JWT-based authentication with seamless token refreshing.
  • Profile & Order Management: Track past orders, apply promotional coupons, and manage account details.

Admin Features

  • Comprehensive Dashboard: Real-time sales analytics and key performance indicators.
  • Inventory Management: Create, update, and manage products, bundles, and custom collections.
  • Promotions Engine: Issue and manage discount coupons and featured products.

E-commerce Features

  • Dynamic Bundles & Collections: Curate customized product offerings for specific campaigns.
  • Flexible Checkout: Multi-gateway payment integration featuring Stripe and Razorpay.
  • Coupons & Discounts: Validation engine for promotional codes.

Security Features

  • Stateless JWT Auth: Utilizing short-lived access tokens and secure, HttpOnly refresh tokens.
  • Robust Validation: Input sanitization and error handling.
  • Payment Security: Cryptographic webhook signature verification for all payment gateways.

Performance Features

  • Redis Caching: Ultra-fast data retrieval for product catalogs and high-traffic queries using Upstash Redis.
  • Asset Optimization: Cloudinary integration for scalable, optimized image delivery.
  • Efficient Bundling: Vite-powered lazy loading and code splitting for lightning-fast frontend load times.

The Proof

  • Reduced homepage and product catalog latency to under 50ms.
  • Achieved 100% reliable checkouts with zero duplicate charges reported.
  • Scaled effortlessly during peak traffic events without the overhead of microservices.