Zoeken toevoegen aan je app: van eenvoudige filters tot full-text search

Om zoeken aan je app toe te voegen, begin je met het eenvoudigste dat werkt: een zoekvak dat een serverroute aanroept, die je databaserijen filtert door de zoekterm op een paar kolommen te matchen, plus filters voor zaken als categorie of prijs. Als dat niet genoeg is, omdat je relevantie-rangschikking, woordstammen of veel records nodig hebt, schakel je over op full-text search van je database. Alleen als je sterke tolerantie voor typefouten of directe resultaten over zeer grote hoeveelheden data nodig hebt, ga je naar een gehoste zoekmachine. Wat je ook kiest: zoeken moet rechten respecteren. Gebruikers mogen nooit records vinden die ze niet mogen zien.

Wat "zoeken" betekent voor je app

Zoeken omvat een paar verschillende dingen, en de meeste apps hebben er meer dan één nodig:

• Zoeken op trefwoord: een tekstvak, bijvoorbeeld "vermeldingen met 'tuin'".
• Filters: gestructureerde keuzes zoals categorie, stad, prijsklasse, datum of status.
• Sorteren: nieuwste, goedkoopste, meest relevant.
• Autocomplete: suggesties terwijl je typt.
• Tolerantie voor typefouten: "restarant" vindt nog steeds "restaurant".

Voor een directory, vacaturesite of winkel zijn filters vaak belangrijker dan het tekstvak. Bepaal welke van deze je echt nodig hebt voordat je een tool kiest.

Je opties

Als je data al in Postgres staat, is de ingebouwde full-text search een sterk tussenweg. Die splitst tekst in woorden, herleidt ze tot stammen (zodat "lopen" bij "loop" hoort), negeert veelvoorkomende woorden, en kan resultaten rangschikken op hoe goed ze passen. Met de juiste index blijft het snel op grote tabellen.

Voorbeeldprompts

Een eenvoudige start:

Voeg een zoekvak en filters toe aan de advertentiepagina. Zoeken moet de zoekterm matchen op titel en beschrijving, hoofdletterongevoelig. Filters: categorie (dropdown), stad (dropdown) en maximale prijs. Doe het zoeken op de server met een gepagineerde API-route, 20 resultaten per pagina. Houd zoekterm en filters in de URL zodat resultaten gedeeld kunnen worden en de terugknop werkt. Toon een vriendelijke lege staat als niets matcht.

Overstappen naar full-text search:

Zet de zoekfunctie voor advertenties om naar Postgres full-text search op titel (zwaarder gewogen) en beschrijving. Voeg de juiste index toe, rangschik resultaten op relevantie, en behoud de bestaande filters en paginering. Verander geen bestaande data.

Tolerantie voor typefouten bij namen toevoegen:

Voeg fuzzy matching toe op de bedrijfsnaam, zodat kleine typefouten nog resultaten opleveren. Gebruik trigram-gelijkenis als die beschikbaar is, met een index, en val terug op de huidige zoekfunctie als dat niet kan.

Stap voor stap

1. Maak een lijst van wat mensen zoeken. Welke velden (titel, beschrijving, tags, naam)? Welke filters? Vraag, als het kan, een paar echte gebruikers.
2. Begin op de server. Voeg een API-route toe die de zoekterm en filters neemt, en één pagina resultaten teruggeeft. Laad niet alles in de browser.
3. Pas rechten toe in de query. Als gebruikers alleen hun eigen records of alleen gepubliceerde records zien, hoort die voorwaarde in dezelfde query als de zoekopdracht.
4. Voeg paginering toe vanaf de eerste dag: paginanummers of "meer laden".
5. Zet de zoekstatus in de URL (bijvoorbeeld ?q=tuin&city=leeds). Dan zijn links deelbaar, werkt de terugknop, en kunnen zoekmachines gefilterde pagina's crawlen als je dat wilt.
6. Vertraag zoeken terwijl je typt (debounce). Wacht een paar honderd milliseconden nadat je stopt met typen voordat je zoekt, zodat je niet bij elke toetsaanslag een verzoek stuurt.
7. Voeg indexen toe zodra je weet op welke kolommen je filtert en zoekt.
8. Upgrade naar full-text search, dan fuzzy matching, dan een gehoste zoekmachine, maar alleen als de eenvoudigere stap echte gebruikers niet genoeg helpt.
9. Test met realistische data: honderden of duizenden rijen, rare tekens, lege zoektermen, zeer lange zoektermen, andere talen als je die ondersteunt.

Veelgemaakte fouten

• De hele tabel in de browser laden. Prima bij 50 items, pijnlijk bij 50.000, en het toont elk record, ook de records die de gebruiker niet mag zien.
• Zoeken dat rechten negeert. Zoeken is een veelvoorkomend lek: een privé- of conceptrecord duikt op omdat de zoekquery de voorwaarde "alleen van mij" of "alleen gepubliceerd" vergat.
• SQL bouwen met ruwe gebruikersinvoer. Gebruik altijd geparametriseerde queries. Een AI-builder doet dat meestal, maar controleer of er strings aan elkaar worden geplakt.
• Geen lege staat. "Geen resultaten" met een suggestie (filters wissen, spelling controleren) houdt mensen tegen om weg te gaan.
• Geen indexen. Zoeken voelt prima met testdata en wordt trager naarmate de echte data groeit.
• Meteen naar een zoekdienst springen. Dan moet je een tweede kopie van je data synchroon houden, verwijderingen afhandelen en nog een set sleutels beveiligen, vaak zonder zichtbaar voordeel.
• Mobiel vergeten. Filters moeten op een telefoon passen; een filterlade of inklapbaar paneel werkt meestal beter dan een zijbalk.

Checklist

• Je weet welke velden doorzocht worden en welke filters er zijn
• Zoeken draait op de server en geeft gepagineerde resultaten terug
• De query past dezelfde rechten toe als de rest van de app
• Gebruikersinvoer wordt als parameter doorgegeven, nooit in SQL geplakt
• Zoekstatus staat in de URL
• Typen wordt vertraagd (debounce)
• Doorzochte en gefilterde kolommen zijn geïndexeerd
• Lege, geen-resultaten- en foutstatussen zijn duidelijk
• Getest met realistische datavolumes en rommelige invoer

Zoeken toevoegen met Mythex

In een app die op Mythex is gebouwd staat de data meestal in de Postgres-database van het project. Je kunt dus starten met de prompts hierboven: eerst patroonmatching, en full-text search van Postgres zodra je rangschikking nodig hebt. Als je een gehoste zoekmachine wilt, neem je je eigen account en sleutel mee, sla je die op als projectgeheim, en vraag je de agent om te indexeren en op de server te zoeken, zoals beschreven in Integreer elke API.

Zoeken is de kern van veel apps. Zie hoe bouw je een directorywebsite, hoe bouw je een vacaturesite en hoe bouw je een marktplaats om te zien hoe zoeken in het geheel van het product past.

Veelgestelde vragen