Ejecuta el panel en local
Pon tu paquete en marcha en tu ordenador con Docker y luego inicia sesión.
Para el paquete Front + Back
Antes de empezar: instala y abre Docker Desktop, o Docker Engine en Linux. No necesitas nada más.
Ver los requisitosDescarga tu plantilla
Abre Mis plantillas y descarga el ZIP de Full Stack.
Resultado esperado: En tus descargas hay un archivo con un nombre como
dashboard-2-full-stack-….zip.Descomprime y abre la carpeta
Extrae el ZIP y abre una terminal en la carpeta
dashboard-2-full-stack. En Windows, extráelo en el Explorador de archivos y luego abre una terminal en la carpeta.Terminalunzip dashboard-2-full-stack-*.zip cd dashboard-2-full-stackResultado esperado: La carpeta contiene
¿Tienes problemas?back-end,front-end,docker-compose.yml,README.mdyQUICKSTART.md.Inicia las aplicaciones
Construye e inicia la API y el panel. No hay que configurar nada antes. El primer inicio construye dos imágenes y rellena la base de datos con los datos de ejemplo, lo que tarda unos minutos; los siguientes inicios tardan segundos.
Terminalendashboard-2-full-stackdocker compose up --build¿Un puerto ya está en uso?
Si el inicio se detiene con
Un puerto ya está en usoports are not available ... address already in useoport is already allocated, otro programa usa 3030 u 8000. Detenlo, o crea un archivo llamado.enven la carpetadashboard-2-full-stack, junto adocker-compose.yml, con el puerto que necesites, comoDASHBOARD_PORT=3040(API_PORTpara la API). Ejecutadocker compose up --buildde nuevo y abre el panel en su nuevo puerto.Resultado esperado: Los dos servicios siguen en ejecución y el registro deja de desplazarse. Deja esta terminal abierta.
¿Tienes problemas?Abre el panel e inicia sesión
Abre localhost:3030Local. Te lleva a la página de inicio de sesión. Inicia sesión con
admin@example.comy la contraseñaAdmin@123. El árabe está en/ar.Resultado esperado: El resumen se abre con las cifras, los gráficos, el calendario y tus tareas rápidas.
¿Tienes problemas?
La API responde en localhost:8000/
Cuentas de acceso
| Cuenta | Correo electrónico | Contraseña |
|---|---|---|
| Super Admin: todas las páginas y todas las acciones | admin@example.com | Admin@123 |
| Viewer: ve todas las listas, no puede crear, editar ni eliminar registros ni abrir el asistente de IA; puede cambiar su propia contraseña y sus tareas rápidas | john.smith@admin.com | admin123 |
El seed añade diez administradores más con el rol Viewer, todos con la contraseña admin123.
Antes de salir a producción. Cada seed (yarn seed, yarn seed:prod y el primer inicio de Docker) crea estos administradores de ejemplo con estas contraseñas. Cambia sus contraseñas o elimínalos, y define tu propio JWT_SECRET, antes de que el panel sea accesible para nadie más.
Haz un recorrido
Cómo se ve el panel una vez en marcha.
Detén e inicia de nuevo
Pulsa Ctrl+C en la terminal para detener las aplicaciones, o ejecuta esto desde la carpeta. Tus datos se conservan en el volumen dashboard-2-data.
dashboard-2-full-stackdocker compose downVuelve a iniciar con el mismo comando del paso 3. Sin --build, reutiliza las imágenes que ya construiste.
dashboard-2-full-stackdocker compose upConserva tus datos
docker compose down -v también elimina el volumen de datos. El siguiente inicio carga una copia nueva de los datos de ejemplo y todo lo que creaste desaparece.
Ejecuta el panel
Este paquete es el panel por sí solo. Construida sin argumentos, la imagen funciona con la API simulada integrada, así que no necesitas ningún back-end para probarlo.
Descarga tu plantilla
Abre Mis plantillas y descarga el ZIP de Panel de administración.
Resultado esperado: En tus descargas hay un archivo con un nombre como
dashboard-2-front-end-….zip.Descomprime y abre la carpeta
Terminalunzip dashboard-2-front-end-*.zip cd dashboard-2-front-endResultado esperado: La carpeta contiene
¿Tienes problemas?Dockerfile,package.json,messages,publicysrc.Construye la imagen
Docker instala las dependencias y construye el panel dentro de la imagen. La primera construcción tarda unos minutos y necesita conexión a internet.
Terminalendashboard-2-front-enddocker build -t dashboard-2 .Resultado esperado: La construcción termina con una línea que nombra la imagen
¿Tienes problemas?dashboard-2.Inícialo e inicia sesión
Inicia un contenedor, luego abre localhost:3030Local e inicia sesión con
admin@example.comy la contraseñaAdmin@123. Deja la terminal abierta mientras lo uses. Si el puerto3030está ocupado, cambia el número de la izquierda de-p, por ejemplo-p 3040:3030, y abre localhost:3040Local en su lugar.Terminalendashboard-2-front-enddocker run -p 3030:3030 dashboard-2Resultado esperado: Se abre el resumen, con un aviso "Sample data" al final de la página.
¿Tienes problemas?
Cuentas de acceso
| Cuenta | Correo electrónico | Contraseña |
|---|---|---|
| Super Admin: todas las páginas y todas las acciones | admin@example.com | Admin@123 |
| Viewer: ve todas las listas, no puede crear, editar ni eliminar registros ni abrir el asistente de IA; puede cambiar su propia contraseña y sus tareas rápidas | john.smith@admin.com | admin123 |
En la API simulada, estas cuentas y los datos de ejemplo viven en tu navegador: lo que crees, edites o elimines se guarda solo en ese navegador, y al borrar los datos del sitio vuelven los ejemplos.
Detén e inicia de nuevo
Pulsa Ctrl+C en la terminal para detener el panel. Si cerraste esa terminal, busca el contenedor y detenlo:
docker ps
docker stop <container-id>Usa el ID que docker ps muestra para dashboard-2. Para iniciar de nuevo, ejecuta el mismo comando docker run. Después de cambiar un archivo, construye la imagen otra vez: contiene una copia del código del momento en que se construyó.
Conéctalo a tu API
La dirección de la API se compila en el JavaScript que carga el navegador, así que es un argumento de construcción. Usa la dirección con la que el navegador llega a la API, con /api, y la misma dirección sin ella para las actualizaciones de permisos en vivo:
dashboard-2-front-enddocker build -t dashboard-2 --build-arg NEXT_PUBLIC_API_BASE_URL=http://localhost:8000/api --build-arg NEXT_PUBLIC_WEBSOCKET_BASE_URL=http://localhost:8000 .
docker run -p 3030:3030 dashboard-2La API debe permitir la dirección del panel, http://localhost:3030, en su CORS_ORIGIN. El panel está escrito para la API de NestJS de esta plantilla, que viene con el paquete Full Stack.