Gestionar mesas

En este artículo

Antes de empezar

• Iniciar sesión en Antylogic con Grupo Marea Demo y la ubicación Marea Gran Via seleccionados.
• Tener `layout:view` para abrir planos y `layout:manage` para crear, mover, editar, duplicar, eliminar y guardar mesas.
• Abrir Planos sobre un layout existente, un layout nuevo o una copia de trabajo como `Manual docs copy`.
• Para crear una mesa debe existir al menos una zona en el plano; si no hay zonas, `Crear mesa` queda deshabilitado.
• Para asignar un tipo de mesa, ese tipo debe existir dentro del mismo layout.
• Trabajar sobre un plano activo; las vistas históricas, de solo lectura o de planos eliminados no permiten cambios.

Instrucciones

1. 1.

   Abrir el editor del plano

   Desde Planos, abre un layout existente o una copia de trabajo. El editor muestra el lienzo con zonas y mesas, la barra de herramientas, el panel lateral y la acción `Guardar`.

2. 2.

   Crear una mesa dentro de una zona

   Pulsa `Crear mesa`, elige forma cuadrada o redonda y arrastra dentro de una zona. Al soltar, la app crea una mesa con nombre incremental, capacidad 2-4 y sin tipo asignado.

3. 3.

   Editar la mesa seleccionada

   Selecciona una mesa como B1 o C1 para abrir `Selección`. Desde el panel puedes cambiar nombre, `Mesa supletoria`, capacidad mínima y máxima, forma, tipo de mesa, posición y tamaño.

4. 4.

   Mover, redimensionar o duplicar

   Arrastra la mesa en el lienzo, usa los tiradores para ajustar su tamaño o duplícala desde la barra. Las mesas redondas conservan un diámetro único y la copia recibe un nombre incremental.

5. 5.

   Eliminar una mesa

   Selecciona la mesa, usa `Eliminar` y confirma el diálogo. El borrado queda como cambio local hasta guardar; si cancelas o cierras el editor, no se persiste.

6. 6.

   Guardar el layout completo

   Pulsa `Guardar` cuando el plano esté completo. Un layout existente se actualiza con `PUT /api/app/{orgId}/{locationId}/layouts/{layoutId}`; un layout nuevo o copiado se crea con `POST /api/app/{orgId}/{locationId}/layouts`.

7. 7.

   Consultar histórico sin editar

   Si abres el layout con lectura histórica o modo solo lectura, puedes revisar la distribución usada por una ocurrencia anterior, pero los controles de creación, edición, duplicado, borrado y guardado quedan deshabilitados.

Validaciones y límites

• El layout debe tener nombre, al menos una zona y al menos una mesa antes de guardar.
• Cada mesa necesita un nombre no vacío y los nombres de mesa deben ser únicos sin distinguir mayúsculas y minúsculas.
• Una mesa normal usa capacidad positiva con mínimo menor o igual que máximo; `Mesa supletoria` guarda capacidad `0/0`.
• Cada mesa debe pertenecer a una zona enviada en el mismo payload mediante `layout_zone_id`.
• Si una mesa informa `table_type_id`, ese tipo debe existir en `table_types` del mismo layout.
• Cada zona enviada debe contener al menos una mesa; eliminar la última mesa de una zona bloquea el guardado.
• Para dibujar una mesa debe haber forma seleccionada, el trazo debe empezar dentro de una zona y el tamaño mínimo es 48 de ancho y alto.
• Las combinaciones que queden en el payload también deben usar mesas de la misma zona y capacidad válida.
• No existe un CRUD independiente de mesas en la API de aplicación: al guardar se persiste el `LayoutPayload` completo.
• Guardar reemplaza zonas, tipos, mesas y combinaciones del layout; no aplica un parche parcial de una sola mesa.
• No documentar bloqueo de solapamiento entre mesas, porque no se encontró una validación persistente de solapamiento.

Resultado esperado

El plano queda guardado como un layout completo con sus mesas, zonas, tipos y combinaciones. La aplicación vuelve al listado y muestra el estado actualizado; si el plano ya estaba referenciado por servicios, el sistema puede conservar snapshots históricos antes de aplicar la nueva versión.