ApienFTS 1.0.0.1

🔍 Apien.Search

.NET için ultra hızlı full-text arama motoru. Tantivy seviyesinde performans, minimal bellek kullanımı.

🚀 Performans Metrikleri

📦 Kurulum

dotnet add package Apien.Search

⚡ Hızlı Başlangıç

DI ile Kullanım (Önerilen)

// Program.cs
builder.Services.AddApienSearch(builder.Configuration);

// appsettings.json
{
  "ApienSearch": {
    "DataPath": "./search-data",
    "DefaultSize": 20,
    "MaxSize": 10000
  }
}

// Index Service
public class ProductIndexService(IApienIndexer indexer)
{
    public async Task CreateIndex()
    {
        await indexer.CreateIndexAsync<Product>("products", m => m
            .Keyword(p => p.ProductId)
            .Text(p => p.PartName, boost: 3.0f)
            .Text(p => p.PartNameTr, boost: 3.0f)
            .TextArray(p => p.OemNumbers, boost: 5.0f)
            .TextArray(p => p.VehicleModels, boost: 2.0f)
        );
    }

    public async Task IndexProducts(IEnumerable<Product> products)
    {
        await indexer.BulkAsync("products", products, p => p.ProductId);
    }
}

// Search Service
public class ProductSearchService(IApienSearch search)
{
    public async Task<SearchResult<Product>> Search(string query)
    {
        var request = new TypedSearchRequestBuilder<Product>()
            .Query(q => q.MultiMatch(query, 
                p => p.PartName, 
                p => p.OemNumbers, 
                p => p.VehicleModels))
            .SortByScore()
            .Size(20)
            .Build();
        
        return await search.SearchAsync<Product>("products", request);
    }
}

Doğrudan Kullanım

using Apien.Search;

// Client oluştur
await using var client = new SearchClient("./search-data");

// Strongly-typed mapping ile index tanımla
await client.Indices.CreateAsync("products", c => c
    .Map<Product>(m => m
        .Keyword(p => p.ProductId)
        .Text(p => p.PartName, boost: 3.0f)
        .Text(p => p.PartNameTr, boost: 3.0f)
        .TextArray(p => p.OemNumbers, boost: 5.0f)
        .TextArray(p => p.VehicleModels, boost: 2.0f)
    ));

// Doküman indexle (65K+ doc/s)
await client.BulkAsync("products", products);

// Ara (sub-millisecond)
var results = await client.SearchAsync<Product>("products", "bosch fren");

foreach (var hit in results.Hits.Hits)
{
    Console.WriteLine($"{hit.Source?.PartName} - Skor: {hit.Score}");
}

✨ Özellikler

Sorgu Tipleri

• 🔍 Match - Tam kelime eşleşmesi (case insensitive)
• 🔤 Prefix - Ön ek araması (pass → passat) - O(log n) binary search
• 🎯 Term - Exact match (filtreleme için)
• 📋 Terms - Çoklu değer araması
• 🌟 Wildcard - Pattern matching (*sat*, pass*)
• 🔮 Fuzzy - Yazım hatası toleransı (Levenshtein)
• 📊 Range - Sayısal aralık sorguları
• ✅ Exists - Alan varlık kontrolü
• 🔗 Bool - AND/OR/NOT kombinasyonları
• 🎚️ MultiMatch - Birden fazla alanda arama
• ⚡ FunctionScore - Custom skorlama fonksiyonları

Teknik Özellikler

• 🔥 Tantivy seviyesi performans - P99 < 2ms
• 💾 Minimal bellek - ~170MB / 1M doküman
• 🔤 Çoklu dil desteği - Türkçe, Almanca, Fransızca, Lehçe, Romence, Macarca
• 📦 Array field araması - Tags, kategoriler, çoklu değerler
• 🚀 SIMD tokenization - AVX2 hızlandırmalı
• 🔒 Thread-safe - Eşzamanlı arama desteği
• 📁 Memory-mapped dosyalar - OS tarafından yönetilen cache
• ⚡ Binary search - O(log n) prefix/range sorguları
• 🧠 Token cache - Tekrarlı posting list okumayı önleme
• 🔄 ArrayPool - Bellek yeniden kullanımı

DI Interface'leri

• 📥 IApienIndexer - Index ve doküman yönetimi
• 🔎 IApienSearch - Arama işlemleri
• 🔧 ISearchClient - Legacy uyumluluk

📖 Dokümantasyon

Detaylı kullanım kılavuzu için: docs/API-REFERENCE.md

🆚 Karşılaştırma

🔧 Yapılandırma

// appsettings.json
{
  "ApienSearch": {
    "DataPath": "./search-data",
    "DefaultSize": 20,
    "MaxSize": 10000,
    "EnableMetrics": false,
    "DocumentCacheSize": 10000,
    "MaxPostingsPerToken": 10000,
    "ViewPoolSize": 128
  }
}

// Program.cs
builder.Services.AddApienSearch(builder.Configuration);

// Veya manuel yapılandırma
builder.Services.AddApienSearch(options =>
{
    options.DataPath = "./search-data";
    options.DefaultSize = 20;
    options.MaxSize = 10000;
});

🎯 Kullanım Senaryoları

E-Ticaret Ürün Araması

var request = new TypedSearchRequestBuilder<Product>()
    .Query(q => q.Bool(b => b
        .Must(inner => inner.MultiMatch(query, m => m
            .Field(p => p.Name, BoostLevel.High)
            .Field(p => p.Description)
            .Field(p => p.Brand, BoostLevel.Medium)
            .Fuzziness(Fuzziness.High)
        ))
        .Range(p => p.Stock, r => r.Gt(0))  // Stokta olanlar
    ))
    .SortByScore()
    .Highlight(p => p.Name, p => p.Description)
    .Aggregations(a => a
        .Terms("brands", p => p.Brand, 20)
        .Range("priceRanges", p => p.Price, r => r
            .Range(null, 100, "Ucuz")
            .Range(100, 500, "Orta")
            .Range(500, null, "Pahalı")
        )
    )
    .Page(1, PageSize.Default)
    .Build();

OEM Numarası Araması

var request = new TypedSearchRequestBuilder<Product>()
    .Query(q => q.Bool(b => b
        .Should(p => p.OemNumbers, oemNumber, BoostLevel.Extreme)  // Exact match
        .Should(inner => inner.Prefix(p => p.OemNumbers, oemNumber, BoostLevel.High))
        .MinimumShouldMatch(1)
    ))
    .Size(50)
    .Build();

Autocomplete

var request = new TypedSearchRequestBuilder<Product>()
    .Query(q => q.Prefix(p => p.Name, prefix))
    .SuggestCompletion("suggestions", p => p.Name, prefix, size: 10, fuzzy: true)
    .Size(5)
    .Build();

📄 Lisans

MIT License