EAC.Infrastructure.Persistence 0.1.0-rc.2

EAC.Infrastructure.Persistence

Repositorio propietario del NuGet EAC.Infrastructure.Persistence.

Estado actual: alcance completado hasta PERS-010 y 0.1.0-rc.1 publicado. La promoción estable PERS-011 permanece aplazada hasta autorización explícita.

• Índice documental
• Diseño
• Plan de implementación
• Arquitectura transversal

Instalación, configuración y consumo

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

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.