Swevo.EFCore.MultiTenant 1.0.1

Swevo.EFCore.MultiTenant

Compile-time multi-tenancy for EF Core. Stamp a [Tenant] attribute on any entity and the source generator wires up TenantId, a save interceptor, and global query filters automatically.

Quick-start

dotnet add package Swevo.EFCore.MultiTenant

1 — Mark your entities

using EFCore.MultiTenant;

[Tenant]
public partial class Order
{
    public int Id { get; set; }
    public string Description { get; set; } = "";
    // TenantId { get; set; } is generated automatically
}

The class must be partial. Non-partial classes produce diagnostic MTNT001.

2 — Implement ITenantContext

public class HttpTenantContext(IHttpContextAccessor http) : ITenantContext
{
    public string TenantId =>
        http.HttpContext?.Request.Headers["X-Tenant-Id"].FirstOrDefault() ?? "";
}

Register it as scoped in your DI container:

builder.Services.AddScoped<ITenantContext, HttpTenantContext>();

3 — Configure DbContext

public class AppDbContext(DbContextOptions<AppDbContext> options, ITenantContext tenant)
    : DbContext(options)
{
    public DbSet<Order> Orders => Set<Order>();

    protected override void OnModelCreating(ModelBuilder modelBuilder)
        => modelBuilder.AddTenantQueryFilters(tenant);

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        => optionsBuilder.AddTenantInterceptor(tenant);
}

That's it. Every SaveChanges / SaveChangesAsync call stamps TenantId on new entities, and every query automatically filters by the current tenant.

How it works

Bypass the filter

Use IgnoreQueryFilters() for admin/reporting queries:

var allOrders = await db.Orders.IgnoreQueryFilters().ToListAsync();

Stacking with other Swevo packages

[Tenant]   // Swevo.EFCore.MultiTenant — adds TenantId
[Auditable] // Swevo.AutoAudit — adds CreatedAt / UpdatedAt
[SoftDelete] // Swevo.EFCore.SoftDelete — adds IsDeleted
public partial class Order { ... }

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .AddTenantInterceptor(tenant)
        .AddAuditInterceptor(clock)
        .AddSoftDeleteInterceptor();
}

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.AddTenantQueryFilters(tenant);
    modelBuilder.AddSoftDeleteQueryFilters();
}

Requirements

• .NET 8+
• EF Core 8+

License

MIT