Документация

Koto.Infrastructure.EFCore

Интеграция EF Core 10: generic-репозиторий, строготипизированные ID, specifications, Wolverine outbox.

Установка

dotnet add package Koto.Infrastructure.EFCore
dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL  # или ваш провайдер

Что внутри

ТипНазначение
KotoDbContextАбстрактный DbContext; автоматически применяет StronglyTypedIdConvention; очищает доменные события после сохранения
Repository<TAgg, TId>Generic-реализация IRepository на EF Core
StronglyTypedIdValueConverter<TId, TRaw>ValueConverter EF Core для свойств StronglyTypedId<T>
StronglyTypedIdConventionАвтоматически применяет конвертеры ко всем строготипизированным ID-свойствам
ISpecification<T> / Specification<T>Инкапсулирует критерии запроса, include и сортировку
SpecificationEvaluatorПрименяет specification к IQueryable<T>
AddKotoEFCore<TContext>()Регистрирует DbContext через интеграцию Wolverine с EF Core

Использование

1 — Определите DbContext

public class AppDbContext : KotoDbContext
{
    public AppDbContext(DbContextOptions options) : base(options) { }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.ApplyConfigurationsFromAssembly(typeof(AppDbContext).Assembly);
    }
}

StronglyTypedIdConvention применяется автоматически — ручные вызовы HasConversion не нужны.

2 — Регистрация

// Program.cs
builder.Services.AddKotoEFCore<AppDbContext>(opts =>
    opts.UseNpgsql(builder.Configuration.GetConnectionString("Db")));

// Настройка Wolverine — включаем автоматическую доставку доменных событий через outbox
builder.Host.UseWolverine(opts =>
{
    opts.UseEntityFrameworkCoreTransactions();
    opts.PublishDomainEventsFromEntityFrameworkCore<IHasDomainEvents, IDomainEvent>(
        e => e.DomainEvents);
});

3 — Репозиторий

public class OrderRepository : Repository<Order, OrderId>
{
    public OrderRepository(AppDbContext ctx) : base(ctx) { }
}

Либо использовать зарегистрированный IRepository<Order, OrderId> напрямую.

4 — Specifications

public class ActiveOrdersSpec : Specification<Order>
{
    public ActiveOrdersSpec(CustomerId customerId)
    {
        AddCriteria(o => o.CustomerId == customerId && !o.IsCancelled);
        AddInclude(o => o.Items);
        ApplyOrderBy(o => o.PlacedAt);
    }
}

// В репозитории или обработчике запроса:
var query = SpecificationEvaluator.GetQuery(_context.Set<Order>(), new ActiveOrdersSpec(customerId));
var orders = await query.ToListAsync(ct);