Ricerca e filtraggio globale

1) Ruolo di ricerca globale

• comprende l'intenzione (entity vs action),
• porta al risultato del click 1-2,
• resistente agli errori di input e ai sinonimi,
• è sicuro e tiene conto dei diritti di accesso.

Principi: relevance> completeness, latency <200 ms fino ai primi suggerimenti, filtri trasparenti e ordinamento.

2) Entità e intenzioni (Intent Model)

• Essenziali: gioco, provider, torneo, rapporto, metodo di pagamento.
• Azioni: «deposito», «output», «creazione report», «invito affiliato».
• Navigazione: portafoglio, profilo, impostazioni.
• Guida: RTP, Limiti, Livelli KYC.

Pattern UX: tipo di risultato contrassegnare con un batch (Gioco/provider/Azione/Aiuto), in alto il tipo più probabile per contesto (paese, ruolo, storia).

3) Punti di ingresso e fattori di forma

La riga del cappello (desktop) + hotkei «⌘/Ctrl + K» apre la tavolozza.
Icona/ricerca in un bar (mobile) è un modal a schermo intero.
Mini-ricerca contestuale: all'interno della directory filtra l'elenco corrente.
«Trova il gioco, il provider o l'azione».

4) Suggerimenti e completamento automatico

Appaiono attraverso 150-250 mc, top-n popolari/recenti.
Le sezioni dei risultati sono «Recenti», «Popolari», «Entità», «Azioni», «Aiuto».
Evidenziazione delle corrispondenze (highlight), diacritica e trasmissione (Pragmatic/Pragmatico).
Supportare gli errori (fuzzy) e i sinonimi (output = withdrawal, cashout).
Keyboard-UX: frecce/invio/Tav; Il mobile ha target grossi.

5) Filtraggio e sfaccettature

• Per i giochi: provider, meccanica (Megaways, cluster), volatilità, RTP, categoria (Live/Slots/Crash), tag.
• Per i rapporti: periodo, operatore, geo, valuta, stato.
• Per azioni/tornei: date, scommesse, partecipanti, premi.

• Filtri chip sopra i risultati (le sfaccettature selezionate sono sempre visibili).
• Multi-select negli elenchi a discesa contatori accanto alle opzioni.
• «Reimposta tutto» e «Salva come preset».
• Sul mobile c'è uno sheet con sfaccettature e il pulsante Mostra risultati.

6) Sintassi avanzata (opzionale)

• `provider:"Pragmatic Play"`, `rtp:>=96`, `volatility:high`
• `type:live`, `tag:"buy bonus"`
• `market:CA currency:CAD`
• Il completamento automatico indica chiavi/valori; gli utenti powers risparmiano tempo.

7) Classificazione (Relevance)

• Precisione corrispondenza (title, alias, sinonimi).
• Popolarità/conversione (kliki→igra/depozit).
• Contesto personale (cronologia, preferiti, recenti).
• Disponibilità per ruolo/giurisdizione.
• Freschezza (nuovi rilasci/promozioni - boost limitato nel tempo).

Visualizzare una spiegazione quando l'ordine viene modificato («Nuovi rilasci entro 7 giorni»).

8) Stati vuoti e di confine

Nessun risultato: suggerisci di togliere/allentare i filtri, di mostrare un collegamento di aiuto popolare nella categoria corrente.
Richiesta di chiarimento troppo generica («categorie»).
Errori di rete: testo offline, retry, salvataggio della riga selezionata.
Limitazioni di accesso: «Non disponibile nella tua regione/ruolo» con CTA Più informazioni.

9) Sicurezza, diritti e compliance

RBAC/Tenenza: indice e risultati solo dallo spazio disponibile.
Geo-guard - Nascondi i mercati/giochi inaccessibili.
Riduzioni PII - Non visualizzare i dati personali nei suggerimenti.
Registro delle richieste (impersonale) per il controllo e il miglioramento della qualità.
Filtrare le richieste di parole chiave proibite (gate di marca, rischi legali).

10) Prestazioni e architettura

Il tempo per i primi indizi è di 200 mc, i primi risultati sono 300-400 mc.
INDICE: aggiornamenti incrementali, dizionari sinonimi, n-gram/edge-ngrams per prefissi.
Memorizza nella cache le richieste e i suggerimenti più comuni.
Debounce 150-250 mc, annullamento di richieste obsolete (abort/timeout).
SSR/streaming per la prima schermata del catalogo; quindi filtrare il client.
Virtualizzazione di elenchi di risultati lunghi.
Indici locali (Web Worker) per il filtro client dei set già caricati.

11) Disponibilità e localizzazione

Il ruolo «combobox »/« listbox», corretti «aria-», la lettura del numero di risultati.
Gestione attiva: torna alla stringa di ricerca, Esc chiude, Invio passa.
RTL Mirare l'ordine dei chip e la posizione delle icone.
Termini e sfaccettature localizzati, formati numerici e valute per regione.

12) Telemetria e metriche

• `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).
• Time-to-Result (primo clic/invio).
• Zero-Result Rate (ZRR) e la percentuale di «vuoti» salvati.
• Facet Adoption %, Preset Adoption %.
• Action Success% (per le intenzioni di deposito, output).
• Latency p95 suggerimenti e rilascio completo.

13) esperimenti A/B

Ordine delle sezioni dei risultati (entità vs azione).
Strategia di classificazione (popolarità vs freschezza).
Griglia/foglio di risultati, numero di suggerimenti.
Varianti di frasi in playsholder/stato vuoto.
Filtri chip in alto vs nel pannello laterale (desktop).

Guardrails: INP/CLS, ZRR, lamentele/errori, perdite RBAC = 0.

14) Pattern script (iGaming)

Trova il gioco: inserisci il nome/provider con suggerimenti (giochi, provider, tag). Sfaccettature: categoria, provider, volatilità, RTP. «Demo», «Gioco».
Le azioni di pagamento sono «deposito», «ritiro». Laurea in portafoglio mantenendo il contesto.
Rapporti operatori: 'ngr', 'arpdau' entità «Report», sfaccettature periodo/operatore/valuta; «Oggi», «La settimana scorsa».
Aiuto/criteri: «RTP», «limiti», «KYC», articolo/FAQ, «contattare la chat».

15) Antipattern

Risultati senza tipo (l'utente non capisce cosa apre).
Suggerimenti di ritardo> 500 ms (l'utente perde il ritmo).
Filtri senza indicazione visibile delle condizioni attive.
Ripristina lo stato all'indietro (perde la riga e le sfaccettature).
Ricerca che restituisce entità senza autorizzazioni e con «accesso non consentito» su un click.
Ignora errori/sinonimi, nessuna trasmissione.

16) Assegno foglio di implementazione (passo passo)

1. Directory entità e azioni (ID, alias, sinonimi, diritti).
2. Indice e classificazione: regole, scorciatoie, busti (freschezza/popolarità).
3. Suggerimenti/Completamento automatico: Debouns, Girasole, Storia/Popolare.
4. Sfaccettature e chip: multi-select, contatori, reimpostazione, preset.
5. Vuoti/errori: testo, alternative, modalità offline.
6. Performance: cache, annullamento delle richieste, virtualizzazione, obiettivi p95.
7. A11u/locale: ruoli ARIA, tastiera, RTL, termini.
8. Telemetria e A/B: qCTR, ZRR, Time-to-Result, esperimenti.
9. Sicurezza: RBAC in indice e rilascio, login di verifica.
10. Documentazione: dizionario di sfaccettatura, esempi di query, hayding per copiare.

17) Totale

1. capisce esattamente l'intenzione e si classifica in base all'utilità

2. Funziona immediatamente (suggerimenti da 200 ms),

3. fornisce sfaccettature trasparenti e salva il contesto,

4. rispetta i diritti/geo e parla un linguaggio comprensibile

5. misura la qualità (qCTR/ZRR/Time-to-Result) e migliora continuamente attraverso A/B.