Om een Typesense-zoekoplossing te ontwerpen die complexe zoekopdrachten met logische operatoren zoals AND, OR en NOT ondersteunt, moet je een gestructureerde aanpak volgen. Hieronder vind je een plan met configuratie-aanbevelingen, query-voorbeelden en best practices. **1. Dataset en Velden definiëren** - Velden: naam, categorie, prijs, voorraad, publicatiedatum, auteur - Velden die gezocht moeten worden: bijvoorbeeld categorie, publicatiedatum, auteur - Velden die gefilterd worden: bijvoorbeeld publicatiedatum, categorie, auteur **2. Typesense Index Configuratie** - **Schema ontwerp:** ```json { "name": "producten", "fields": [ {"name": "naam", "type": "string"}, {"name": "categorie", "type": "string", "facet": true}, {"name": "prijs", "type": "float"}, {"name": "voorraad", "type": "int"}, {"name": "publicatiedatum", "type": "int", "facet": true}, {"name": "auteur", "type": "string", "facet": true} ], "default_sorting_field": "naam" } ``` - **Facetten instellen:** Door velden zoals 'categorie', 'publicatiedatum', en 'auteur' als facetten te markeren, kun je filteren en combineren met logische operatoren. - **Zoekbare velden:** Zorg dat de tekstvelden zoals 'naam' en 'auteur' voor volledige tekstzoekopdrachten gebruikt kunnen worden, en dat de datums en categorieën als facetten beschikbaar zijn. **3. Ondersteuning voor complexe logische zoekopdrachten** Typesense ondersteunt niet direct complexe logische expressies zoals `(categorie:technologie AND publicatiedatum:>2019) OR (categorie:wetenschap NIET auteur:'Jansen')` in één zoekquery. Maar je kunt dit simuleren door: - **Gebruik van filters:** Voor datagestuurde criteria (`categorie`, `publicatiedatum`, `auteur`). - **Gebruik van zoekopdrachten en filters in één API-aanroep:** Voorbeeld: Zoek naar producten die voldoen aan de volgende logica: - (categorie:technologie en publicatiedatum > 2019) - of - (categorie:wetenschap en niet auteur:'Jansen') **4. Query-voorbeelden** Omdat Typesense geen native ondersteuning biedt voor complexe logische operatoren in één query, moet je dit splitsen in meerdere queries en de resultaten combineren, of gebruik maken van filters: ```bash # Voorbeeld 1: (categorie:technologie AND publicatiedatum:>2019) search_params: { q: "", query_by: "naam", filter_by: "categorie:technologie && publicatiedatum:>2019" } # Voorbeeld 2: (categorie:wetenschap AND NOT auteur:'Jansen') search_params: { q: "", query_by: "naam", filter_by: "categorie:wetenschap && -auteur:'Jansen'" } ``` **5. Combineren van resultaten** - Voer aparte zoekopdrachten uit en combineer de resultaten in je applicatielogica. - Of, als je complexe logica wilt, creëer vooraf samengestelde filters of zoekopdrachten die jouw logica benaderen. **6. Best practices** - **Gebruik facetten en filters:** Door velden als facetten te markeren, kun je snel filteren en combineren. - **Zoekvelden optimaliseren:** Gebruik 'query_by' voor tekstzoekopdrachten, en 'filter_by' voor criteria. - **Splits complexe logica:** Omdat Typesense geen nested logische expressies ondersteunt, verdeel complexe queries in meerdere eenvoudige queries en combineer de resultaten. - **Indexering:** Zorg dat je relevante velden indexeert en dat je regelmatig je schema en facetten optimaliseert. - **Preprocessing:** Overweeg om in je data pre-filters of tags toe te voegen die complexe logica makkelijker maken. **7. Alternatief: Gebruik een query builder en post-processing** Je kunt in je applicatielaag een eenvoudige parser voor logische operators bouwen, die de query omzet in meerdere Typesense-queries en de resultaten combineert volgens de logica. --- **Samenvatting** - Configureer je schema met relevante velden als facetten. - Gebruik filters voor datagebaseerde criteria. - Voer meerdere queries uit voor complexe logica en combineer resultaten in je applicatie. - Overweeg het bouwen van een logische parser om gebruikersvriendelijke zoekopdrachten te ondersteunen. Door deze aanpak te volgen, bouw je een flexibele en krachtige zoekoplossing met Typesense die complexe logische zoekopdrachten aankan.

Hier is een uitgebreid plan voor het implementeren van geavanceerde zoekfunctionaliteit in Typesense met logische operatoren: ## 1. Typesense Configuratie ### Schema Definitie ```json { "name": "producten", "fields": [ {"name": "naam", "type": "string", "facet": false}, {"name": "categorie", "type": "string", "facet": true}, {"name": "prijs", "type": "float", "facet": true}, {"name": "voorraad", "type": "int32", "facet": true}, {"name": "publicatiedatum", "type": "string", "facet": true}, {"name": "auteur", "type": "string", "facet": true}, {"name": "beschrijving", "type": "string", "facet": false} ], "default_sorting_field": "publicatiedatum" } ``` ## 2. Query Syntax en Logische Operatoren ### Basis operatoren in Typesense: - **EN (AND)**: `&&` of impliciet met spaties - **OF (OR)**: `||` - **NIET (NOT)**: `!` ### Geavanceerde filters: - `:=` exacte match - `:>` groter dan - `:<` kleiner dan - `:>=` groter dan of gelijk aan - `:<=` kleiner dan of gelijk aan ## 3. Query Voorbeelden ### Jouw voorbeelden geïmplementeerd: **Voorbeeld 1:** ```javascript // (categorie:technologie AND publicatiedatum:>2019) OF (categorie:wetenschap NIET auteur:'Jansen') { "q": "*", "filter_by": "(categorie:technologie && publicatiedatum:>2019-12-31) || (categorie:wetenschap && !auteur:Jansen)" } ``` **Complexe voorbeelden:** ```javascript // Technologie producten met voorraad, gepubliceerd na 2020 { "q": "*", "filter_by": "categorie:technologie && voorraad:>0 && publicatiedatum:>2020-01-01" } // Boeken over wetenschap OF technologie, maar niet van specifieke auteurs { "q": "*", "filter_by": "(categorie:wetenschap || categorie:technologie) && !auteur:[Jansen, Pieters]" } // Producten in prijscategorie met voorraad { "q": "*", "filter_by": "prijs:>=50 && prijs:<=200 && voorraad:>5" } ``` ## 4. Best Practices en Optimalisatie ### Schema optimalisatie: ```json { "token_separators": [",", ".", "!", "?", ";", ":", "(", ")"], "symbols_to_index": ["&", "|", "!", ">", "<", "=", "-"], "enable_nested_fields": false } ``` ### Performance tips: 1. **Gebruik facetten voor filterbare velden** 2. **Indexeer alleen noodzakelijke velden** 3. **Implementeer paginatie voor grote resultaten** 4. **Cache veelgebruikte queries** ## 5. Implementatie Code Voorbeelden ### Node.js implementatie: ```javascript const typesense = require('typesense'); const client = new typesense.Client({ nodes: [{ host: 'localhost', port: '8108', protocol: 'http' }], apiKey: 'jouw-api-key' }); // Geavanceerde zoekfunctie async function geavanceerdZoeken(query, filters) { const searchParameters = { q: query, filter_by: filters, query_by: 'naam,beschrijving,categorie', facet_by: 'categorie,auteur,publicatiedatum', per_page: 20 }; return await client.collections('producten').documents().search(searchParameters); } // Gebruik: const resultaat = await geavanceerdZoeken('*', '(categorie:technologie && publicatiedatum:>2020) || (categorie:wetenschap && !auteur:Jansen)' ); ``` ## 6. Foutafhandeling en Validatie ```javascript function valideerFilter(filterString) { // Valideer syntax const verbodenKarakters = /[^a-zA-Z0-9\s:><!='&|()_-]/; if (verbodenKarakters.test(filterString)) { throw new Error('Ongeldige karakters in filter'); } return filterString; } ``` ## 7. Monitoring en Debugging ### Logging implementeren: ```javascript // Query logging console.log('Typesense Query:', { filter: searchParameters.filter_by, timestamp: new Date().toISOString(), resultCount: resultaat.found }); ``` ## 8. Veiligheidsmaatregelen 1. **Input sanitization** voor alle gebruikersinvoer 2. **Query timeouts** instellen 3. **API rate limiting** implementeren 4. **Foutmeldingen** zonder gevoelige informatie Deze configuratie ondersteunt complexe logische operaties terwijl het optimale prestaties behoudt. Test je queries grondlijk met verschillende datasets om de gewenste resultaten te garanderen.