feat(contables): cierre mensual de cuenta corriente de distribuidor

Permite congelar el saldo de un distribuidor por empresa a una fecha de
corte y bloquear modificaciones retroactivas sobre el período cerrado.
El saldo se calcula sumando movimientos en rango (sin tocar cue_Saldos).
Incluye reapertura controlada exclusivamente por SuperAdmin, reporte con
saldo inicial, atajo "Desde último cierre", y auditoría del ciclo de
vida _H. Permisos CC001/CC002/CC003. Middleware global mapea bloqueos
por período cerrado a HTTP 409.

Backend/GestionIntegral.Api/Program.cs

@@ -23,6 +23,7 @@ using GestionIntegral.Api.Services.Suscripciones;
 using GestionIntegral.Api.Models.Comunicaciones;
 using GestionIntegral.Api.Services.Comunicaciones;
 using GestionIntegral.Api.Data.Repositories.Comunicaciones;
+using GestionIntegral.Api.Middleware;
 
 var builder = WebApplication.CreateBuilder(args);
 
@@ -96,6 +97,12 @@ builder.Services.AddScoped<ICambioParadaRepository, CambioParadaRepository>();
 builder.Services.AddScoped<ICambioParadaService, CambioParadaService>();
 // Servicio de Saldos
 builder.Services.AddScoped<ISaldoService, SaldoService>();
+// Cierre de Cuenta Corriente de Distribuidor
+builder.Services.AddMemoryCache();
+builder.Services.AddScoped<ICierreCuentaCorrienteRepository, CierreCuentaCorrienteRepository>();
+builder.Services.AddScoped<ICierreCuentaCorrienteService, CierreCuentaCorrienteService>();
+// Validador de período cerrado: SINGLETON porque mantiene cache en memoria de IMemoryCache que debe ser compartido entre requests.
+builder.Services.AddSingleton<IPeriodoCerradoValidator, PeriodoCerradoValidator>();
 // Repositorios de Reportes
 builder.Services.AddScoped<IReportesRepository, ReportesRepository>();
 // Servicios de Reportes
@@ -269,6 +276,10 @@ if (app.Environment.IsDevelopment())
 // Comenta o elimina la siguiente línea si SÓLO usas http://localhost:5183
 //app.UseHttpsRedirection();
 
+// Middleware global de excepciones — debe ir TEMPRANO en el pipeline para catchear cualquier excepción
+// que escape de los controllers/services. Mapea BloqueoPorPeriodoCerradoException → 409 con cuerpo JSON estandarizado.
+app.UseMiddleware<ExceptionHandlerMiddleware>();
+
 app.UseCors(MyAllowSpecificOrigins);
 
 app.UseAuthentication(); // Debe ir ANTES de UseAuthorization