Vista previa del modal — vista previa del bloque en el modal
PreviewModal — un modal común para todas las pantallas de configuración de Wave-2, que muestra el resultado del bloque en tiempo real. Se abre con el botón «Abrir en modal» en las pantallas de configuración.
¿Para qué sirve?
Cuando configuras un bloque (estrategia, filtros, audiencia) — quieres entender de inmediato qué productos aparecerán en los resultados con esas configuraciones. PreviewModal permite verificar esto sin publicar el bloque en el sitio y sin cambiar entre el panel de administración y el frontend.
Pestaña Básica — lista de productos
La primera pestaña — Básica. Muestra una tabla de productos que devolverá la API con la configuración actual del bloque:
- La carga se realiza mediante scroll infinito a través del componente
NewBlockPreviewTable. - En la tabla — vista previa de las tarjetas (nombre, imagen, marcador, metadatos breves).
- La lista se actualiza automáticamente al cambiar la configuración del bloque en la pantalla principal.
Pestaña Investigar — diagnóstico
La segunda pestaña — Investigar — es necesaria para la depuración. Aquí se puede ver lo que ocurrió "bajo el capó" al generar los resultados:
| Campo | Qué significa |
|---|---|
| appliedAudienceRule | Qué regla de audiencia se activó para la solicitud actual. Ver Filtro de Audiencia. |
| warnings | Diagnóstico — por ejemplo, "el conjunto de atributos está vacío", "el fallback seleccionó productos que no están en la categoría elegida". |
| fallbackUsed | Indicador: si se activó la ruta de fallback (muestra de productos de tendencia). |
| contextEcho | Eco del contexto de la solicitud — lo que el sistema realmente recibió (ID de usuario, carrito, categorías seleccionadas, etc.). |
Si el backend no devolvió algún campo — la sección correspondiente de Investigar simplemente se oculta, sin errores. Esto se hace para un desarrollo sin problemas de la API.
ID de usuario simulado — vista previa "en nombre" del usuario
Bajo el campo Vista previa hay un input ID de usuario simulado. Introduce el ID de cualquier usuario — la vista previa construirá el resultado como si la solicitud viniera de él. Es útil para:
- Verificar recomendaciones personalizadas (Recomendaciones personales, Compra repetida) para un cliente específico;
- Reproducir una queja del tipo "en mi bloque no están los productos correctos" — introduce su ID y mira lo que él verá.
Sin especificar el ID de usuario simulado, la vista previa utiliza tu propio contexto de administrador, y para bloques personalizados, los resultados pueden estar vacíos o ser irrelevantes.
Derecho de acceso blocks.preview
El acceso al endpoint de administración de la vista previa del bloque está controlado por un derecho separado blocks.preview en el árbol de derechos.
Esto permite:
- Dar un rol que edita bloques, sin acceso a la vista previa (por ejemplo, para gerentes de contenido "solo-forma").
- Ocultar de algunos administradores datos sensibles que pueden revelarse a través de Investigar (contexto de la solicitud, eco de parámetros).
Para desarrolladores y QA — siempre otorgar blocks.preview. Para gerentes de contenido — solo si deben ver la salida real del bloque antes de la publicación.