How shreyxugsot/medusa works
Medusa is a modular commerce platform and customization framework. A typical operator uses the Admin dashboard to manage a commerce application; the README describes broad commerce building blocks, but the supplied source excerpts do not show the API or most commerce-module wiring, so those links are not expanded. The graph preserves the visible fulfillment, workflow persistence/scheduling, indexing, authentication, and Admin-extension capabilities. Workflow storage behavior is sampled; broader subsystem relationships are included only where the tree or README supports the capability, not as asserted call chains.
Main entry points: app.tsx Admin dashboard · utils/workflow-orchestrator-storage.ts In-memory workflow storage · utils/workflow-orchestrator-storage.ts Redis workflow storage · abstract-storage.ts Workflow storage contract
Components 17
Admin experience
- Admin dashboard
packages/admin/dashboard/src/app.tsx - Admin extensions
packages/admin/admin-shared/src/extensions - Admin Vite plugin
packages/admin/admin-vite-plugin/src/index.ts - Backend query config
packages/admin/dashboard/src/lib/query-client.ts
Commerce building blocks
- Commerce framework
packages/core/framework - Fulfillment service
packages/modules/fulfillment/src/services/fulfillment-module-service.ts - Commerce modules
packages/modules
Workflow execution
- Workflow storage contract
packages/core/orchestration/src/transaction/datastore/abstract-storage.ts - In-memory workflow storage
packages/modules/workflow-engine-inmemory/src/utils/workflow-orchestrator-storage.ts - Redis workflow storage
packages/modules/workflow-engine-redis/src/utils/workflow-orchestrator-storage.ts - Workflow execution service
packages/modules/workflow-engine-redis/src/utils/workflow-orchestrator-storage.ts - Execution records
packages/modules/workflow-engine-redis/src/utils/workflow-orchestrator-storage.ts
Identity and indexing
- OIDC engine
packages/modules/providers/auth-oidc/src/engine/engine.ts - Index storage interface
packages/core/types/src/index-data/storage-provider.ts - Index feature flag
packages/medusa/src/feature-flags/index-engine.ts
Other components
- Commerce operator
- OIDC identity provider
Connections 14
- Commerce operator → Admin dashboard: uses
- Admin dashboard → Backend query config: configures backend
- Admin dashboard → Admin extensions: supports extensions
- Admin Vite plugin → Admin extensions: generates modules
- Commerce framework → Commerce modules: provides framework
- Commerce modules → Fulfillment service: includes capability
- Workflow storage contract → In-memory workflow storage: implemented by
- Workflow storage contract → Redis workflow storage: implemented by
- Redis workflow storage → Workflow execution service: runs workflows
- Redis workflow storage → Execution records: reads and writes
- In-memory workflow storage → Workflow execution service: runs workflows
- In-memory workflow storage → Execution records: reads and writes
- OIDC engine → OIDC identity provider: discovers and exchanges
- Index storage interface → Index feature flag: capability gated