Управление сохранением данных

Конфигурации типов сущностей

Lino следует принципу Persistence‑Ignorant: доменные сущности не знают деталей инфраструктуры. Для этого вся ORM-маппинг перенесён в классы, которые реализуют IEntityTypeConfiguration<T>, расположенные в Configurations/<EntityName>Configuration.cs.

• Каждая сущность имеет отдельный файл конфигурации.
• Глобальные соглашения (например, decimal(18,2), сортировка, DateTime как utc) могут быть централизованы в ModelConfiguration.
• Конфигурации применяются в методе OnModelCreating класса DbContext через modelBuilder.ApplyConfigurationsFromAssembly(...).

DbContexts

DbContext представляет собой единицу транзакции приложения. Lino генерирует автоматически:

• Традиционный сервис — один AppDbContext, содержащий все DbSet<TEntity>.
• Модульный сервис — отдельный <Module>DbContext для каждого bounded context. Таким образом, каждый модуль компилируется быстрее, имеет меньшие миграционные циклы и снижает риск merge conflicts.

Все DbContext регистрируются в <Module>/Infrastructure.Persistence, предоставляются через IUnitOfWork и разрешаются с помощью dependency injection.

Репозитории

Конкретные репозитории находятся в <Module>/Infrastructure.Persistence.Repositories и реализуют интерфейсы, определённые в пространстве имён <Module>/Domain.Repositories. Каждый репозиторий:

• Инкапсулирует сложные запросы (LINQ, FromSql, DTO-проекции).
• Предоставляет только методы, необходимые для домена (ориентирован на Aggregate Root).

Единица работы (Unit of Work)

Единица работы выступает в качестве транзакционной границы, которая координирует несколько репозиториев, гарантируя, что все операции выполняются атомарно. В простых сценариях зачастую достаточно самого DbContext. Однако Lino генерирует специализированную реализацию (UnitOfWork), которая обеспечивает больший контроль и гибкость.

• Позволяет вручную управлять транзакциями через BeginTransaction, Commit и Rollback, когда это необходимо.
• Публикует доменные события в рамках текущей транзакции, гарантируя их выполнение в одном цикле commit.
• Сохраняет интеграционные события в outbox, следуя паттерну Transaction Outbox, обеспечивая надежную доставку в распределенных архитектурах (при необходимости).

Управление миграциями

Lino полностью упрощает и автоматизирует процесс миграций базы данных с Entity Framework Core, устраняя повторяющиеся задачи и распространённые риски неконсистентности. Чтобы создать новую миграцию, выполните следующую команду:

lino database migrations add

При выполнении команды интерактивный помощник запросит следующую информацию:

• Сервис — имя проекта, к которому будет применена миграция.
• Модуль — (только для модульных сервисов) модуль, к которому относится изменение.
• Имя миграции — укажите описание изменения (например, AddCustomerIsActive). Lino автоматически позаботится о текущей версии и порядке инкрементации при генерации скрипта .sql, следуя шаблону: /Scripts/v1.2.3/001_AddCustomerIsActive.sql.