EAC.Infrastructure.Persistence.EntityFrameworkCore 0.1.0-rc.4

EAC.Infrastructure.Persistence.EntityFrameworkCore

Desarrollo desde el workspace

El proyecto referencia el código fuente del repositorio hermano eac-infrastructure-persistence, que referencia eac-foundation. La solución incluye ambas dependencias para compilar el grafo con la misma configuración. Los tres repositorios deben estar presentes antes de ejecutar scripts/ci.sh; no se utilizan paquetes publicados como alternativa local.

Repositorio propietario del NuGet EAC.Infrastructure.Persistence.EntityFrameworkCore.

Estado actual: EF-001 a EF-009 implementados y validados sobre PostgreSQL real; 0.1.0-rc.2 está publicado y la promoción estable permanece diferida. Outbox/Inbox se instala separadamente mediante el adaptador opcional EAC.Infrastructure.Persistence.EntityFrameworkCore.Messaging.

La CI remota reutiliza Pipeline Catalog v0.4.9 con el perfil PostgreSQL; el repositorio solo contiene el binding .tekton y no define Pipelines ni Tasks.

El adaptador ofrece bases mínimas para Aggregate Repository, QueryService y Unit of Work. Las consultas de colección permanecen en QueryServices concretos: reciben criterios tipados y PageRequest de Application, aplican filtros y ordenaciones permitidos con desempate estable y llaman a la base EF con el número y tamaño solicitados. La base materializa PagedResult<T> del contrato neutral de Persistence; el QueryService concreto lo transforma a Page<T> de Application, donde conoce ambos contratos. Cada operación puede seleccionar su entidad y proyección, por lo que un mismo QueryService cohesionado puede devolver diferentes read models sin exponer IQueryable. Cuando el modelo final requiere lógica no traducible por el provider, la base aplica un mapper tipado después de materializar la proyección intermedia y conserva la metadata del resultado. Las reglas de selección reutilizables pueden implementarse como EfQuerySpecification<TEntity> y componerse mediante And u Or dentro de Infrastructure.

En modo de trazabilidad Detailed, las implementaciones de puertos anotadas generan decoradores estáticos para QueryServices, repositorios y puertos de almacenamiento. El paquete no selecciona exporter ni backend: el host aporta la política Eac:Observability:Tracing:DetailLevel y, si necesita diagnóstico de EF Core, instala la instrumentación oficial beta descrita en la arquitectura. Los spans de repositorio incluyen el nombre lógico de la implementación, como persistence.repository ProductRepository.FindAsync; los spans de EF y de Unit of Work usan el tipo de DbContext, nunca el nombre de la base ni del decorador generado. El generador mantiene los argumentos en None por defecto. Para AllowListedValues, sólo admite parámetros bool, numéricos o enums con [EacTraceSafeArgument]; rechaza los tipos prohibidos en compilación.

• Índice documental
• EF Core
• Adaptador opcional Outbox e Inbox
• Plan de implementación
• Consumo y configuración
• Arquitectura transversal