Pantallas, roles y permisos
Cada pantalla del panel, qué lee y qué guarda, y cómo los roles y los permisos deciden lo que puede hacer cada administrador.
Para el paquete Front + Back
Las pantallas
Cada pantalla vive bajo /en/dashboard y /ar/dashboard, detrás del inicio de sesión, y aparece en la barra lateral.
| Pantalla | Dirección | Qué hace |
|---|---|---|
| Inicio de sesión | /en/auth/login | Correo electrónico y contraseña, con Remember me. Los botones de Google y Apple y "Forgot your password?" son marcadores que indican que no están configurados: un administrador define una contraseña nueva desde Admin Management. |
| Resumen | /en/dashboard | Un saludo con el tiempo local, cifras clave, información, rendimiento, un radar, un gráfico de ingresos, un mapa del mundo, un calendario, los últimos proyectos y tus tareas rápidas. Export guarda la página como imagen PNG. |
| Asistente de IA | /en/dashboard/ai-assistant | Conversa sobre tus datos con palabras sencillas. Responde con cifras, tarjetas, gráficos y listas, y puede crear, editar, eliminar y restaurar usuarios y cambiar ajustes de la aplicación, dentro de tus propios permisos. |
| Usuarios | /en/dashboard/users/all | Busca, filtra, crea y edita usuarios, cambia una contraseña, marca un correo como verificado o no, y elimina. Cada usuario tiene su propia página. |
| Usuarios eliminados | /en/dashboard/users/deleted | Usuarios eliminados de la lista, conservados para poder restaurarlos. |
| Proyectos | /en/dashboard/projects/all | Proyectos con un estado (en curso, listo, bloqueado), un entorno, una versión, una imagen y un nombre y una descripción en inglés y en árabe. Cada proyecto tiene su propia página. |
| Proyectos eliminados | /en/dashboard/projects/deleted | Proyectos eliminados, conservados para poder restaurarlos. |
| Gestión de administradores | /en/dashboard/admins-management | Los administradores que pueden iniciar sesión: crear, editar, dar roles, eliminar. Cada administrador tiene su propia página. |
| Roles de administrador | /en/dashboard/admins-roles | Crea y renombra roles y elige los permisos que concede cada uno. |
| Ajustes | /en/dashboard/settings | Profile (tu nombre, correo, teléfono, país e imagen), Security (tu contraseña) y App Settings (los ajustes propios de la aplicación, como el nombre del sitio, el correo de soporte y el modo de mantenimiento). |
| UI Component | /en/dashboard/ui-component | Cada componente reutilizable del panel con un ejemplo en vivo: botones, campos, tablas, modales, paneles laterales, gráficos, un editor de texto enriquecido, un campo de teléfono, un mapa del mundo y más. |
Qué es real y qué es de ejemplo
- Los usuarios, proyectos, administradores, roles, permisos, ajustes de la aplicación, tus tareas rápidas y las conversaciones del asistente se leen de la API, o de la API simulada integrada en tu navegador, y se guardan en ella.
- En el resumen, el total de usuarios, el total de proyectos y la tabla de proyectos vienen de la API. Las demás cifras y gráficos (información, rendimiento, el radar, los ingresos, el mapa del mundo y los eventos del calendario) son datos de ejemplo en el código, listos para conectarse a tus propias fuentes.
- Eliminar un usuario o un proyecto es un borrado lógico: la fila se conserva y aparece en Deleted, desde donde se puede restaurar.
- "Resend verification email" en un usuario responde que el correo se envió, pero la API no envía ningún correo: es el lugar donde conectar tu propio servicio de correo.
Claro y oscuro
El encabezado cambia entre modo claro y oscuro, y el navegador recuerda la elección. Cada color es una variable CSS definida para los dos temas.
Roles
Un administrador puede tener varios roles y recibe todos los permisos que conceda cualquiera de ellos. El seed crea cinco roles, que puedes cambiar en la página Admin Roles:
| Rol | Qué puede hacer |
|---|---|
| Super Admin | Todo |
| Panel de administración | Todo excepto eliminar administradores y crear, editar o eliminar roles o lo que conceden |
| Manager | Usuarios y proyectos al completo, el asistente, y ver administradores, roles y ajustes |
| Editor | Ver, crear y editar usuarios y proyectos, y usar el asistente |
| Viewer | Ver todas las listas (administradores, roles, ajustes, usuarios y proyectos), sin crear, editar ni eliminar y sin asistente; su propia contraseña y sus tareas rápidas siguen funcionando |
admin@example.com es el Super Admin. Todos los demás administradores del seed, como john.smith@admin.com, son Viewer.
Permisos
Hay 25 permisos, con nombres module.action:
| Módulo | Permisos |
|---|---|
| Administradores | admins.view, admins.create, admins.edit, admins.delete, admins.assign_roles |
| Roles | roles.view, roles.create, roles.edit, roles.delete, roles.assign_permissions |
| Usuarios | users.view, users.create, users.update, users.delete, users.restore, users.verify |
| Proyectos | projects.view, projects.create, projects.edit, projects.delete, projects.restore |
| Ajustes | settings.view, settings.edit |
| Asistente de IA | ai_chat.use, ai_chat.view_models |
- La API comprueba el permiso en cada ruta, y el asistente lo comprueba en cada herramienta que ejecuta. El panel solo decide qué mostrar: un botón que un administrador no puede usar se oculta.
- Guardar tu propio perfil necesita
admins.edit. Cambiar tu propia contraseña y tus tareas rápidas no necesita ningún permiso: cada administrador tiene las suyas. - Cuando cambian los permisos de un rol, el panel de cada administrador con sesión iniciada recibe el aviso por una conexión en vivo, y sus menús y botones se ajustan sin recargar.
Cómo encaja el código
Incluido con tu compra. Inicia sesión para leerlo o ábrelo en tu descarga.
Dónde vive el código de cada pantalla, cómo obtiene sus datos una pantalla, cómo comprobar un permiso y cómo añadir una página.