MERIDIAN
Global E-Commerce Platform
MERIDIAN is a global e-commerce affiliate and marketplace platform built for vendors to sell physical products or redirect buyers to external merchants. Launched in Saudi Arabia with a multi-country schema from day one, built as a monorepo with 8 workspace packages, 4 applications, 12 domain modules, and ~111 API endpoints.
~111
API Endpoints
30
DB Entities
9
State Machines
~400
Unit Tests
Modular Backend Architecture
Single NestJS application with 12 bounded-context modules communicating via domain events (EventEmitter2). Port/Adapter pattern isolates payment and shipping integrations, designed for Stripe/HyperPay and Aramex/DHL without coupling business logic to vendor APIs. Idempotency keys prevent duplicate orders, payments, and refunds.
Three-App Frontend + Shared UI Kit
Customer storefront (15 routes), vendor portal (17 routes), and admin panel (16 routes), all sharing a 25+ component UI kit with SWR data fetching, 5 hooks, and 3 providers. Each app has its own design system: the storefront uses Cormorant Garamond and gold accents; the vendor portal uses dark sidebar with indigo accents.
Commerce & Inventory Logic
9 explicit state machines control every status transition: products, offers, orders, payments, shipments, reviews, and eligibility. Stock is reserved on order creation and released on cancellation. Cart items are re-validated at checkout. Prices are snapshotted at order time. Reviews are gated to verified purchases within a 90-day window.
Operational Value
Supports multiple revenue models from one platform. Scales vendor operations with admin and portal tooling. Provides foundation for regional marketplace expansion.
Tech Stack
Full Stack
Related Service