Listar planos
Consulta los planos activos de una ubicación, filtra por nombre o versión y revisa mesas, capacidad y acciones disponibles según permisos.
En este artículo
Usa esta guía para entrar en Planos desde una ubicación activa, comprobar qué diseños de sala están disponibles y abrir el plano correcto para revisión o gestión.
En Marea Gran Via, el listado muestra los planos activos de la ubicación y deja la búsqueda y la paginación en la propia pantalla.
Antes de empezar
- Sesión iniciada en Antylogic.
- Organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo > Marea Gran Via.
- Permiso de ubicación `layout:view` para cargar el listado.
- Permiso de ubicación `layout:manage` para ver `Nuevo plano` y las acciones `Editar`, `Copiar` y `Eliminar`.
Instrucciones
- 1.
Abrir Planos
Entra en la pantalla `Planos` de la ubicación activa. Si falta la organización o la ubicación, la pantalla no llama a la API y muestra el estado de plano no encontrado. Si el usuario no tiene permisos de vista ni gestión, muestra el estado de acceso no permitido.
- 2.
Revisar la tabla
Comprueba cada plano por nombre, estado predeterminado, número de mesas, capacidad máxima de comensales y fecha de actualización. Los planos eliminados no aparecen en este listado.
- 3.
Buscar un plano
Usa `Buscar por nombre o versión` para filtrar los planos ya cargados en la pantalla. La búsqueda se normaliza, vuelve a la página 1 y no llama a un endpoint de búsqueda separado.
- 4.
Paginar o refrescar
Usa la paginación cuando haya más planos de los visibles en una página. La pantalla valida `page`, `page_size` y `pageSize`, ajusta páginas fuera de rango y puede refrescar la sección para solicitar de nuevo los planos activos.
- 5.
Gestionar si procede
Con `layout:manage`, la pantalla muestra `Nuevo plano` y acciones de fila para `Editar`, `Copiar` y `Eliminar`. Listar planos no modifica datos; esas operaciones pertenecen a acciones hermanas.
- 6.
Usar la guía
Cuando la ruta incluye `setupGuide=layout`, la pantalla puede mostrar la guía de configuración. La guía abre el plano recomendado si existe o prepara la creación de uno nuevo si el usuario puede gestionar planos.
Validaciones y límites
- El listado está limitado a la ubicación activa y usa `GET /api/app/{orgId}/{locationId}/layouts`.
- El backend exige `layout:view` para cargar los planos, aunque el frontend también permite entrar en la sección con `layout:manage`.
- La búsqueda y la paginación son locales sobre la lista cargada.
- Si no hay planos o el filtro no devuelve resultados, la tabla muestra `Aún no hay planos.`.
- La pantalla no implementa ordenación de columnas ni filtros por estado.
- No se confirmó que la búsqueda por `version` tenga efecto real en el listado actual, porque el backend inspeccionado no expone `version` en el modelo de listado.
Resultado esperado
El equipo puede localizar el plano activo o necesario para la ubicación, revisar su capacidad y abrirlo para continuar con acciones de gestión cuando el rol lo permite.