Levge.Tenancy 2.3.0

Levge.Tenancy

.NET 10 SaaS uygulamaları için çok kiracılı (multi-tenant) altyapı paketi.
JWT claim tabanlı tenant çözümleme, EF Core Global Query Filter ve tenant yaşam döngüsü yönetimi.

İçindekiler

• Kurulum
• Hızlı Başlangıç
• TenantBase — Kendi Tenant Entity'ni Oluştur
• DbContext Entegrasyonu
• ITenantContext
• ITenantService
• Global Query Filter
• TenantStatus
• Bağımlılıklar

Kurulum

dotnet add package Levge.Tenancy
dotnet add package Levge.Identity

Hızlı Başlangıç

// Program.cs
builder.Services
    .AddLevgeIdentity(jwtConfig)
    .AddLevgeTenancy<AppDbContext, Tenant>();

app.UseAuthentication();
app.UseAuthorization();

TenantBase — Kendi Tenant Entity'ni Oluştur

TenantBase'den türet, ihtiyacına göre alan ekle:

public class Tenant : TenantBase
{
    public string? LogoUrl { get; set; }
    public string? WebsiteUrl { get; set; }
    // İleride: public long? PlanId { get; set; }  ← Levge.Subscription için
}

TenantBase şu alanları yerleşik olarak içerir:

DbContext Entegrasyonu

Seçenek A — LevgeTenantDbContext'ten türet

public class AppDbContext : LevgeTenantDbContext<Tenant>
{
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }

    public DbSet<Order> Orders { get; set; } = null!;
}

Seçenek B — Mevcut hiyerarşiye ekle (IdentityDbContext, LevgeAuditDbContext vb.)

public class AppDbContext : LevgeAuditDbContext, ITenantDbContext<Tenant>
{
    public DbSet<Tenant> Tenants { get; set; } = null!;

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);
        modelBuilder.ConfigureLevgeTenancy<Tenant>();
    }
}

Global Query Filter ile birlikte

public class AppDbContext : LevgeTenantDbContext<Tenant>
{
    private readonly ITenantContext _tenantContext;

    public AppDbContext(DbContextOptions<AppDbContext> options, ITenantContext tenantContext)
        : base(options)
    {
        _tenantContext = tenantContext;
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);

        if (_tenantContext.HasTenant)
            modelBuilder.AddTenantQueryFilters(_tenantContext);
    }
}

ITenantContext

JWT claim'lerinden otomatik çözümlenen kiracı bağlamı:

public class OrderService
{
    private readonly ITenantContext _tenantContext;

    public OrderService(ITenantContext tenantContext)
        => _tenantContext = tenantContext;

    public void Create()
    {
        long tenantId = _tenantContext.RequiredTenantId; // yoksa LevgeTenantException fırlatır
        bool hasTenant = _tenantContext.HasTenant;
        string? name = _tenantContext.TenantName;
    }
}

ITenantService

public interface ITenantService<TTenant>
{
    Task<TTenant?>      GetByIdAsync(long id, CancellationToken ct = default);
    Task<TTenant?>      GetBySlugAsync(string slug, CancellationToken ct = default);
    Task<List<TTenant>> GetAllAsync(CancellationToken ct = default);
    Task<List<TTenant>> GetByStatusAsync(TenantStatus status, CancellationToken ct = default);
    Task<bool>          SlugExistsAsync(string slug, long? excludeId = null, CancellationToken ct = default);
    Task<bool>          IsActiveAsync(long tenantId, CancellationToken ct = default);
    Task<Result>        UpdateStatusAsync(long tenantId, TenantStatus status, CancellationToken ct = default);
}

// Kullanım
var tenant = await _tenantService.GetBySlugAsync("acme-corp");
bool active = await _tenantService.IsActiveAsync(tenantId);
await _tenantService.UpdateStatusAsync(tenantId, TenantStatus.Suspended);

Global Query Filter

ITenantEntity uygulayan tüm entity'lere otomatik WHERE TenantId = @currentTenantId filtresi eklenir.
Levge.Domain'deki FullAuditableTenantEntity veya TenantEntity'den türeyen entity'ler otomatik kapsama girer.

// Filtre devredışı bırakmak için (SuperAdmin senaryoları)
_dbContext.Orders.IgnoreQueryFilters().ToListAsync();

TenantStatus

Bağımlılıklar