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/Services/Contables/SaldoService.cs

@@ -19,6 +19,7 @@ namespace GestionIntegral.Api.Services.Contables
         private readonly IDistribuidorRepository _distribuidorRepo; // Para nombres
         private readonly ICanillaRepository _canillaRepo;         // Para nombres
         private readonly IEmpresaRepository _empresaRepo;           // Para nombres
+        private readonly IPeriodoCerradoValidator _periodoCerrado;
         private readonly DbConnectionFactory _connectionFactory;
         private readonly ILogger<SaldoService> _logger;
 
@@ -27,6 +28,7 @@ namespace GestionIntegral.Api.Services.Contables
             IDistribuidorRepository distribuidorRepo,
             ICanillaRepository canillaRepo,
             IEmpresaRepository empresaRepo,
+            IPeriodoCerradoValidator periodoCerrado,
             DbConnectionFactory connectionFactory,
             ILogger<SaldoService> logger)
         {
@@ -34,6 +36,7 @@ namespace GestionIntegral.Api.Services.Contables
             _distribuidorRepo = distribuidorRepo;
             _canillaRepo = canillaRepo;
             _empresaRepo = empresaRepo;
+            _periodoCerrado = periodoCerrado;
             _connectionFactory = connectionFactory;
             _logger = logger;
         }
@@ -103,6 +106,11 @@ namespace GestionIntegral.Api.Services.Contables
             if (await _empresaRepo.GetByIdAsync(ajusteDto.IdEmpresa) == null)
                 return (false, "La empresa especificada no existe.", null);
 
+            // Bloqueo por período cerrado: la FechaOperacion del ajuste no puede caer dentro de un cierre vigente.
+            // El validator filtra internamente Destino="Distribuidores"; ajustes a Canillas no se bloquean.
+            var bloqueo = await _periodoCerrado.EstaCerradoAsync(ajusteDto.Destino, ajusteDto.IdDestino, ajusteDto.IdEmpresa, ajusteDto.FechaOperacion);
+            if (bloqueo.EstaCerrado)
+                throw new BloqueoPorPeriodoCerradoException(bloqueo.IdCierre!.Value, bloqueo.FechaCorte!.Value);
 
             using var connection = _connectionFactory.CreateConnection();
             if (connection.State != ConnectionState.Open) { if (connection is System.Data.Common.DbConnection dbConn) await dbConn.OpenAsync(); else connection.Open(); }
@@ -152,6 +160,11 @@ namespace GestionIntegral.Api.Services.Contables
                 var saldoDtoActualizado = await MapToGestionDto(saldoDespuesDeModificacion);
                 return (true, null, saldoDtoActualizado);
             }
+            catch (BloqueoPorPeriodoCerradoException)
+            {
+                try { transaction.Rollback(); } catch (Exception rbEx) { _logger.LogError(rbEx, "Error en Rollback de RealizarAjusteManualSaldoAsync (Bloqueo)."); }
+                throw;
+            }
             catch (Exception ex)
             {
                 try { transaction.Rollback(); } catch (Exception rbEx) { _logger.LogError(rbEx, "Error en Rollback de RealizarAjusteManualSaldoAsync."); }