Comercio electrónico solución

Ejecuta Medusa en local con FlyEnv

Los proyectos Medusa usan Node.js, PostgreSQL, Redis y, a menudo, un proxy local. FlyEnv mantiene organizado este stack de comercio TypeScript para el desarrollo local.

Descargar FlyEnv Documentación oficial

Stack del proyecto local

Servicios que FlyEnv puede gestionar para Medusa

Acerca de Medusa

Medusa es una plataforma de comercio componible para construir tiendas y servicios de comercio personalizados con Node.js y TypeScript. Sus módulos y workflows modelan productos, carritos, pedidos, promociones, pagos, fulfillment y procesos de negocio personalizados sin imponer un storefront.

Un backend de Medusa suele usar Node.js y PostgreSQL, e incluye su Admin en `/app` sobre el origen del backend. Redis es relevante cuando el backend configura infraestructura basada en Redis; el desarrollo sencillo con v2 puede usar providers locales. Un storefront personalizado es una aplicación aparte cuando el proyecto lo tiene, mientras que los providers de pago, fulfillment, búsqueda y archivos deberían ejecutarse o simularse según las integraciones en desarrollo.

Capacidades principales

Módulos de comercio
Workflows
Store APIs
Admin APIs
Motor de promociones
Interfaces de providers

Casos de uso comunes

Backends de comercio personalizados
Frontends de tienda headless
Extensiones de marketplace y multivendedor
Comercio por suscripción o B2B
Integraciones de fulfillment y pago

El desarrollo local con Medusa coordina un servicio de comercio y sus providers

Los flujos de producto solo son creíbles en local cuando se representan los límites de datos, caché y providers seleccionados.

Backend de Medusa con Node.js: Ejecuta los comandos de Medusa CLI, la API de comercio y los workflows específicos del proyecto.
PostgreSQL: Almacena las entidades de comercio y es una dependencia estándar del backend de Medusa.
Redis: Ejecútalo solo cuando el backend configura infraestructura basada en Redis; el desarrollo sencillo con v2 puede usar providers locales.
Admin integrado y storefront personalizado: Usa el Admin del backend en `/app` (por ejemplo, `localhost:9000/app`); ejecuta un servidor Node.js separado solo para un storefront personalizado.
Providers de comercio: Usa sandboxes o sustitutos locales para los providers de pago, fulfillment, búsqueda y archivos configurados.

Recursos del proyecto

Para los comandos de instalación, las versiones compatibles y la configuración específica del proyecto, consulta la documentación oficial de Medusa .

Stack local típico

Los servicios exactos dependen del proyecto, su versión y su configuración local. Esta es una configuración local común, no un requisito fijo.

Componente	Rol típico
Node.js	Ejecuta Node.js para el entorno local de Medusa.
PostgreSQL	Ejecuta PostgreSQL para el entorno local de Medusa.
Redis	Ejecuta Redis para el entorno local de Medusa.
Nginx Caddy	Ejecuta Nginx / Caddy para el entorno local de Medusa.

Cómo ayuda FlyEnv

Adapta el runtime del proyecto
Elige la versión de runtime que necesita Medusa.
Gestiona los servicios locales
Inicia bases de datos, cachés y otros servicios solo cuando el proyecto los necesite.
Mantén los proyectos aislados
Permite que cada proyecto use sus propias versiones y configuraciones de servicios.
Configura dominios locales
Accede a los proyectos mediante dominios locales y HTTPS cuando sea necesario.

Configura el entorno local

La instalación del proyecto sigue la documentación oficial. FlyEnv gestiona los runtimes, las bases de datos, los servidores web y los servicios auxiliares que lo rodean.

1Instala el proyecto y sus dependencias siguiendo la documentación oficial de Medusa.
2Selecciona en FlyEnv la versión de runtime que necesita el proyecto.
3Inicia los servicios de base de datos indicados en la configuración del proyecto.
4Inicia la caché, la búsqueda u otros servicios auxiliares solo cuando sean necesarios.
5Configura el servidor web local, los dominios y HTTPS según sea necesario.
6Agrupa los servicios relacionados para iniciarlos juntos de nuevo con facilidad.