Ejecuta la tienda en local
Instala e inicia cada aplicación con Node.js y Yarn, una terminal por aplicación.
Para el paquete Full Stack
Antes de empezar: instala Node.js 22 o posterior y ejecuta corepack enable una vez. No necesitas un servidor de base de datos.
Abre cada terminal donde la esperan los comandos siguientes: dentro de e-commerce-1 para el paquete Full Stack, o junto a la carpeta de la aplicación para un paquete de una sola aplicación.
| Aplicación | Carpeta | Dirección |
|---|---|---|
| API | back-end | localhost:8000Local |
| Tienda | storefront | localhost:3030Local |
| Panel de administración | admin-dashboard | localhost:3031Local |
Inicia primero la API: ambos frontends obtienen de ella todos sus datos.
Inicia la API
Instala y configura
.env.examplefunciona tal cual para el desarrollo local.¿Tienes problemas?Terminalcorepack enable cd back-end yarn install cp .env.example .envCrea la base de datos
yarn seedcreadatabase.sqlite, sus tablas y la tienda de demostración. Si lo vuelves a ejecutar, solo añade lo que falta.Terminalenback-endyarn seedInicia el servidor
Terminalenback-endyarn devResultado esperado: localhost:8000/api/healthLocal responde
¿Tienes problemas?{"status":"ok"}.
Inicia la tienda
En una segunda terminal:
Instala y configura
El
.envcopiado apunta la tienda a la API en el puerto8000.Terminalcd storefront yarn install cp .env.example .envInícialo
Terminalenstorefrontyarn devResultado esperado: localhost:3030Local abre la tienda en inglés; el árabe está en
¿Tienes problemas?/ar.
Inicia la tienda
La API no forma parte de este paquete. No crees todavía un archivo .env: sin él, la tienda funciona con su tienda de ejemplo integrada.
Inícialo
Terminalenstorefrontyarn devResultado esperado: localhost:3030Local abre la tienda con un aviso "Sample data". Cualquier correo y contraseña te inician sesión como el comprador de ejemplo, y lo que cambies se guarda en el navegador.
Cuando tengas en marcha la API de la plantilla, crea .env a partir de .env.example y pon su dirección en NEXT_PUBLIC_API_BASE_URL. Eso es lo que desactiva la tienda de ejemplo.
Inicia el panel de administración
En una tercera terminal:
Instala y configura
Terminalcd admin-dashboard yarn install cp .env.example .envInícialo e inicia sesión
Terminalenadmin-dashboardyarn devResultado esperado: localhost:3031Local abre el formulario de inicio de sesión, rellenado con el Super Admin:
¿Tienes problemas?admin@example.comcon la contraseñaAdmin@123.
Inicia el panel de administración
La API no forma parte de este paquete. No crees todavía un archivo .env: sin él, el panel funciona con su tienda de ejemplo integrada.
Inícialo e inicia sesión
Terminalenadmin-dashboardyarn devResultado esperado: localhost:3031Local abre el formulario de inicio de sesión, rellenado con
admin@example.comyAdmin@123. Con la tienda de ejemplo, cualquier correo válido con una contraseña de al menos 6 caracteres te inicia sesión como Super Admin, y tus cambios se guardan en el navegador.
El asistente de IA y el estudio de IA no están disponibles con la tienda de ejemplo, porque ambos necesitan las claves de la API. Todo lo demás funciona.
ConfiguraciónVersión de producción
Las mismas carpetas, construidas una vez y luego iniciadas. Primero configura back-end/.env para producción: con NODE_ENV=production la API no crea tablas al iniciarse, y se niega a arrancar mientras JWT_SECRET esté vacío o siga siendo el valor de ejemplo, o mientras CORS_ORIGIN esté vacío.
NODE_ENV=production
JWT_SECRET=<a long random string>
CORS_ORIGIN=http://localhost:3030,http://localhost:3031
FRONTEND_URL=http://localhost:3031Genera el secreto con node -e "console.log(require('crypto').randomBytes(48).toString('hex'))". Después construye la API, crea sus tablas una vez e iníciala. yarn db:sync:prod crea tablas vacías; yarn seed:prod en su lugar añade la tienda de demostración y sus cuentas.
back-endyarn build
yarn db:sync:prod
yarn start:prodCada frontend, la tienda en 3030 y el panel en 3031 (los mismos dos comandos en admin-dashboard):
storefrontyarn build
yarn startLos frontends incorporan su .env al construirse, así que vuelve a ejecutar yarn build después de cambiarlo. Antes de desplegar en cualquier sitio público, lee la lista de comprobación de producción.
Empieza de cero con datos de demostración nuevos
Detén la API, elimina el archivo de la base de datos y vuelve a cargar los datos. Esto elimina todo lo que creaste.
back-endrm -f database.sqlite* && yarn seedEn PowerShell:
back-endRemove-Item database.sqlite*; yarn seed