Ejecuta el panel sin Docker
Instala e inicia cada aplicación con Node.js y Yarn, una terminal por aplicación.
Para el paquete Front + Back
Antes de empezar: instala Node.js 22.9 o posterior y ejecuta corepack enable una vez. No hace falta ningún servidor de base de datos.
Abre cada terminal en la carpeta dashboard-2-full-stack. Inicia primero la API: el panel lee de ella todos sus datos.
| Aplicación | Carpeta | Dirección |
|---|---|---|
| API | back-end | localhost:8000/ |
| Panel | front-end | localhost:3030Local |
Inicia la API
Instala y configura
.env.examplesirve tal cual para el desarrollo local: SQLite en./database.sqlite, la API en el puerto8000y el panel permitido desdehttp://localhost:3030.Terminalendashboard-2-full-stackcorepack enable cd back-end yarn install cp .env.example .env¿Tienes problemas?Crea la base de datos
yarn seedcreadatabase.sqlite, sus tablas y los datos de ejemplo: 12 administradores, 5 roles y 25 permisos, 15 usuarios y 12 eliminados, 15 proyectos y 12 eliminados, 10 tareas, 13 ajustes de la aplicación y 50 países. Si lo ejecutas de nuevo, conserva tus administradores y sus contraseñas, usuarios, proyectos, tareas y países, y añade lo que falte. Devuelve los ajustes de la aplicación y los permisos de los cinco roles integrados a sus valores de ejemplo, y da el rol Viewer a todo administrador distinto deadmin@example.comque aún no lo tenga.Terminalenback-endyarn seedInicia el servidor
yarn devreinicia la API cada vez que guardas un archivo.Terminalenback-endyarn devResultado esperado: La comprobación de estadoLocal responde con
¿Tienes problemas?"status":"ok"y"database":"up".
Inicia el panel
En una segunda terminal:
Instala y configura
El
.envcopiado apunta el panel a la API en el puerto8000, y al mismo servidor para las actualizaciones de permisos en vivo.Terminalendashboard-2-full-stackcd front-end yarn install cp .env.example .envInícialo e inicia sesión
Terminalenfront-endyarn devResultado esperado: localhost:3030Local abre la página de inicio de sesión. Inicia sesión con
¿Tienes problemas?admin@example.comy la contraseñaAdmin@123.
Sin el .env copiado, el panel no busca la API en absoluto: funciona con su API simulada integrada, con datos de ejemplo guardados en tu navegador.
Inicia el panel
No hace falta ningún archivo .env: sin una dirección de API definida, el panel funciona con su API simulada integrada y datos de ejemplo.
Inícialo e inicia sesión
Terminalendashboard-2-front-endyarn devResultado esperado: localhost:3030Local abre la página de inicio de sesión. Inicia sesión con
¿Tienes problemas?admin@example.comy la contraseñaAdmin@123, y se abre el resumen con un aviso "Sample data".
Para conectarlo a tu API, copia los ajustes de ejemplo con cp .env.example .env: esperan la API en http://localhost:8000/api. Cambia NEXT_PUBLIC_API_BASE_URL y NEXT_PUBLIC_WEBSOCKET_BASE_URL si la tuya funciona en otro sitio y reinicia yarn dev.
Compilación de producción de la API
Primero define el .env de la API para producción: con NODE_ENV=production la API no crea tablas al iniciar y se niega a arrancar mientras JWT_SECRET esté vacío o siga con el valor de ejemplo, o mientras CORS_ORIGIN esté vacío.
NODE_ENV=production
JWT_SECRET=paste-the-generated-secret-here
CORS_ORIGIN=https://admin.your-domain.com
FRONTEND_URL=https://admin.your-domain.comGenera el secreto con node -e "console.log(require('crypto').randomBytes(48).toString('hex'))". Luego, en back-end, compílala, crea las tablas una vez con yarn seed:prod e iníciala:
back-endyarn build
yarn seed:prod
yarn start:prodyarn seed:prod es el único comando que crea las tablas, y también añade los datos de ejemplo y los administradores de ejemplo con sus contraseñas públicas. Antes de salir a producción, inicia sesión y cambia las contraseñas de los administradores de ejemplo en Settings, Security, o elimínalos, y conserva tu propio JWT_SECRET como se indica arriba, antes de que el panel sea accesible para nadie más. Ejecútalo una sola vez: una segunda ejecución devuelve los ajustes de la aplicación y los permisos de los roles integrados a sus valores de ejemplo.
Compilación de producción del panel
En la carpeta del panel, compila una vez e inicia. Sirve en el puerto 3030, o en el PORT de .env o del entorno.
yarn build
yarn startEl panel compila sus valores NEXT_PUBLIC_* en el momento de la construcción, así que ejecuta yarn build de nuevo después de cambiar .env.
Empieza de nuevo con datos de ejemplo limpios
Detén la API, luego elimina el archivo de la base de datos y vuelve a cargarlo con el seed, en back-end. Esto elimina todo lo que creaste.
back-endrm -f database.sqlite* && yarn seedEn PowerShell:
back-endRemove-Item database.sqlite*; yarn seedyarn reset vacía todas las tablas y las conserva; yarn drop elimina todas las tablas. Ejecuta yarn seed después de cualquiera de los dos.