EAC.Infrastructure.Persistence 0.1.0-rc.4

EAC.Infrastructure.Persistence

Desde 2026-10-09, Native AOT queda fuera del alcance por decisión del usuario. No se declara compatibilidad ni se exige su gate. Las referencias históricas no constituyen soporte vigente; build y tests ordinarios siguen siendo obligatorios.

Desarrollo desde el workspace

La conversión reutilizable ResultJsonConverter<TValue, TRepresentation> está disponible mediante ProjectReference, sin publicar una nueva versión. Recibe metadata JSON explícita, una factory Result y la proyección de escritura. El servicio conserva el formato y las reglas de reconstitución.

El proyecto referencia el código fuente de eac-foundation, situado como repositorio hermano. La solución incluye esa dependencia para compilarla con la misma configuración. Antes de ejecutar scripts/ci.sh, deben estar presentes ambos repositorios; no se utiliza el paquete publicado como alternativa local.

Repositorio propietario del NuGet EAC.Infrastructure.Persistence, incluidos los contratos neutrales de stores y resultados paginados de consultas de persistencia.

Estado actual: alcance completado hasta PERS-011 con 0.1.0-rc.3 publicado. La promoción estable PERS-012 sigue aplazada.

• Índice documental
• Guía de consumo y configuración
• Diseño
• Plan de implementación
• Arquitectura transversal

Instalación, configuración y consumo

<PackageReference Include="EAC.Infrastructure.Persistence" Version="0.1.0-rc.3" />

El registro básico declara stores tipados y no requiere configuración ambiental:

services.AddEacPersistence(stores => stores.AddStore<OrderCommandStore>(
    StoreRole.Command,
    owner: "orders",
    connectionName: "OrderPostgreSql",
    technology: "EntityFrameworkCore"));

Para enlazar referencias a valores de conexión suministrados externamente:

services.AddEacPersistence(
    builder.Configuration,
    stores => stores.AddStore<OrderCommandStore>(
        StoreRole.Command,
        "orders",
        "OrderPostgreSql",
        "EntityFrameworkCore"));

Configuración completa de las dos formas admitidas:

{
  "Eac": {
    "Persistence": {
      "Connections": {
        "OrderPostgreSql": {
          "SecretKey": "ConnectionStrings:OrderPostgreSql"
        },
        "SharedElasticCluster": {
          "EndpointKey": "Search:Elastic:Endpoint",
          "CredentialKey": "Search:Elastic:Credential"
        }
      }
    }
  }
}

Equivalencia mediante variables de entorno:

Eac__Persistence__Connections__OrderPostgreSql__SecretKey=ConnectionStrings:OrderPostgreSql
Eac__Persistence__Connections__SharedElasticCluster__EndpointKey=Search:Elastic:Endpoint
Eac__Persistence__Connections__SharedElasticCluster__CredentialKey=Search:Elastic:Credential

Cada store del manifiesto debe encontrar una conexión lógica con el mismo nombre. Una conexión usa SecretKey o EndpointKey, nunca ambas; las claves solo admiten rutas de configuración acotadas y no valores inline. Una sección inválida impide el startup. Los cambios requieren reiniciar el proceso.

La configuración programática posterior al binding tiene precedencia:

services.AddEacPersistence(
    builder.Configuration,
    ConfigureStores,
    options => options.Connections["OrderPostgreSql"].SecretKey =
        "Secrets:Orders:Primary");

PersistenceOptions contiene referencias, nunca connection strings, credenciales ni endpoints reales. Esos valores proceden de variables de entorno, workload identity o un proveedor de secretos y los resuelve el adaptador propietario. Stores, roles, tecnologías, entidades y mappings permanecen en código. Registrar el núcleo no activa drivers, conexiones, workers, Inbox ni Outbox.