Kck.Exceptions.Abstractions 3.2.0

Kck Modular Architecture Framework

Modular, extensible .NET framework organized around an Abstractions → Providers → Bundles pattern. Abstractions declare contracts; providers implement them against concrete technologies; bundles compose opinionated defaults for specific hosting models (WebApi, WorkerService, etc.).

Quick Start

Web API (ASP.NET Core, full Bundle)

dotnet add package Kck.Bundle.WebApi

var builder = WebApplication.CreateBuilder(args);

builder.Services
    .AddKckWebApi()
    .AddKckCachingInMemory()
    .AddKckMessagingMailKit(opt =>
    {
        opt.Host = builder.Configuration["Mail:Host"]!;
        opt.Port = 587;
        opt.UseSsl = true;
    });

var app = builder.Build();
app.UseKckExceptionHandler();
app.MapGet("/", () => Results.Ok("Hello from Kck!"));
app.Run();

Tam ornek: samples/Kck.Sample.WebApi

Minimal API (Slim, only what you need)

dotnet add package Kck.AspNetCore
dotnet add package Kck.Caching.InMemory
dotnet add package Kck.Pipeline.Mediator

var builder = WebApplication.CreateBuilder(args);

builder.Services
    .AddKckExceptions()
    .AddKckCachingInMemory()
    .AddMediator()                          // Mediator source-gen dispatcher
    .AddKckMediatorPipeline(p => p
        .UseValidationBehavior()
        .UseLoggingBehavior());

var app = builder.Build();
app.MapPost("/users", async (CreateUserCommand cmd, IMediator mediator) =>
    Results.Ok(await mediator.Send(cmd)));
app.Run();

Tam ornek: samples/Kck.Sample.MinimalApi

Worker Service (background jobs, no HTTP)

dotnet add package Kck.BackgroundJobs.Quartz
dotnet add package Kck.Logging.Serilog
dotnet add package Kck.Observability.OpenTelemetry

var builder = Host.CreateApplicationBuilder(args);

builder.Services
    .AddKckSerilog(builder.Configuration)
    .AddKckOpenTelemetry()
    .AddKckQuartz(opt => opt.UseInMemoryStore())
    .AddKckJob<EmailDigestJob>(triggerCron: "0 0 9 * * ?");

await builder.Build().RunAsync();

Tam ornek: samples/Kck.Sample.WorkerService

Target Frameworks

Kütüphane yalnızca net10.0 ve üzerini hedefler (ADR-0019). Detay: ADR-0019.

Why Kck?

Kck, ABP'den daha hafif, FastEndpoints'ten daha kapsamli, Aspire'a uyumlu olmayi hedefler:

Kck'i secmen gerekiyorsa eger:

• ASP.NET Core'a sadik kalmak istiyorsan (DI, options, hosting konvansiyonlari)
• Modul modul ekleme/cikarma yetkisi istiyorsan (ABP'nin "her sey otomatik" yaklasimini istemeyen)
• Source-gen veya runtime proxy magic'inden kaciniyorsan (debug edilebilirlik onemliyse)
• Modern .NET 10 API'larını (AOT, Guid.CreateVersion7()) tam destekleyen framework istiyorsan
• 9+ ADR + 17 provider doc + 0 warning build hijiyenine deger veriyorsan

Kck'i secmemen gerekiyorsa:

• "Tek paket kurar tum ihtiyacim biter" istiyorsan → ABP
• Yalniz HTTP endpoint API yaziyorsan → FastEndpoints daha hafif
• Microservice orchestration istiyorsan → Aspire (Kck ile birlikte de calisir)

Modules

Abstractions

Providers

Background Jobs ipucu: Hangfire ve Quartz alternatiftir, beraber kullanilmasi onerilmez. Hangfire dashboard ve persistent storage ihtiyaciniz varsa onu, daha hafif cron + DI entegrasyonu istiyorsaniz Quartz'i secin. Ikisi birden bagimliliklarinizi gereksiz sisirir (~5MB+ assembly farki).

Bundles

Samples

• samples/Kck.Sample.WebApi — Full WebApi sample with RabbitMQ, Redis, EF Core
• samples/Kck.Sample.MinimalApi — Minimal API with Bundle.WebApi
• samples/Kck.Sample.WorkerService — Hangfire + Quartz hosted jobs

Testing

# Unit testler (Docker gerektirmez, Windows + Ubuntu hepsi):
dotnet test --filter "Category!=Integration"

# Integration testler (Docker Desktop gerekir):
dotnet test --filter "Category=Integration"

Detay: docs/test-strategy.md ve docs/policies/test-coverage.md

Documentation

• Documentation index — landing page
• Architecture Decision Records — binding technical decisions
• Provider guides — per-category usage notes (17 guides)

Development

dotnet restore
dotnet build -c Release
dotnet test -c Release --no-build

Requirements: .NET 10 SDK

Benchmarks

dotnet run -c Release --project tests/Kck.Benchmarks

BenchmarkDotNet --filter ile spesifik benchmark calistir:

dotnet run -c Release --project tests/Kck.Benchmarks -- --filter "*Paginate*"

Sadece Release konfigurasyonunda anlamli sonuc verir; Debug uyari ile kosur.

Contributing

See CONTRIBUTING.md. Issues and PRs are welcome.

License

MIT © Omerkck