FinGo Marketplace
Multi-tenant commerce architecture for regional enterprise.
Verified merchants directory with city and category routing
System Overview & Engineering Longevity
A scalable multi-tenant commerce platform built on the MERN stack (MongoDB, Express, React, Node.js) serving enterprise merchants and consumers across Lahore, Karachi, and Islamabad. Engineered with a 3-tier Role-Based Access Control (RBAC) architecture separating Customer, Seller, and Super Admin portals. Features JWT authentication with silent refresh token rotation, dynamic multi-store directories, multi-vendor cart splitting, and a full lifecycle order state machine.
Key Engineering Highlights
Architected with clean domain separation, strict TypeScript contracts, and automated telemetry logging.
Catalog Query Latency
Compound MongoDB indexing
Regional Coverage
Lahore, Karachi, Islamabad
Scoped RBAC Tiers
Customer, Seller & Admin
Atomic Cart Splitting
ACID transactional order dispatch
End-to-End System Data Flow
How user inputs, computer vision pipelines, and transaction protocols flow across the stack.
Regional Geo-Routing
Shopper selects city (Lahore/Karachi/Islamabad); marketplace filters verified regional stores and delivery zones.
Multi-Store Cart Splitting
Cart partitions items into separate vendor fulfillment streams with independent sub-totals.
Atomic Order Creation
MongoDB transactional session commits customer order and generates individual merchant fulfillment tickets.
Vendor Dispatch State Machine
Merchants receive incoming orders and advance states: Confirmed → Packing → Dispatched → Delivered.
Admin Verification & Oversight
Admins audit store performance, resolve customer complaints, and ensure merchant compliance.
System Capabilities & 6+ Functional Modules
3-Tier RBAC Portal Architecture
Granular permission separation providing customized UI and API scopes for Customers, Merchant Sellers, and Platform Administrators.
Atomic Order Splitting & State Machine
When a customer purchases items from multiple distinct merchants in a single checkout, the backend atomically partitions the transaction into independent merchant orders with individualized status tracking.
Geo-Spatial City Filtering Directory
Optimized regional filtering enabling shoppers to filter superstores, grocers, and specialty merchants based on city location (Lahore, Karachi, Islamabad).
JWT Authentication & Silent Refresh Rotation
Security architecture utilizing short-lived access tokens paired with secure HTTP-only refresh tokens rotated silently in the background, preventing session hijacking.
Merchant Catalog & Inventory Management
Full-featured vendor management suite enabling merchants to create product listings, upload imagery, configure variants, manage inventory counts, and toggle promotional deals.
Admin Compliance & Merchant Verification
Administrative governance suite providing document review workflows (CNIC, business licenses) to verify merchant legitimacy before stores are permitted to sell publicly.
Key Engineering Bottlenecks & Solutions
Multi-Vendor Order Partitioning Without Data Inconsistencies
When a single customer cart contains items from 3 different stores, a partial failure could cause inventory anomalies. Engineered a MongoDB multi-document transactional pipeline that atomically commits all sub-orders or rolls back completely if any store inventory is depleted.
Secure Session Persistence Across Refresh Cycles
Storing tokens in localStorage exposed credentials to XSS vulnerabilities. Implemented a dual-token architecture: short-lived access tokens stored in memory paired with HttpOnly, SameSite=Strict refresh cookies rotated on every API request.
Low-Latency Catalog Search Across Large SKUs
Built compound compound indexes on MongoDB collections (city + category + price) and implemented debounced text search, keeping catalog query execution times under 45ms across thousands of product records.
Evershine Academy ERP & LMS
Multi-campus educational ERP & LMS featuring live biometric fingerprint integration, 7-role portals & automated finance engine.