Cómo editar un plano existente
Actualiza un plano de sala ya creado en Marea Gran Via sin perder la coherencia entre nombre, estado Predeterminado, tipos de mesa, zonas, mesas y agrupaciones.
En este artículo
Editar un plano existente cambia la definición operativa de la sala: qué zonas existen, qué mesas se pueden reservar, qué capacidades admite cada mesa y qué agrupaciones puede usar el equipo durante el servicio.
El guardado se hace como plano completo. Antylogic valida el agregado antes de enviarlo, actualiza el layout con `PUT /api/app/{orgId}/{locationId}/layouts/{layoutId}` y conserva la historia cuando el plano ya estaba ligado a servicios anteriores.
Antes de empezar
- Sesión autenticada en Grupo Marea Demo y ubicación activa Marea Gran Via.
- Permiso `layout:view` para ver la lista de planos y cargar el editor.
- Permiso `layout:manage` para ver la acción Editar, mostrar Guardar y confirmar cambios.
- El plano debe existir, pertenecer a la ubicación activa y no estar borrado.
Instrucciones
- 1.
Abre Planos
Entra en la sección de Planos de Marea Gran Via. La tabla permite localizar el plano por nombre y revisar si es Predeterminado, cuántas mesas contiene y qué capacidad tiene antes de editarlo.
- 2.
Entra al editor
Pulsa Editar en la fila del plano. La pantalla abre el editor visual con el canvas, el panel Editor y los datos actuales del plano cargados desde el detalle.
- 3.
Revisa nombre y Predeterminado
Comprueba el nombre y cambia Predeterminado solo si ese plano debe ser el principal de la ubicación. Si es el único predeterminado, el backend puede mantenerlo así aunque intentes desmarcarlo.
- 4.
Ajusta tipos, zonas y mesas
Edita tipos de mesa, dibuja o ajusta zonas y coloca cada mesa dentro de su zona. Cada mesa necesita nombre y capacidad coherente; una mesa auxiliar puede guardarse con capacidad 0/0.
- 5.
Configura agrupaciones
Crea agrupaciones solo cuando varias mesas de la misma zona vayan a reservarse juntas. El guardado conserva únicamente combinaciones con más de una mesa.
- 6.
Guarda cambios
Pulsa Guardar cuando el plano esté completo. La app valida el contenido, envía el LayoutPayload completo y, si todo es correcto, muestra Plano actualizado y vuelve al listado.
- 7.
Comprende el impacto operativo
Si el plano ya estaba vinculado a servicios, Antylogic puede crear snapshots para conservar la vista histórica. Los servicios futuros que sigan apuntando al plano usan la versión actualizada.
Validaciones y límites
- Sin `layout:manage`, la UI oculta Guardar y el backend deniega la actualización.
- El nombre del plano no puede quedar vacío.
- Debe haber al menos una zona, al menos una mesa y ninguna zona puede quedar vacía.
- Los nombres de tipos de mesa, zonas y mesas deben ser únicos dentro de su grupo, sin distinguir mayúsculas y minúsculas.
- La capacidad de cada mesa debe ser 0/0 o un rango positivo con `min_capacity <= max_capacity`.
- Cada mesa debe pertenecer a una zona válida y solo puede usar un `table_type_id` presente en el mismo plano.
- Cada agrupación necesita `layout_zone_id`, varias `table_ids`, capacidad válida y mesas de una misma zona.
- Guardar reemplaza las colecciones hijas completas: tipos, zonas, mesas y agrupaciones. No es un patch parcial.
- El `layoutId` de la URL es la referencia autoritativa del plano actualizado, aunque el body envíe otro id.
- La vista histórica con `occurrence_id` es solo de lectura y no forma parte de la edición.
Resultado esperado
El plano queda actualizado como una unidad completa, la lista y el detalle se refrescan, el editor vuelve al listado y la historia operativa se preserva cuando hay servicios anteriores vinculados.