TechsBCN.Platform.Setup 0.0.36

TechsBCN.Platform.Setup

TechsBCN.Platform.Setup Es la capa de configuración de arranque de Platform. Su objetivo es centralizar la carga de configuración y las migraciones de base de datos para que el Program.cs del proyecto se mantenga limpio y no tenga que gestionar estos detalles directamente. Los proyectos no deben reimplementar lo que Platform ya proporciona aquí.

Depende de TechsBCN.Platform.Infrastructure y TechsBCN.Platform.Application.

Estructura

Setup/
├── AppSettingsSetup.cs
└── ApplyMigrations.cs

AppSettingsSetup

Extensión de IConfigurationBuilder que carga múltiples ficheros appsettings en un orden fijo. Su objetivo es que cada capa pueda tener su propio fichero de configuración sin que el proyecto tenga que registrarlos uno a uno. Se activa en Program.cs antes de configurar servicios:

builder.Configuration.AddTechsBcnAppConfiguration(args, builder.Environment.EnvironmentName);

Los ficheros se cargan en este orden — los que van después sobreescriben a los anteriores. Los ficheros *.local.json son los más específicos del entorno local y se ignoran en el repositorio:

appsettings.json
appsettings.{Environment}.json
appsettings.local.json
appsettings.Application.json
appsettings.Application.{Environment}.json
appsettings.Application.local.json
appsettings.Infrastructure.json
appsettings.Infrastructure.{Environment}.json
appsettings.Infrastructure.local.json
appsettings.Persistence.json
appsettings.Persistence.{Environment}.json
appsettings.Persistence.local.json
appsettings.Infrastructure.Persistence.json
appsettings.Infrastructure.Persistence.{Environment}.json
appsettings.Infrastructure.Persistence.local.json
Variables de entorno

Los parámetros de los ficheros que no tienen sufijo de entorno se inicializan a una cadena de texto vacía cuando no se conoce el valor por defecto. Los *.Production.json contienen los marcadores $(variable) que el pipeline sustituye en despliegue. Un par clave-valor que sea igual en local y en producción no debe repetirse en el fichero *.Production.json.

Las variables de entorno siempre tienen prioridad sobre cualquier fichero. Cuando un valor de configuración requerido no está presente, el proyecto debe lanzar MissingSetupException al arrancar:

var connectionString = configuration.GetConnectionString("MyProject")
    ?? throw new MissingSetupException("ConnectionStrings:MyProject not configured.");

ApplyMigrations

Extensión de IServiceCollection para aplicar las migraciones pendientes de EF Core al arrancar la aplicación. Su objetivo es encapsular esta inicialización en un método de extensión para que Program.cs no contenga lógica de configuración detallada:

builder.Services.ApplyMigrations<MyDbContext>();