Cómo usar la guía de setup de plano
Abre la guía inicial del plano de sala, revisa los hitos pendientes y completa nombre, tipos de mesa, zonas, mesas y combinaciones antes de usar el plano en reservas o TPV.
En este artículo
La guía de setup ayuda a convertir la sala física de Marea Gran Via en un plano operativo dentro de Antylogic. Desde el listado de planos muestra los pasos recomendados y, al crear un plano nuevo, guía al operador dentro del editor.
El flujo no crea ni modifica datos al abrirse. Los cambios solo se persisten cuando se pulsa `Guardar`; cerrar la guía únicamente oculta la ayuda de navegación.
Antes de empezar
- Sesión iniciada en `Grupo Marea Demo` con la ubicación `Marea Gran Via` seleccionada.
- Permiso `layout:view` para consultar planos y abrir la guía en modo lectura.
- Permiso `layout:manage` para crear un plano nuevo, editar componentes y guardar cambios.
- Acceso a `/:orgId/:locationId/location/layouts?setupGuide=layout` o a la tarea `Plano de sala` desde `Primeros pasos`.
Instrucciones
- 1.
Abre la guía del plano
Entra en la pantalla de planos con `setupGuide=layout` o pulsa `Plano de sala` en `Primeros pasos`. El listado muestra el banner `Guia para configurar el plano` encima de los layouts.
- 2.
Revisa los hitos pendientes
Usa el banner para comprobar la secuencia: crear o abrir plano, definir tipos de mesa, dibujar zonas, colocar mesas y añadir combinaciones.
- 3.
Crea un plano nuevo con guía interactiva
Si no hay un plano preferido, la acción abre `layout_id=new`. Con `layout:manage`, el editor muestra una guía de cinco pasos que mueve el foco por nombre, tipos, zonas, mesas y combinaciones.
- 4.
Completa los datos mínimos
Asigna nombre al plano, crea al menos una zona y coloca al menos una mesa dentro de una zona. Mantén nombres únicos en tipos de mesa, zonas y mesas.
- 5.
Añade combinaciones cuando haga falta
Crea combinaciones para mesas que puedan unirse dentro de la misma zona. No son obligatorias para guardar, pero completan la guía de setup.
- 6.
Guarda el plano
Pulsa `Guardar` cuando el plano esté listo. En creación, Antylogic envía el layout con tipos, zonas, mesas y combinaciones; después retira `setupGuide` y vuelve al listado.
- 7.
Continúa sobre un plano existente
Si la guía se abre sobre un layout ya creado, el editor no muestra el overlay de creación. En su lugar aparece un banner con pasos pendientes y accesos a las pestañas del editor.
- 8.
Cierra la guía sin cambiar datos
Cerrar el banner o la superposición elimina `setupGuide` de la navegación. Esta acción no crea, guarda ni borra información del plano.
Validaciones y límites
- Sin `layout:view` ni `layout:manage`, la pantalla muestra el aviso de permisos y no renderiza la guía.
- `setupGuide` solo activa la guía cuando se normaliza como `layout`; otros valores vuelven al listado normal.
- La guía interactiva del editor solo aparece con `layout_id=new`, `readOnly` desactivado y permiso `layout:manage`.
- Antes de guardar, el plano requiere nombre, al menos una zona y al menos una mesa.
- Tipos de mesa, zonas y mesas necesitan nombres únicos; las capacidades deben ser válidas.
- Las combinaciones deben usar mesas de la misma zona y capacidad válida.
- El backend vuelve a validar el payload completo y reemplaza las colecciones asociadas al layout al crear o actualizar.
- Si el plano cargado está eliminado o la ruta entra con `readOnly=true`, la edición queda bloqueada o la guía del editor no se muestra.
Resultado esperado
El local queda con un plano de sala preparado para alimentar reservas, TPV y operación de servicio; si la guía se cerró sin guardar, no se modifica ningún dato.