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/Models/Dtos/Reportes/ReporteCuentasDistribuidorResponseDto.cs

@@ -7,8 +7,12 @@ namespace GestionIntegral.Api.Dtos.Reportes
         public IEnumerable<BalanceCuentaDistDto> EntradasSalidas { get; set; } = new List<BalanceCuentaDistDto>();
         public IEnumerable<BalanceCuentaDebCredDto> DebitosCreditos { get; set; } = new List<BalanceCuentaDebCredDto>();
         public IEnumerable<BalanceCuentaPagosDto> Pagos { get; set; } = new List<BalanceCuentaPagosDto>();
-        public IEnumerable<SaldoDto> Saldos { get; set; } = new List<SaldoDto>(); // O podría ser SaldoDto SaldoActual si siempre es uno
-        public string? NombreDistribuidor { get; set; } // Para el título del reporte
-        public string? NombreEmpresa { get; set; } // Para el título del reporte
+        public string? NombreDistribuidor { get; set; }
+        public string? NombreEmpresa { get; set; }
+
+        // Saldo a la fecha desde elegida en el filtro:
+        //   - Si existe cierre con FechaCorte < FechaDesde: SaldoCierre + movimientos netos entre fechaCierre+1 y fechaDesde-1.
+        //   - Sin cierres previos: 0.
+        public decimal SaldoInicial { get; set; }
     }
 }

Backend/GestionIntegral.Api/Models/Dtos/Reportes/ViewModels/CuentasDistribuidorViewModel.cs

@@ -10,9 +10,10 @@ namespace GestionIntegral.Api.Dtos.Reportes.ViewModels
         public IEnumerable<BalanceCuentaDistDto> Movimientos { get; set; } = new List<BalanceCuentaDistDto>();
         public IEnumerable<BalanceCuentaPagosDto> Pagos { get; set; } = new List<BalanceCuentaPagosDto>();
         public IEnumerable<BalanceCuentaDebCredDto> DebitosCreditos { get; set; } = new List<BalanceCuentaDebCredDto>();
-        
-        // Saldo real de la cuenta, se muestra al final sin usarse en cálculos intermedios.
-        public decimal SaldoDeCuenta { get; set; }
+
+        // Saldo inicial del período: snapshot del último cierre + movimientos netos hasta fechaDesde.
+        // 0 si no hay cierre previo.
+        public decimal SaldoInicial { get; set; }
 
         // --- Parámetros del reporte ---
         public string NombreDistribuidor { get; set; } = string.Empty;
@@ -24,6 +25,8 @@ namespace GestionIntegral.Api.Dtos.Reportes.ViewModels
         public decimal TotalMovimientos => Movimientos.Sum(m => m.Debe - m.Haber);
         public decimal TotalPagos => Pagos.Sum(p => p.Debe - p.Haber);
         public decimal TotalDebitosCreditos => DebitosCreditos.Sum(d => d.Debe - d.Haber);
-        public decimal TotalPeriodo => TotalMovimientos + TotalPagos + TotalDebitosCreditos;
+
+        // Saldo Final = Saldo Inicial + suma neta del período (Debe - Haber por sección).
+        public decimal SaldoFinal => SaldoInicial + TotalMovimientos + TotalPagos + TotalDebitosCreditos;
     }
 }