Búsqueda y filtrado global

1) Función de búsqueda global

• entiende la intención (entity vs action),
• da como resultado un ≤ de 1-2 clics,
• resistente a errores de entrada y sinónimos,
• es seguro y tiene en cuenta los derechos de acceso.

Principios: relevance> completeness, latency <200 ms hasta las primeras sugerencias, filtros transparentes y ordenaciones.

2) Entidades e intenciones (Intent Model)

• Entidades: juego, proveedor, torneo, informe, método de pago.
• Acciones: «depósito», «retiro», «crear un informe», «invitar a un afiliado».
• Navegación: «monedero», «perfil», «configuración».
• Ayuda: «RTP», «límites», «niveles KYC».

Patrón UX: el tipo de resultado marca el bage (Juego/Proveedor/Acción/Ayuda), arriba es el tipo más probable por contexto (país, rol, historia).

3) Puntos de entrada y factores de forma

Línea en el casquillo (desktop) + hotkei '⌘/Ctrl + K' - abre la paleta.
Icono/Búsqueda en la barra de aprox (mobile) - modal de pantalla completa.
Mini búsquedas contextuales: dentro del directorio filtran la lista actual.
Una pista de playsholder: «Encuentra un juego, un proveedor o una acción»....

4) Pistas y autocompletar

Aparecen en 150-250 ms, el top N de los populares/recientes.
Secciones de resultados: «Recientes», «Populares», «Entidades», «Acciones», «Ayuda».
Retroiluminación de coincidencias (highlight), diacrítica y translita (Pragmatic/Pragmático).
Apoye los errores (fuzzy) y sinónimos («salida «= «withdrawal», «cashout»).
Keyboard-UX: flechas/Enter/Nat; en mobile, grandes objetivos.

5) Filtración y facetas

• Para juegos: proveedor, mecánica (Megaways, cluster), volatilidad, RTP, categoría (Live/Slots/Crash), etiquetas.
• Para informes: período, operador, geo, moneda, estado.
• Para promociones/torneos: fechas, apuestas, participantes, premios.

• Filtros de chip sobre los resultados (las facetas seleccionadas siempre están visibles).
• Multi-select en listas desplegables; contadores cerca de las opciones.
• «Restablecer todo» y «Guardar como preset».
• En mobile - sheet con facetas y botón «Mostrar resultados».

6) Sintaxis avanzada (opcional)

• `provider:"Pragmatic Play"`, `rtp:>=96`, `volatility:high`
• `type:live`, `tag:"buy bonus"`
• `market:CA currency:CAD`
• La autocompletación indica las claves/valores; Los usuarios de energía ahorran tiempo.

7) Clasificación (Relevance)

• Precisión de coincidencia (title, alias, sinónimos).
• Popularidad/conversión (kliki→igra/depozit).
• Contexto personal (historia, favoritos, recientes).
• Disponibilidad por roles/jurisdicciones.
• Frescura (nuevos lanzamientos/promociones - boost limitado en el tiempo).

Muestre una explicación cuando cambie de orden («Nuevas versiones arriba dentro de 7 días»).

8) Estados vacíos y fronterizos

Sin resultados: sugerir quitar/aflojar filtros, mostrar popular en la categoría actual, enlace de ayuda.
Consulta demasiado general: pida aclaraciones (mostrar «categorías»).
Errores de red: texto fuera de línea, retry, guardar la línea marcada.
Restricciones de acceso: «No disponible en su área/rol» con CTA «Más información».

9) Seguridad, derechos y cumplimiento

RBAC/tenencia: índice y resultados - sólo del espacio disponible.
Geo-guard: oculta mercados/juegos inaccesibles.
Minimización PII: no extraer datos personales en las pistas.
Registro de consultas (impersonal) para auditar y mejorar la calidad.
Filtre las solicitudes de palabras clave prohibidas (marcas, riesgos legales).

10) Rendimiento y arquitectura

El tiempo hasta las primeras pistas ≤ 200 ms, hasta los primeros resultados ≤ 300-400 ms.
ÍNDICE: actualizaciones incrementales, diccionarios sinónimos, n-gram/edge-ngrams para prefijos.
Almacenamiento en caché de consultas y sugerencias populares.
Debounce 150-250 ms, cancelación de solicitudes obsoletas (abort/timeout).
SSR/streaming para la primera pantalla del catálogo; a continuación, filtrar el cliente.
Virtualización de listas de resultados largas.
Índices locales (Web Worker) para el filtrado de clientes de conjuntos ya cargados.

11) Disponibilidad y localización

Rol 'combobox '/' listbox', correcto 'aria-', lectura del número de resultados.
Control de enfoque: volver a la barra de búsqueda, Nat - cerrar, Enter - ir.
RTL: espeje el orden de los chips y la posición de los iconos.
Los términos y facetas están localizados, los formatos numéricos y las monedas están por región.

12) Telemetría y métricas

• `search_open`, `search_type` (entity/action), `suggest_impression/click`,
• `query_submit`, `facet_apply/remove`, `preset_save/apply`,
• `result_click` (rank, id), `no_results`, `latency_ms`.

• Query → Result Click-Through (qCTR).
• Tiempo-a-Resultado (primer clic/Enter).
• La Tasa de Resultados Cero (ZRR) y la proporción de «vacíos» rescatados.
• Facet Adoption %, Preset Adoption %.
• Acción Éxito% (para intenciones de «depósito», «retiro»).
• Latency p95 pistas y emisión completa.

13) Experimentos A/B

Orden de las secciones de resultados (entidad vs acción).
Estrategia de clasificación (popularidad vs frescura).
Cuadrícula/hoja de resultados, número de sugerencias.
Opciones de frases en playsholder/estado vacío.
Filtros de chip en la parte superior vs en la barra lateral (escritorio).

Guardrails: INP/CLS, ZRR, quejas/errores, fugas RBAC = 0.

14) Patrones por script (iGaming)

Encontrar el juego: escribir un nombre/proveedor → consejos (juegos, proveedores, etiquetas). Facetas: categoría, proveedor, volatilidad, RTP. Acción rápida: «Demo», «Juega».
Acciones de pago: 'depósito', 'retiro' → acciones primero. Diplink en la cartera con la preservación del contexto.
Informes del operador: 'ngr', 'arpdau' → entidades 'Informes', facetas período/operador/moneda; presets: «Hoy», «Semana pasada».
Ayuda/políticas: 'RTP', 'limites', 'KYC' → artículos/FAQ, 'chatear'.

15) Antipattern

Resultados sin tipos (el usuario no entiende lo que abre).
Pistas de latencia> 500 ms (el usuario «pierde ritmo»).
Filtros sin indicación aparente de condiciones activas.
Restablece el estado al «atrás» (se pierden la cadena y las facetas).
Una búsqueda que devuelve entidades sin derechos y con «acceso prohibido» por clic.
Ignorando los errores tipográficos/sinónimos, sin translita.

16) Lista de verificación de implementación (paso a paso)

1. Directorio de entidades y acciones (ID, alias, sinónimos, derechos).
2. Índice y clasificación: reglas, escoups, bustos (frescura/popularidad).
3. Pistas/autocompletar: debouns, retroiluminación, historia/popular.
4. Facetas y chips: multi-select, contadores, «reset», presets.
5. Vacíos/errores: textos, alternativas, modo offline.
6. Rendimiento: caché, cancelación de consultas, virtualización, objetivos p95.
7. A11u/local: roles ARIA, teclado, RTL, términos.
8. Telemetría y A/B: qCTR, ZRR, Tiempo-a-Resultado, experimentos.
9. Seguridad: RBAC en índice y emisión, registros de auditoría.
10. Documentación: diccionario de facetas, consultas de ejemplo, guiding para el copyright.

17) Resultado

1. entiende exactamente la intención y clasifica por utilidad,

2. trabaja instantáneamente (pistas ≤ 200 ms),

3. da facetas transparentes y conserva el contexto,

4. respeta los derechos/geo y habla un lenguaje comprensible,

5. mide la calidad (qCTR/ZRR/Tiempo-a-Resultado) y mejora constantemente a través de A/B.