NerionX Medusa.js Developer

We are seeking a technical partner to build NerionX, a platform designed on the principle: "Centralize Commerce, Decentralize Experience." By leveraging the modularity of Medusa.js v2, we are architecting a "Hub" that manages global operational logic, while empowering autonomous "Spokes" (Brand Kits) to generate, localize, and store their own product content. We have a clear architectural roadmap and are looking for an expert team to help us execute a system that supports 50+ independent brands with zero shared-state bottlenecks.

The project is structured into three distinct zones, ensuring a clean separation between global operations and brand-specific experiences:

1. The Hub (NerionX Core) The centralized engine and single source of truth for all operational and transactional data.

• Operational Core: A unified Medusa.js v2 stack managing a master catalog of 25,000+ SKUs and variants.

• Global Governance: Enforcing "Price Floors" and unit-level profitability across all tenants via a centralized pricing engine and custom logic layers.

• Fulfillment Orchestration: A unified engine coordinating global inventory across multiple 3PLs with a strict 9-state lifecycle and pessimistic database locking to ensure inventory integrity.

2. The Spoke (Brand Kit) A containerized, deployable environment living on the Brand Owner’s infrastructure, responsible for the entire customer-facing layer.

• Local Commerce & Content: A lightweight Medusa v2 instance paired with Payload CMS 3.0. While the Hub provides raw product identities, the Spoke handles all localized titles, descriptions, and SEO metadata.

• Agentic Localization: A CrewAI (Python) pipeline that listens to Hub events and automatically generates brand-specific product content, which is then stored locally in the Spoke's CMS instance.

• Checkout Autonomy: Total independence to integrate regional payment providers (e.g., Stripe, Adyen) and manage localized pricing markups or subscription models.

3. The Integration Layer A hybrid communication model ensuring both transactional integrity and high-performance scaling:

• Asynchronous (Event Bus): Real-time broadcasting of raw product data and stock updates from the Hub to Spokes via Redis + BullMQ.

• Synchronous (Order Gateway): Direct REST API calls for finalized order payloads, ensuring the Hub validates fulfillment only after local payment success.

The Technical Stack Summary

Commerce Engine : Medusa.js v2 (Node.js, TypeScript)

Content Engine: Payload CMS 3.0 (Spoke-side only for localized content)

Database: PostgreSQL 16+ (Centralized Core + Isolated Local Tenant Schemas)

Search & Discovery: OpenSearch (Independent cluster for high-speed indexing)

Frontend: Next.js (App Router), Tailwind CSS, shadcn/ui

Logic & Events: Redis, BullMQ, Python (CrewAI for Agentic Workflows)