El panel del personal
Lo que hace la trastienda: el resumen, los pedidos y la cola de la cocina, el menú, las categorías, los clientes, el editor de la página de inicio, el estudio y el asistente de IA, el equipo y los roles, y los ajustes del restaurante.
Para el paquete Full Stack
Páginas
Cada página existe en inglés en /en y en árabe en /ar. El panel se abre en /en/dashboard, después del inicio de sesión en /en/auth/login.
| Elemento de la barra lateral | Ruta | Qué hace |
|---|---|---|
| Resumen | /en/dashboard | Los ingresos, los pedidos, el pedido medio y lo que se está preparando de hoy o de ayer, los ingresos por hora, la cola de la cocina, el reparto por categorías, los pedidos recientes, los platos que no se pueden pedir y el plato más popular. |
| Pedidos | /en/dashboard/orders | Todos los pedidos, junto al seleccionado. |
| Menú | /en/dashboard/products/all | Todos los platos, los destacados, los más vendidos y los archivados, y el formulario del plato con su estudio de IA. |
| Categorías | /en/dashboard/categories/all | Las secciones del menú, y las archivadas. |
| Clientes | /en/dashboard/users/all | Las cuentas de cliente, y las eliminadas. |
| Página de inicio | /en/dashboard/homepage | Las nueve secciones de la página de inicio del sitio web. |
| Estudio de IA | /en/dashboard/studio | Cambia el estilo de la foto de un plato y compárala con la original. |
| Asistente de IA | /en/dashboard/ai-assistant | Un chat sobre pedidos, ventas y el menú. |
| Equipo | /en/dashboard/admins-management | Las cuentas del personal, sus roles y su cocina, y los propios roles. |
| Ajustes | /en/dashboard/settings | El perfil y la contraseña de la cuenta con sesión iniciada, y los ajustes del restaurante. |
La campana de la barra superior contiene las notificaciones, una paleta de búsqueda encuentra platos, pedidos y clientes, y el enlace "View storefront" abre NEXT_PUBLIC_STOREFRONT_URL. Los buscadores nunca indexan el panel.
Con los datos de demostración, las cifras de hoy del resumen parten de un día de ejemplo guardado, al que se suman los pedidos pagados hechos desde la carga de datos, y ayer es el día guardado anterior. Una cuenta de cocina nunca ve el resumen, porque informa de dinero.
Propietario, gerente y cocina
| Rol | Qué puede hacer | Cuenta de demostración |
|---|---|---|
| Propietario | Todo, incluidos el equipo y los roles | owner@foodstudio.example |
| Manager | Todo excepto el equipo y los roles: pedidos, menú, categorías, clientes, página de inicio, el estudio y el asistente de IA, ajustes | manager@foodstudio.example |
| Cocina | Los pedidos de una cocina, sin precios y sin el correo del cliente, que pasa de confirmado a en preparación y a listo; y su propio perfil y contraseña | kitchen@foodstudio.example |
- Todas las cuentas de demostración usan la contraseña
FoodDemo2026!. El formulario de inicio de sesión empieza vacío: escribe el correo y la contraseña de la cuenta que quieras. Solo una demo pública, con el modo demo activado, rellena el formulario y muestra un botón para cada cuenta. Cambia estas contraseñas, o elimina las cuentas, antes de pasar a producción. - Los permisos se llaman como
orders.viewoproducts.edit, y la API comprueba uno en cada ruta del personal, muestre lo que muestre la pantalla. - La barra lateral y la paleta de búsqueda omiten lo que una cuenta no puede abrir, y una página abierta por su dirección muestra en su lugar un aviso de acceso.
- Una cuenta de cocina está vinculada a una cocina en Team. Solo ve los pedidos confirmados, en preparación, listos, en reparto y entregados de esa cocina, y nunca el resumen, porque el resumen informa de dinero.
Los pedidos y la cola de la cocina
La lista busca por número de pedido y por cliente, y filtra por estado, entrega o recogida, y fecha, contando el día en la zona horaria de cada cocina. El pedido seleccionado muestra su cliente, la dirección de entrega, los artículos con sus opciones y notas, los totales y la cronología.
| Estado | Significado |
|---|---|
| Pendiente | Hecho y a la espera de su pago. |
| Confirmado | Pagado. Está en la cola de la cocina. |
| En preparación | Cocinándose. |
| Listo | Listo para salir, o para recogerse. |
| En reparto | En camino. Solo pedidos a domicilio. |
| Entregado | Recibido o recogido. Ahora se ganan los puntos de recompensa. |
| Cancelado | Detenido, con un motivo, antes de salir de la cocina. |
| Reembolsado | Lo marca el reembolso del proveedor de pago, nunca se hace a mano. |
- La página del pedido avanza un pedido un paso cada vez, con botones como Mark ready, Send out for delivery y Mark delivered, o lo cancela con un motivo. La API impone el orden de los pasos, y un pedido pendiente no se puede confirmar hasta que está pagado.
- Cada pedido se imprime como ticket de cocina y se descarga como archivo CSV.
- Los pedidos nuevos y los cambios de estado llegan en directo, a la lista y a la campana, sin recargar.
El menú
| Parte del formulario del plato | Campos |
|---|---|
| Detalles | Nombre y descripción en inglés y en árabe, categoría, precio, tiempo de preparación |
| Opciones | Hasta 10 grupos de opciones, como un tamaño o unos extras, cada uno con hasta 40 elecciones y un cambio de precio por elección, y el mínimo y el máximo que puede elegir un cliente |
| Información del plato | Alérgenos, etiquetas de dieta y stock cuando lo controlas |
| Archivos multimedia | Fotos y clips, uno de ellos el principal, con el estudio de IA al lado |
| Interruptores | Publicado, disponible ahora, destacado y más vendido |
- Available now es el interruptor que una cocina activa o desactiva durante el servicio: el plato sigue en el menú pero no se puede pedir.
- Archivar mueve un plato a Archived dishes, desde donde se puede restaurar. Las categorías se archivan y se restauran de la misma forma.
- El combo, sus opciones y sus suplementos son una oferta que guarda la API; el asistente puede activarla y desactivarla.
Clientes
La lista de clientes busca y filtra clientes, con los recuentos encima. El personal puede añadir un cliente, abrir sus datos, cambiar su contraseña, marcar su correo como verificado, eliminarlo y restaurarlo. Los clientes editan sus propios datos desde su cuenta en el sitio web.
La página de inicio del sitio web
Homepage muestra las nueve secciones en el orden de la página. Arrástralas, o usa las flechas, para reordenarlas; activa o desactiva cada una; y abre una para editar su texto en los dos idiomas. Los cambios se guardan mientras escribes.
| Sección en la barra lateral | En el sitio web |
|---|---|
| Portada | El banner de apertura |
| Categorías | La fila de categorías |
| Platos populares | Hasta ocho platos populares |
| Oferta de combo | El combo destacado |
| Creador de comidas | La franja para crear tu comida |
| Ingredientes | Las tres tarjetas de ingredientes |
| Entrega | La franja de entrega |
| Recompensas | La franja de recompensas |
| Preguntas frecuentes | Las preguntas y respuestas |
Editar una sección necesita el permiso products.edit.
El estudio de IA y el asistente de IA
- El estudio de IA elige un plato, cambia el estilo de su foto con un fondo, una iluminación y una indicación que dice qué conservar, y compara la original con el resultado. Save as draft guarda el resultado en el borrador del plato hasta que guardes el plato. Un botón "Remove background" recorta el plato cuando el archivo del modelo está instalado.
- El estudio en el formulario del plato tiene un modo Assistant, que escribe los datos del plato a partir de sus fotos y edita fotos cuando se lo pides, y un modo Animate, que convierte una foto en un clip corto. Los resultados llegan a una lista Generations; añade al plato los que te gusten.
- El asistente de IA consulta pedidos, platos y ventas y dibuja gráficos. Todo lo que cambiaría datos se muestra primero como una diferencia y solo se ejecuta cuando lo confirmas.
- Sin una clave de Google AI en la API, el estudio dice "Image generation is not connected" y el asistente dice "No AI model is connected". Todo lo demás del panel funciona.
Equipo y roles
- Members muestra el personal y permite añadir, editar y eliminar miembros. Cada miembro tiene uno o varios roles, y un miembro de cocina está vinculado a una cocina.
- Roles crea, renombra y elimina roles, y concede sus permisos desde una cuadrícula agrupada por área. Un miembro tiene todos los permisos de todos sus roles, y un cambio llega al instante a un miembro con sesión iniciada.
- Solo el propietario ve Team: los roles de gerente y de cocina no tienen ningún permiso de equipo ni de roles.
La carga de datos crea ocho cuentas del personal: el propietario, tres gerentes y una cuenta de cocina para cada una de las cuatro cocinas.
Ajustes
Settings tiene tres pestañas. Profile y Security pertenecen a la cuenta con sesión iniciada y están abiertas a todos los miembros. Restaurant necesita el permiso settings.view para leer y settings.edit para cambiar.
| Panel Restaurant | Qué define |
|---|---|
| Cocinas | El nombre, la dirección, el código postal, el contacto, el horario, la zona horaria, el tiempo de preparación, los códigos postales de entrega (hasta 50), el plato destacado y la ubicación en el mapa de cada cocina, y si acepta pedidos |
| Tarifas de entrega y recogida | La tarifa de entrega, la tarifa de recogida y el mínimo de entrega, en dólares |
| Reloj de servicio | Real, que lee la hora propia de cada cocina, o Demo clock, que mantiene todas las cocinas a las 20:55 para poder hacer pedidos a cualquier hora. La carga de datos empieza con el reloj de demostración. |
| Recompensas | Puntos por dólar, puntos por canje y cuánto vale un canje |
| Códigos promocionales | El porcentaje de cada código, si cubre solo el menú o todo el pedido, si se combina con las recompensas y si está activo |
| Pagos | Los métodos de pago que ofrece esta versión y si cada uno está en modo de prueba o real. Solo lectura: las claves se configuran en el servidor. |
| Idioma y tema | Cómo se ve el panel para ti, guardado en este navegador |
| Todos los ajustes por clave | Cada ajuste guardado, incluidos el nombre, el eslogan, el correo de soporte y el teléfono del restaurante |
Notificaciones
- Un pedido nuevo notifica al personal que puede verlo, y una generación del estudio de IA terminada o fallida notifica al miembro que la inició. Una cuenta de cocina solo recibe avisos de los pedidos de su propia cocina cuando llegan a su cola.
- Llegan en directo, con un mensaje breve en pantalla, y se quedan en la lista de la campana hasta que se leen o se eliminan, durante 30 días.
- La conexión en directo usa
NEXT_PUBLIC_WEBSOCKET_BASE_URL, la dirección de la API sin/api, y la API solo la acepta desdeFRONTEND_URL. En tus propios dominios, configura ambas.
Modo demostración
Incluido con tu compra. Inicia sesión para leerlo o ábrelo en tu descarga.
Cómo ejecutar una demostración pública: cuentas por visitante, lo que los visitantes pueden cambiar y el uso de su propia clave.
Cómo encaja el código del panel
Incluido con tu compra. Inicia sesión para leerlo o ábrelo en tu descarga.
La estructura del código, y las recetas para añadir una página, una traducción y un servicio de API.