Cómo ver el detalle de un catálogo
Abre un catálogo existente para revisar su nombre, imagen, productos asociados y orden de tipos de producto. En el demo ES, `Carta Gran Via` de `Marea Gran Via` permite comprobar la composición de la carta; la ficha solo queda editable cuando los permisos y el propietario real del catálogo lo permiten.
En este artículo
El detalle de catálogo ayuda a verificar qué carta usa una ubicación u organización antes de operar en sala. Desde la ficha se consultan los datos principales, la imagen, los productos incluidos y el orden en que se presentan sus tipos.
La misma pantalla sirve para consulta y para edición, pero Antylogic bloquea los controles cuando el usuario solo puede leer, cuando la ruta llega con `readOnly=true` o cuando el catálogo ya está eliminado. Esta guía se centra en revisar el detalle, no en guardar, copiar, borrar ni consultar histórico.
Antes de empezar
- Sesión iniciada en la app con una organización seleccionada (`selectedOrgId`).
- Para abrir el detalle desde ubicación, debe haber una ubicación seleccionada (`selectedLocationId`), por ejemplo `Marea Gran Via`.
- Debe existir un catálogo accesible por `id`; en el runtime ES se puede usar `SETUP_CATALOG_SOURCE_ID=bb01f640-44dc-45e0-b00c-62657160968e` y `SETUP_CATALOG_SOURCE_NAME=Carta Gran Via`.
- El usuario necesita acceso de lectura o gestión en el ámbito activo; la pantalla comprueba `catalog:manage` o `catalog:view`, y el backend de detalle exige `catalog:view`.
- Para revisar la composición de la carta, el catálogo debe tener productos y tipos de producto asociados.
Instrucciones
- 1.
Abre la ficha del catálogo
Entra en la tabla de catálogos de la organización o de la ubicación y selecciona el catálogo que quieres revisar. En el demo ES, abre `Carta Gran Via` desde la configuración de `Marea Gran Via`; la app carga la ficha usando el identificador del catálogo.
- 2.
Revisa los datos principales
Comprueba el campo `Nombre`, el estado `Predeterminado` y la imagen. Estos datos identifican la carta que el equipo usará como referencia y se cargan mediante el endpoint de detalle del ámbito abierto.
- 3.
Consulta los productos incluidos
Desplázate hasta `Productos` para verificar qué artículos forman parte del catálogo. La tabla permite revisar la composición y apoyarse en búsqueda y filtros por tipo, categoría fiscal, alérgeno, especificación y precio.
- 4.
Comprueba el orden de tipos
Revisa `Orden de tipos de producto` para confirmar cómo se agrupan y ordenan entrantes, principales, bebidas o postres. Ese orden se conserva en el catálogo y organiza la navegación por tipos en superficies operativas como el TPV.
- 5.
Identifica si la ficha es editable
Si el usuario tiene `catalog:manage` sobre el propietario real del catálogo, la ficha puede abrirse editable. Si solo tiene lectura, si llega `readOnly=true` o si el catálogo está eliminado, se muestra en modo consulta sin guardado, eliminación, selección de productos ni arrastre de tipos.
Validaciones y límites
- La acción de detalle requiere un `id` efectivo; sin `id`, la pantalla entra en modo creación.
- La UI no lanza la consulta si falta el contexto de organización o ubicación necesario, si no hay `detailSourceId` o si el usuario no tiene acceso al ámbito activo.
- La consulta normal usa `GET /api/app/{orgId}/{locationId}/catalogs/{catalogId}` o `GET /api/app/{orgId}/catalogs/{catalogId}` según el ámbito.
- El backend solo devuelve catálogos de sistema, de la organización activa o de la ubicación activa; los de otros ámbitos se ocultan como no encontrados.
- Los productos asociados llegan como `product_ids` desde `catalog_products` y el orden de tipos como `product_type_ids` desde `catalog_product_types`, ordenado por `sort_order`.
- En solo lectura no se renderiza `Guardar`, no se permite `Eliminar`, se deshabilitan `Nombre`, `Predeterminado` e `Imagen`, se oculta la selección de productos y se desactiva el arrastre de tipos.
- Esta guía no cubre guardado, eliminación, copia ni vista histórica; esas acciones pertenecen a otros flujos.
- Aunque los modelos conservan `icon`, el formulario actual de catálogo no muestra selector de icono.
Resultado esperado
El responsable puede identificar la carta, comprobar su imagen y revisar qué productos y tipos organizan la oferta del local, sabiendo si la ficha es editable o solo consultable según permisos y propietario del catálogo.