Gestionar zonas del plano
Dibuja, selecciona, renombra, mueve, redimensiona o elimina zonas rectangulares desde el editor visual del plano.
En este artículo
Las zonas dividen el plano de sala en áreas operativas como Bar, Comedor o Terraza. En el editor visual puedes ajustar esas áreas rectangulares antes de guardar el plano.
Los cambios de zonas no se guardan de forma parcial: al pulsar Guardar se persiste el layout completo, con zonas, mesas, tipos de mesa y agrupaciones.
Antes de empezar
- Usuario autenticado con organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo y Marea Gran Vía en el runtime ES.
- Permiso `layout:view` o `layout:manage` para abrir Planos. Para modificar y guardar zonas hace falta `layout:manage`.
- El editor no puede estar en solo lectura y el layout cargado no puede estar eliminado.
- Para capturas de documentación, abre una copia del plano demo con `layout_id=new&layout_copy_from_id=${SETUP_LAYOUT_SOURCE_LAYOUT_ID}` y no modifiques el plano fuente.
Instrucciones
- 1.
Abre el plano en el editor
Entra en Planos y abre un plano existente o una copia del plano demo. El editor carga el canvas con sus zonas, mesas, tipos de mesa y agrupaciones; en Marea Gran Vía deben verse zonas como Bar, Comedor y Terraza.
- 2.
Crea una zona si necesitas otra área
Pulsa Crear zona y arrastra sobre el canvas. Al soltar, el editor normaliza el rectángulo y crea una zona nueva llamada Zona N. Si el área no llega a 160 x 110, el dibujo se descarta.
- 3.
Selecciona y edita la zona
Selecciona la zona desde el canvas o desde la pestaña Zonas. En el panel Selección puedes cambiar Nombre, X, Y, Ancho y Alto.
- 4.
Mueve o redimensiona con sus mesas
Cuando mueves una zona, sus mesas se desplazan con ella. Cuando la redimensionas, las mesas asociadas se recalculan para mantenerse dentro de sus límites internos.
- 5.
Revisa el impacto antes de eliminar
Si eliminas una zona, el modal avisa de que también se eliminarán sus mesas y las agrupaciones donde aparezcan esas mesas. La eliminación sigue siendo local hasta que guardes.
- 6.
Guarda el plano completo
Pulsa Guardar para persistir los cambios. Un plano existente se actualiza con `PUT /api/app/{orgId}/{locationId}/layouts/{layoutId}`; un plano nuevo o copiado se crea con `POST /api/app/{orgId}/{locationId}/layouts`.
- 7.
Resuelve bloqueos de edición
Si Crear zona, Guardar o los campos aparecen deshabilitados, revisa permisos, modo histórico, estado solo lectura o si el layout fue eliminado. La vista histórica con `occurrence_id` es solo de consulta.
Validaciones y límites
- El nombre del plano es obligatorio para guardar.
- Debe existir al menos una zona y al menos una mesa.
- Todas las zonas deben tener nombre y los nombres deben ser únicos comparando en minúsculas.
- Cada zona debe contener al menos una mesa para que el plano completo pueda guardarse.
- Una zona nueva debe medir al menos 160 x 110; Ancho y Alto respetan ese mínimo y llegan hasta 4800.
- X e Y se editan como enteros no negativos.
- Las agrupaciones solo pueden incluir mesas de la misma zona.
- El backend rechaza payloads sin zonas, sin mesas, con nombres de zona duplicados, con mesas sin zona válida o con agrupaciones que mezclen zonas.
- No existe CRUD REST independiente para `layout_zone`; las zonas se guardan mediante `POST /layouts` o `PUT /layouts/{layoutId}`.
Resultado esperado
El plano queda guardado con sus zonas rectangulares actualizadas dentro del LayoutPayload completo, junto con mesas, tipos de mesa y agrupaciones.