Cómo crear un plano de sala
Crea desde cero el plano operativo de Marea Gran Via, con zonas, mesas, capacidades, tipos de mesa opcionales, combinaciones y la opción de marcarlo como plano predeterminado.
En este artículo
El plano de sala define cómo se organiza una ubicación para operar reservas, capacidad y mesas dentro de Antylogic. En el demo ES, este recorrido se documenta sobre Grupo Marea Demo y la ubicación Marea Gran Via.
El flujo empieza en la lista de planos, abre el editor visual con `layout_id=new` y guarda el agregado completo cuando el nombre, las zonas y las mesas cumplen las validaciones.
Antes de empezar
- Sesión autenticada en la aplicación interna.
- Contexto activo de organización y ubicación en `/:orgId/:locationId`; en el demo, Marea Gran Via.
- Permiso de ubicación `layout:view` para abrir la pantalla de planos.
- Permiso de ubicación `layout:manage` para ver `Nuevo plano`, editar el lienzo y guardar.
Instrucciones
- 1.
Abre la lista de planos
Entra en `/:orgId/:locationId/location/layouts` con la ubicación activa. La pantalla muestra los planos existentes y, con permiso de gestión, la acción `Nuevo plano`.
- 2.
Inicia un plano nuevo
Pulsa `Nuevo plano`. Antylogic abre el editor con `layout_id=new`, sin cargar un plano existente y con el lienzo inicial preparado para dibujar desde cero.
- 3.
Completa los datos base
Escribe el nombre del plano y marca `Predeterminado` solo si debe ser el plano principal de la ubicación. Los tipos de mesa son opcionales y sirven para reutilizar forma, color o capacidad.
- 4.
Dibuja las zonas
Crea al menos una zona en el lienzo, por ejemplo `Sala principal`, y ajusta su posición y tamaño antes de colocar mesas dentro.
- 5.
Añade mesas y capacidades
Crea al menos una mesa dentro de una zona, por ejemplo `S1`, y revisa su capacidad mínima y máxima. Si algunas mesas se usan juntas, puedes crear combinaciones con dos o más mesas de la misma zona.
- 6.
Guarda el plano
Pulsa `Guardar`. Si las validaciones pasan, la aplicación ejecuta `POST /api/app/{orgId}/{locationId}/layouts`, cierra el editor y vuelve al listado refrescado.
- 7.
Usa la guía si aplica
Si la ubicación se abre con `setupGuide=layout`, la guía puede llevar al mismo editor de creación cuando todavía falta completar el plano de sala.
Validaciones y límites
- El nombre del plano es obligatorio y debe ser único dentro de la ubicación.
- Debe existir al menos una zona y al menos una mesa para guardar.
- Cada zona y cada mesa debe tener nombre no vacío y único sin distinguir mayúsculas.
- No se puede crear una mesa antes de crear una zona; cada mesa debe pertenecer a una zona válida.
- La capacidad debe ser `0/0` para mesa auxiliar o un rango positivo con `min_capacity <= max_capacity`.
- Las combinaciones son opcionales, pero deben usar dos o más mesas de la misma zona.
- El guardado requiere `layout:manage`; sin ese permiso, las acciones de escritura no aparecen.
- Si falla una validación o la API devuelve error, el editor permanece abierto y muestra el mensaje correspondiente.
Resultado esperado
El plano queda creado para la ubicación, la lista se actualiza y el equipo puede usar sus zonas, mesas, capacidades y estado predeterminado en la operativa de sala.