CKN.Sdk.Data.RepoDb 0.0.0-alpha.0.38

CKN.SDK (Enterprise Agentic Orchestra)

CKN.SDK, 2026 Native AOT standartlarına uygun, modüler, olay güdümlü (event-driven) ve yapay zeka destekli mikroservisler inşa etmek için kullanılan resmi altyapı kütüphanesidir.

Multi-Provider (Çoklu Sağlayıcı) Mimarisi sayesinde, projenizde kullanacağınız veritabanı, mesaj kuyruğu veya yapay zeka sağlayıcısını tek satır kodla değiştirebilirsiniz.

📦 Temel Katmanlar

• CKN.Sdk.Core: Sistemin kalbi. Sıfır bağımlılık. Tüm domain nesneleri, CQRS (ICommand, IQuery) ve temel arayüzler burada yer alır.
• CKN.Sdk.Infrastructure: Ortak HTTP, Güvenlik (JWT), Resiliency ve temel altyapı bileşenleri.
• CKN.Sdk.Tests: Kütüphanenin %100 kapsama sahip unit testlerini barındırır.
• CKN.Sdk.SourceGenerators: Reflection yerine derleme anında DI ve CQRS kodları üreten Roslyn eklentisi.

🧩 Tak-Çalıştır Modüller (NuGet Paketleri)

Projelerinizin ihtiyaçlarına göre sadece ilgili paketi indirerek kullanabilirsiniz:

📬 Mesajlaşma (Messaging)

⚡ Önbellek (Caching)

💾 Veri Erişimi (Data Access)

🤖 Yapay Zeka (AI & LLMs)

☁️ Depolama (Storage)

⏰ Zamanlayıcı (Scheduling)

🔍 Arama (Search)

📚 Gerçek Hayat Kullanım Örnekleri (Dokümantasyon)

Yukarıdaki paketleri projenizde kullanırken appsettings.json yapılandırmalarını nasıl yapacağınızı ve modülleri nasıl DI'a (Dependency Injection) bağlayıp gerçek kod içerisinde kullanacağınızı görmek için aşağıdaki detaylı örneklere göz atabilirsiniz:

• 📬 Messaging (Kafka, RabbitMQ, Service Bus) Örnekleri
• ⚡ Caching (Redis, Memcached, Garnet) Örnekleri
• 💾 Data Access (Dapper, RepoDb) Örnekleri
• 🤖 AI (OpenAI, Anthropic, Ollama, Semantic Kernel) Örnekleri
• ☁️ Storage (Minio, Azure Blob, S3) Örnekleri
• ⏰ Scheduling (Hangfire, Quartz, Coravel) Örnekleri
• 🔍 Search (Elasticsearch, Meilisearch, NRedisStack) Örnekleri

🚀 Hızlı Başlangıç

Örnek bir projede RabbitMQ, Dapper ve Redis kullanmak için terminalden ilgili paketleri yükleyin:

dotnet add package CKN.Sdk.Core
dotnet add package CKN.Sdk.Messaging.RabbitMQ
dotnet add package CKN.Sdk.Data.Dapper
dotnet add package CKN.Sdk.Caching.Redis

Daha sonra Program.cs içerisinde servislerinizi ayağa kaldırın:

using CKN.Sdk.Messaging.RabbitMQ;
using CKN.Sdk.Data.Dapper;
using CKN.Sdk.Caching.Redis;

var builder = WebApplication.CreateBuilder(args);

// Core Servisler
builder.Services.AddCknCore();

// Seçtiğiniz sağlayıcıları (Providers) sisteme dahil edin
builder.Services.AddCknRabbitMQ(opt => builder.Configuration.GetSection("RabbitMQ").Bind(opt));
builder.Services.AddCknDapper(opt => builder.Configuration.GetSection("Database").Bind(opt));
builder.Services.AddCknRedis(opt => builder.Configuration.GetSection("Redis").Bind(opt));

var app = builder.Build();
app.Run();

🏗️ Mimari ve Yönetişim (Governance)

Bu projenin nasıl tasarlandığını, "Zero-Warning Policy" gibi kuralları ve geliştirici standartlarını merak ediyorsanız Governance klasörünü inceleyiniz. Yapay Zeka (AI) ajanları için sistem yönergeleri .agents/ ve governance/docs/architecture/system-glossary.md dosyalarında tanımlıdır.