데이터 지속성 관리

엔터티 타입 구성

Lino는 Persistence‑Ignorant 원칙을 따릅니다: 도메인 엔터티는 인프라 세부 사항을 알지 못합니다. 이를 위해 모든 ORM 매핑은 IEntityTypeConfiguration<T>를 구현하는 클래스에 위치하며, Configurations/<EntityName>Configuration.cs에 저장됩니다.

• 각 엔터티는 전용 구성 파일을 가집니다.
• 전역 규칙(예: decimal(18,2), 정렬, DateTime을 utc로 지정)은 ModelConfiguration에 중앙 집중화할 수 있습니다.
• 구성은 DbContext의 OnModelCreating에서 modelBuilder.ApplyConfigurationsFromAssembly(...)를 통해 적용됩니다.

DbContexts

DbContext는 애플리케이션의 트랜잭션 단위를 나타냅니다. Lino는 자동으로 생성합니다:

• 전통적인 서비스 — 모든 DbSet<TEntity>를 포함하는 단일 AppDbContext.
• 모듈형 서비스 — 각 bounded context마다 별도의 <Module>DbContext. 이렇게 하면 각 모듈이 더 빠르게 컴파일되고, 마이그레이션 사이클이 짧아지며, 병합 충돌 위험이 줄어듭니다.

모든 DbContext는 <Module>/Infrastructure.Persistence에 등록되고, IUnitOfWork를 통해 노출되며, dependency injection으로 해결됩니다.

레포지토리

구체적인 레포지토리는 <Module>/Infrastructure.Persistence.Repositories에 위치하며 <Module>/Domain.Repositories 네임스페이스에 정의된 인터페이스를 구현합니다. 각 레포지토리는:

• 복잡한 쿼리(LINQ, FromSql, DTO 프로젝션)를 캡슐화합니다.
• 도메인에 필요한 메서드만 노출합니다 (애그리거트 루트 중심).

유닛 오브 워크 (Unit of Work)

유닛 오브 워크는 여러 리포지토리를 조정하는 트랜잭션 경계 역할을 하여 모든 작업이 원자적으로 실행되도록 보장합니다. 간단한 시나리오에서는 DbContext 자체로 충분한 경우가 많습니다. 그러나 Lino는 더 많은 제어와 유연성을 제공하는 전용 구현(UnitOfWork)을 생성합니다.

• 필요한 경우 BeginTransaction, Commit, Rollback을 통해 수동으로 트랜잭션을 제어할 수 있습니다.
• 현재 트랜잭션 내에서 도메인 이벤트를 게시하여 동일한 commit 사이클 내에서 실행되도록 보장합니다.
• 아웃박스에 통합 이벤트를 지속하여 트랜잭션 아웃박스 패턴을 따르며, 분산 아키텍처 시나리오에서 신뢰할 수 있는 전달을 보장합니다(적용 가능할 경우).

마이그레이션 관리

Lino는 Entity Framework Core와 함께 데이터베이스 마이그레이션 프로세스를 완전히 간소화하고 자동화하여 반복 작업과 일반적인 불일치 위험을 제거합니다. 새 마이그레이션을 생성하려면 다음 명령어를 실행하세요:

lino database migrations add

명령을 실행하면 인터랙티브 도우미가 다음 정보를 요청합니다:

• 서비스 — 마이그레이션이 적용될 프로젝트 이름입니다.
• 모듈 — (모듈형 서비스에서만) 변경 사항이 속한 모듈입니다.
• 마이그레이션 이름 — 변경 내용 설명을 입력하세요 (예: AddCustomerIsActive). Lino는 .sql 스크립트를 생성할 때 현재 버전과 증가 순서를 자동으로 관리하며, 다음 패턴을 따릅니다: /Scripts/v1.2.3/001_AddCustomerIsActive.sql.