Cómo gestionar tipos de mesa
Crea, edita o retira tipos de mesa dentro de un plano. Cada tipo funciona como etiqueta visual opcional para las mesas y se guarda junto con el layout completo.
En este artículo
Los tipos de mesa ayudan al equipo de sala a reconocer grupos dentro de un plano concreto, por ejemplo barra alta, comedor o terraza. En Antylogic viven dentro del layout abierto y se pueden asignar de forma opcional a cada mesa.
Este flujo está pensado para responsables de sala y administradores de ubicación que ajustan el plano de Marea Gran Via. Para la documentación demo, trabaja sobre una copia como `Manual docs copy` y guarda el plano completo solo cuando las referencias estén revisadas.
Antes de empezar
- Sesión iniciada con organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo > Marea Gran Via.
- `layout:view` permite abrir y revisar planos; `layout:manage` es obligatorio para crear, editar, eliminar tipos de mesa y guardar.
- El plano debe ser editable: no histórico, no eliminado y perteneciente a la ubicación actual.
- El layout completo debe seguir siendo válido al guardar: nombre, zonas, mesas, capacidades y referencias internas coherentes.
Instrucciones
- 1.
Abrir o copiar el plano
Entra en Planos y abre un layout editable. Para la demo, copia el plano de referencia de Marea Gran Via con `layout_id=new&layout_copy_from_id=...` antes de modificar tipos.
- 2.
Abrir Tipos de mesa
Muestra el panel lateral del editor y selecciona `Tipos de mesa`. La lista pertenece solo al plano abierto y se ordena por nombre.
- 3.
Crear o editar un tipo
Pulsa `Nuevo tipo de mesa` o abre un tipo existente. Completa `Nombre`, añade `Descripción` si ayuda al equipo y elige `Color`; el botón `Guardar` del formulario actualiza el borrador local del editor.
- 4.
Asignarlo a mesas
En la pestaña `Mesas`, abre una mesa como `B1` o `B2` y selecciona el valor en `Tipo de mesa`. El color del tipo se refleja como ayuda visual dentro del plano.
- 5.
Retirar un tipo
Usa `Eliminar` y confirma la acción. Al quitar un tipo, las mesas que lo usaban quedan sin `tableTypeId` para evitar referencias inválidas antes del guardado final.
- 6.
Guardar el plano
Pulsa `Guardar` en el editor. En creación se envía `POST /api/app/{orgId}/{locationId}/layouts`; en edición se usa `PUT /api/app/{orgId}/{locationId}/layouts/{layoutId}`. El guardado reemplaza la colección completa de tipos del layout.
Validaciones y límites
- `layout:view` solo permite consulta; las acciones de escritura requieren `layout:manage`.
- No se gestionan tipos en layouts históricos, eliminados o abiertos en solo lectura.
- `name` es obligatorio después de quitar espacios iniciales y finales.
- Los nombres no pueden repetirse dentro del mismo plano, comparando sin distinguir mayúsculas y minúsculas.
- Si `color` queda vacío, el editor aplica `DEFAULT_TABLE_TYPE_COLOR`; no se encontró una validación explícita de formato de color.
- Los tipos son opcionales, pero si una mesa tiene `tableTypeId`, ese tipo debe existir en la colección actual del plano.
- Aunque el cambio sea solo de tipos, el guardado completo también valida nombre del layout, zonas, mesas, capacidades y combinaciones.
- No existe un CRUD independiente para `layout_table_type`; los cambios se persisten solo al guardar el layout completo.
- No documentar capacidad ni forma como propiedades del tipo: el modelo verificado solo guarda nombre, descripción y color.
Resultado esperado
El layout queda guardado con su colección actualizada de `table_types`, las mesas conservan solo referencias válidas y el listado refleja el plano guardado. Si falla una validación, el editor permanece abierto para corregir el borrador.