Feat(suscripciones): Implementa manejo de pagos parciales en facturas

Se introduce una refactorización completa del sistema de registro de pagos para manejar correctamente los abonos parciales, asegurando que el estado de la factura y el saldo pendiente se reflejen con precisión tanto en el backend como en la interfaz de usuario.

### 🐛 Problema Solucionado

- Anteriormente, el sistema no reconocía los pagos parciales. Una factura permanecía en estado "Pendiente" hasta que el monto total era cubierto, y la interfaz de usuario siempre mostraba el 100% del saldo como pendiente, lo cual era incorrecto y confuso.

### ✨ Nuevas Características y Mejoras

- **Nuevo Estado de Factura "Pagada Parcialmente":**
    - Se introduce un nuevo estado para las facturas que han recibido uno o más pagos pero cuyo saldo aún no es cero.
    - El `PagoService` ahora actualiza el estado de la factura a "Pagada Parcialmente" cuando recibe un abono que no cubre el total.

- **Mejoras en la Interfaz de Usuario (`ConsultaFacturasPage`):**
    - **Nuevas Columnas:** Se han añadido las columnas "Pagado" y "Saldo" a la tabla de detalle de facturas, mostrando explícitamente el monto abonado y el restante.
    - **Visualización de Estado:** El `Chip` de estado ahora muestra "Pagada Parcialmente" con un color distintivo (azul/primary) para una rápida identificación visual.
    - **Cálculo de Saldo Correcto:** El saldo pendiente total por suscriptor y el saldo para el modal de pago manual ahora se calculan correctamente, restando el `totalPagado` del `importeFinal`.

### 🔄 Cambios en el Backend

- **`PagoService`:** Se actualizó la lógica para establecer el estado de la factura (`Pendiente`, `Pagada Parcialmente`, `Pagada`) basado en el `nuevoTotalPagado` después de registrar un pago.
- **`FacturacionService`:** El método `ObtenerResumenesDeCuentaPorPeriodo` ahora calcula correctamente el `SaldoPendienteTotal` y pasa la propiedad `TotalPagado` al DTO del frontend.
- **DTOs:** Se actualizó `FacturaConsolidadaDto` para incluir la propiedad `TotalPagado`.

Backend/GestionIntegral.Api/.env

@@ -4,7 +4,7 @@
 # El separador de doble guion bajo (__) se usa para mapear la jerarquía del JSON.
 # MailSettings:SmtpHost se convierte en MailSettings__SmtpHost
 
-MailSettings__SmtpHost="mail.eldia.com"
+MailSettings__SmtpHost="192.168.5.201"
 MailSettings__SmtpPort=587
 MailSettings__SenderName="Club - Diario El Día"
 MailSettings__SenderEmail="alertas@eldia.com"

Backend/GestionIntegral.Api/Models/Dtos/Suscripciones/FacturaConsolidadaDto.cs

@@ -8,6 +8,7 @@ namespace GestionIntegral.Api.Dtos.Suscripciones
         public string EstadoPago { get; set; } = string.Empty;
         public string EstadoFacturacion { get; set; } = string.Empty;
         public string? NumeroFactura { get; set; }
+        public decimal TotalPagado { get; set; }
         public List<FacturaDetalleDto> Detalles { get; set; } = new List<FacturaDetalleDto>();
     }
 }

Backend/GestionIntegral.Api/Services/Suscripciones/FacturacionService.cs

@@ -282,7 +282,7 @@ namespace GestionIntegral.Api.Services.Suscripciones
         {
             var periodo = $"{anio}-{mes:D2}";
             var facturasData = await _facturaRepository.GetByPeriodoEnrichedAsync(periodo, nombreSuscriptor, estadoPago, estadoFacturacion);
-            var detallesData = await _facturaDetalleRepository.GetDetallesPorPeriodoAsync(periodo); // Necesitaremos este nuevo método en el repo
+            var detallesData = await _facturaDetalleRepository.GetDetallesPorPeriodoAsync(periodo);
             var empresas = await _empresaRepository.GetAllAsync(null, null);
 
             var resumenes = facturasData
@@ -301,6 +301,7 @@ namespace GestionIntegral.Api.Services.Suscripciones
                             EstadoPago = itemFactura.Factura.EstadoPago,
                             EstadoFacturacion = itemFactura.Factura.EstadoFacturacion,
                             NumeroFactura = itemFactura.Factura.NumeroFactura,
+                            TotalPagado = itemFactura.TotalPagado,
                             Detalles = detallesData
                                 .Where(d => d.IdFactura == itemFactura.Factura.IdFactura)
                                 .Select(d => new FacturaDetalleDto { Descripcion = d.Descripcion, ImporteNeto = d.ImporteNeto })
@@ -314,7 +315,7 @@ namespace GestionIntegral.Api.Services.Suscripciones
                         NombreSuscriptor = primerItem.NombreSuscriptor,
                         Facturas = facturasConsolidadas,
                         ImporteTotal = facturasConsolidadas.Sum(f => f.ImporteFinal),
-                        SaldoPendienteTotal = facturasConsolidadas.Sum(f => f.EstadoPago == "Pagada" ? 0 : f.ImporteFinal)
+                        SaldoPendienteTotal = facturasConsolidadas.Sum(f => f.ImporteFinal - f.TotalPagado)
                     };
                 });
 

Backend/GestionIntegral.Api/Services/Suscripciones/PagoService.cs

@@ -70,14 +70,11 @@ namespace GestionIntegral.Api.Services.Suscripciones
             {
                 var factura = await _facturaRepository.GetByIdAsync(createDto.IdFactura);
                 if (factura == null) return (null, "La factura especificada no existe.");
-
-                // Usar EstadoPago para la validación
                 if (factura.EstadoPago == "Anulada") return (null, "No se puede registrar un pago sobre una factura anulada.");
 
                 var formaPago = await _formaPagoRepository.GetByIdAsync(createDto.IdFormaPago);
                 if (formaPago == null || !formaPago.Activo) return (null, "La forma de pago no es válida.");
 
-                // Obtenemos la suma de pagos ANTERIORES
                 var totalPagadoAnteriormente = await _pagoRepository.GetTotalPagadoAprobadoAsync(createDto.IdFactura, transaction);
 
                 var nuevoPago = new Pago
@@ -96,37 +93,31 @@ namespace GestionIntegral.Api.Services.Suscripciones
                 var pagoCreado = await _pagoRepository.CreateAsync(nuevoPago, transaction);
                 if (pagoCreado == null) throw new DataException("No se pudo registrar el pago.");
 
-                // Calculamos el nuevo total EN MEMORIA
                 var nuevoTotalPagado = totalPagadoAnteriormente + pagoCreado.Monto;
 
-                // Comparamos y actualizamos el estado si es necesario
+                // Nueva lógica para manejar todos los estados de pago
-                // CORRECCIÓN: Usar EstadoPago y el método correcto del repositorio
+                string nuevoEstadoPago = factura.EstadoPago;
-                if (factura.EstadoPago != "Pagada" && nuevoTotalPagado >= factura.ImporteFinal)
+                if (nuevoTotalPagado >= factura.ImporteFinal)
                 {
-                    bool actualizado = await _facturaRepository.UpdateEstadoPagoAsync(factura.IdFactura, "Pagada", transaction);
+                    nuevoEstadoPago = "Pagada";
-                    if (!actualizado) throw new DataException("No se pudo actualizar el estado de la factura a 'Pagada'.");
+                }
+                else if (nuevoTotalPagado > 0)
+                {
+                    nuevoEstadoPago = "Pagada Parcialmente";
+                }
+                // Si nuevoTotalPagado es 0, el estado no cambia.
+
+                // Solo actualizamos si el estado calculado es diferente al actual.
+                if (nuevoEstadoPago != factura.EstadoPago)
+                {
+                    bool actualizado = await _facturaRepository.UpdateEstadoPagoAsync(factura.IdFactura, nuevoEstadoPago, transaction);
+                    if (!actualizado) throw new DataException($"No se pudo actualizar el estado de la factura a '{nuevoEstadoPago}'.");
                 }
 
                 transaction.Commit();
                 _logger.LogInformation("Pago manual ID {IdPago} registrado para Factura ID {IdFactura} por Usuario ID {IdUsuario}", pagoCreado.IdPago, pagoCreado.IdFactura, idUsuario);
 
-                // Construimos el DTO de respuesta SIN volver a consultar la base de datos
+                var dto = await MapToDto(pagoCreado); // MapToDto ahora es más simple
-                var usuario = await _usuarioRepository.GetByIdAsync(idUsuario);
-                var dto = new PagoDto
-                {
-                    IdPago = pagoCreado.IdPago,
-                    IdFactura = pagoCreado.IdFactura,
-                    FechaPago = pagoCreado.FechaPago.ToString("yyyy-MM-dd"),
-                    IdFormaPago = pagoCreado.IdFormaPago,
-                    NombreFormaPago = formaPago.Nombre,
-                    Monto = pagoCreado.Monto,
-                    Estado = pagoCreado.Estado,
-                    Referencia = pagoCreado.Referencia,
-                    Observaciones = pagoCreado.Observaciones,
-                    IdUsuarioRegistro = pagoCreado.IdUsuarioRegistro,
-                    NombreUsuarioRegistro = usuario != null ? $"{usuario.Nombre} {usuario.Apellido}" : "N/A"
-                };
-
                 return (dto, null);
             }
             catch (Exception ex)

Frontend/src/components/Modals/Usuarios/PermisosChecklist.tsx

@@ -14,18 +14,18 @@ const SECCION_PERMISSIONS_PREFIX = "SS";
 // Mapeo de codAcc de sección a su módulo conceptual
 const getModuloFromSeccionCodAcc = (codAcc: string): string | null => {
     if (codAcc === "SS001") return "Distribución";    
+    if (codAcc === "SS007") return "Suscripciones";
     if (codAcc === "SS002") return "Contables";
     if (codAcc === "SS003") return "Impresión";
     if (codAcc === "SS004") return "Reportes";
-    if (codAcc === "SS005") return "Radios";
     if (codAcc === "SS006") return "Usuarios";    
+    if (codAcc === "SS005") return "Radios";
     return null;
 };
 
 // Función para determinar el módulo conceptual de un permiso individual
 const getModuloConceptualDelPermiso = (permisoModulo: string): string => {
     const moduloLower = permisoModulo.toLowerCase();    
-
     if (moduloLower.includes("distribuidores") ||
         moduloLower.includes("canillas") || // Cubre "Canillas" y "Movimientos Canillas"
         moduloLower.includes("publicaciones distribución") ||
@@ -36,6 +36,9 @@ const getModuloConceptualDelPermiso = (permisoModulo: string): string => {
         moduloLower.includes("ctrl. devoluciones")) {
         return "Distribución";
     }
+    if (moduloLower.includes("suscripciones")) {
+        return "Suscripciones";
+    }
     if (moduloLower.includes("cuentas pagos") ||
         moduloLower.includes("cuentas notas") ||
         moduloLower.includes("cuentas tipos pagos")) {
@@ -89,7 +92,7 @@ const PermisosChecklist: React.FC<PermisosChecklistProps> = ({
     return acc;
   }, {} as Record<string, PermisoAsignadoDto[]>);
 
-  const ordenModulosPrincipales = ["Distribución", "Contables", "Impresión", "Radios", "Usuarios", "Reportes", "Permisos (Definición)"];
+  const ordenModulosPrincipales = ["Distribución", "Suscripciones", "Contables", "Impresión", "Usuarios", "Reportes", "Radios","Permisos (Definición)"];
   // Añadir módulos que solo tienen permiso de sección (como Radios) pero no hijos (aún)
   permisosDeSeccion.forEach(ps => {
       const moduloConceptual = getModuloFromSeccionCodAcc(ps.codAcc);

Frontend/src/models/dtos/Suscripciones/ResumenCuentaSuscriptorDto.ts

@@ -12,6 +12,7 @@ export interface FacturaConsolidadaDto {
     estadoPago: string;
     estadoFacturacion: string;
     numeroFactura?: string | null;
+    totalPagado: number;
     detalles: FacturaDetalleDto[];
     // Añadimos el id del suscriptor para que sea fácil pasarlo a los handlers
     idSuscriptor: number; 

Frontend/src/pages/Suscripciones/ConsultaFacturasPage.tsx

@@ -24,7 +24,7 @@ const meses = [
     { value: 10, label: 'Octubre' }, { value: 11, label: 'Noviembre' }, { value: 12, label: 'Diciembre' }
 ];
 
-const estadosPago = ['Pendiente', 'Pagada', 'Rechazada', 'Anulada'];
+const estadosPago = ['Pendiente', 'Pagada', 'Pagada Parcialmente', 'Rechazada', 'Anulada'];
 const estadosFacturacion = ['Pendiente de Facturar', 'Facturado'];
 
 const SuscriptorRow: React.FC<{
@@ -33,50 +33,83 @@ const SuscriptorRow: React.FC<{
     handleOpenHistorial: (factura: FacturaConsolidadaDto) => void;
 }> = ({ resumen, handleMenuOpen, handleOpenHistorial }) => {
     const [open, setOpen] = useState(false);
+
+    // Función para formatear moneda
+    const formatCurrency = (value: number) => `$${value.toFixed(2)}`;
+
     return (
         <React.Fragment>
             <TableRow sx={{ '& > *': { borderBottom: 'unset' } }} hover>
                 <TableCell><IconButton size="small" onClick={() => setOpen(!open)}>{open ? <KeyboardArrowUpIcon /> : <KeyboardArrowDownIcon />}</IconButton></TableCell>
                 <TableCell component="th" scope="row">{resumen.nombreSuscriptor}</TableCell>
                 <TableCell align="right">
-                    <Typography variant="body2" sx={{ fontWeight: 'bold', color: resumen.saldoPendienteTotal > 0 ? 'error.main' : 'success.main' }}>${resumen.saldoPendienteTotal.toFixed(2)}</Typography>
+                    <Typography variant="body2" sx={{ fontWeight: 'bold', color: resumen.saldoPendienteTotal > 0 ? 'error.main' : 'success.main' }}>
-                    <Typography variant="caption" color="text.secondary">de ${resumen.importeTotal.toFixed(2)}</Typography>
+                        {formatCurrency(resumen.saldoPendienteTotal)}
+                    </Typography>
+                    <Typography variant="caption" color="text.secondary">de {formatCurrency(resumen.importeTotal)}</Typography>
                 </TableCell>
-                <TableCell colSpan={5}></TableCell>
+                <TableCell colSpan={7}></TableCell>
             </TableRow>
             <TableRow>
-                <TableCell style={{ paddingBottom: 0, paddingTop: 0 }} colSpan={8}>
+                <TableCell style={{ paddingBottom: 0, paddingTop: 0 }} colSpan={10}>
                     <Collapse in={open} timeout="auto" unmountOnExit>
                         <Box sx={{ margin: 1, padding: 2, backgroundColor: 'grey.50', borderRadius: 1 }}>
-                            <Typography variant="h6" gutterBottom component="div" sx={{ fontSize: '1rem', fontWeight: 'bold' }}>Facturas del Período para {resumen.nombreSuscriptor}</Typography>
+                            <Typography variant="h6" gutterBottom component="div" sx={{ fontSize: '1rem', fontWeight: 'bold' }}>
+                                Facturas del Período para {resumen.nombreSuscriptor}
+                            </Typography>
                             <Table size="small">
                                 <TableHead>
                                     <TableRow>
-                                        <TableCell>Empresa</TableCell><TableCell align="right">Importe</TableCell>
+                                        <TableCell>Empresa</TableCell>
-                                        <TableCell>Estado Pago</TableCell><TableCell>Estado Facturación</TableCell>
+                                        <TableCell align="right">Importe Total</TableCell>
-                                        <TableCell>Nro. Factura</TableCell><TableCell align="right">Acciones</TableCell>
+                                        <TableCell align="right">Pagado</TableCell>
+                                        <TableCell align="right">Saldo</TableCell>
+                                        <TableCell>Estado Pago</TableCell>
+                                        <TableCell>Estado Facturación</TableCell>
+                                        <TableCell>Nro. Factura</TableCell>
+                                        <TableCell align="right">Acciones</TableCell>
                                     </TableRow>
                                 </TableHead>
                                 <TableBody>
-                                    {resumen.facturas.map((factura) => (
+                                    {resumen.facturas.map((factura) => {
-                                        <TableRow key={factura.idFactura}>
+                                        const saldo = factura.importeFinal - factura.totalPagado;
-                                            <TableCell sx={{ fontWeight: 'medium' }}>{factura.nombreEmpresa}</TableCell>
+                                        return (
-                                            <TableCell align="right">${factura.importeFinal.toFixed(2)}</TableCell>
+                                            <TableRow key={factura.idFactura}>
-                                            <TableCell><Chip label={factura.estadoPago} size="small" color={factura.estadoPago === 'Pagada' ? 'success' : (factura.estadoPago === 'Rechazada' ? 'error' : 'default')} /></TableCell>
+                                                <TableCell sx={{ fontWeight: 'medium' }}>{factura.nombreEmpresa}</TableCell>
-                                            <TableCell><Chip label={factura.estadoFacturacion} size="small" color={factura.estadoFacturacion === 'Facturado' ? 'info' : 'warning'} /></TableCell>
+                                                <TableCell align="right">{formatCurrency(factura.importeFinal)}</TableCell>
-                                            <TableCell>{factura.numeroFactura || '-'}</TableCell>
+                                                <TableCell align="right" sx={{ color: 'success.dark' }}>
-                                            <TableCell align="right">
+                                                    {formatCurrency(factura.totalPagado)}
-                                                <IconButton onClick={(e) => handleMenuOpen(e, factura)} disabled={factura.estadoPago === 'Anulada'}>
+                                                </TableCell>
-                                                    <MoreVertIcon />
+                                                <TableCell align="right" sx={{ fontWeight: 'bold', color: saldo > 0 ? 'error.main' : 'inherit' }}>
-                                                </IconButton>
+                                                    {formatCurrency(saldo)}
-                                                <Tooltip title="Ver Historial de Envíos">
+                                                </TableCell>
-                                                    <IconButton onClick={() => handleOpenHistorial(factura)}>
+                                                <TableCell>
-                                                        <MailOutlineIcon />
+                                                    <Chip
+                                                        label={factura.estadoPago}
+                                                        size="small"
+                                                        color={
+                                                            factura.estadoPago === 'Pagada' ? 'success' :
+                                                                factura.estadoPago === 'Pagada Parcialmente' ? 'primary' :
+                                                                    factura.estadoPago === 'Rechazada' ? 'error' :
+                                                                        'default'
+                                                        }
+                                                    />
+                                                </TableCell>
+                                                <TableCell><Chip label={factura.estadoFacturacion} size="small" color={factura.estadoFacturacion === 'Facturado' ? 'info' : 'warning'} /></TableCell>
+                                                <TableCell>{factura.numeroFactura || '-'}</TableCell>
+                                                <TableCell align="right">
+                                                    <IconButton onClick={(e) => handleMenuOpen(e, factura)} disabled={factura.estadoPago === 'Anulada'}>
+                                                        <MoreVertIcon />
                                                     </IconButton>
-                                                </Tooltip>
+                                                    <Tooltip title="Ver Historial de Envíos">
-                                            </TableCell>
+                                                        <IconButton onClick={() => handleOpenHistorial(factura)}>
-                                        </TableRow>
+                                                            <MailOutlineIcon />
-                                    ))}
+                                                        </IconButton>
+                                                    </Tooltip>
+                                                </TableCell>
+                                            </TableRow>
+                                        );
+                                    })}
                                 </TableBody>
                             </Table>
                         </Box>
@@ -257,12 +290,12 @@ const ConsultaFacturasPage: React.FC = () => {
                         idFactura: selectedFactura.idFactura,
                         nombreSuscriptor: resumenes.find(r => r.idSuscriptor === resumenes.find(res => res.facturas.some(f => f.idFactura === selectedFactura.idFactura))?.idSuscriptor)?.nombreSuscriptor || '',
                         importeFinal: selectedFactura.importeFinal,
-                        saldoPendiente: selectedFactura.estadoPago === 'Pagada' ? 0 : selectedFactura.importeFinal,
+                        saldoPendiente: selectedFactura.importeFinal - selectedFactura.totalPagado,
+                        totalPagado: selectedFactura.totalPagado,
                         idSuscriptor: resumenes.find(res => res.facturas.some(f => f.idFactura === selectedFactura.idFactura))?.idSuscriptor || 0,
                         periodo: '',
                         fechaEmision: '',
                         fechaVencimiento: '',
-                        totalPagado: selectedFactura.importeFinal - (selectedFactura.estadoPago === 'Pagada' ? 0 : selectedFactura.importeFinal),
                         estadoPago: selectedFactura.estadoPago,
                         estadoFacturacion: selectedFactura.estadoFacturacion,
                         numeroFactura: selectedFactura.numeroFactura,

Frontend/src/pages/Usuarios/AsignarPermisosAPerfilPage.tsx

@@ -16,11 +16,12 @@ const SECCION_PERMISSIONS_PREFIX = "SS";
 
 const getModuloFromSeccionCodAcc = (codAcc: string): string | null => {
   if (codAcc === "SS001") return "Distribución";  
+  if (codAcc === "SS007") return "Suscripciones"; 
   if (codAcc === "SS002") return "Contables";
   if (codAcc === "SS003") return "Impresión";
   if (codAcc === "SS004") return "Reportes";
-  if (codAcc === "SS005") return "Radios";
   if (codAcc === "SS006") return "Usuarios"; 
+  if (codAcc === "SS005") return "Radios";
   return null;
 };
 
@@ -38,6 +39,9 @@ const getModuloConceptualDelPermiso = (permisoModulo: string): string => {
     moduloLower.includes("salidas otros destinos")) {
     return "Distribución";
   }  
+  if (moduloLower.includes("suscripciones")) {
+    return "Suscripciones";
+  }
   if (moduloLower.includes("cuentas pagos") ||
     moduloLower.includes("cuentas notas") ||
     moduloLower.includes("cuentas tipos pagos")) {
@@ -50,9 +54,6 @@ const getModuloConceptualDelPermiso = (permisoModulo: string): string => {
     moduloLower.includes("tipos bobinas")) {
     return "Impresión";
   }
-  if (moduloLower.includes("radios")) {
-    return "Radios";
-  }
   if (moduloLower.includes("usuarios") ||
     moduloLower.includes("perfiles")) {
     return "Usuarios";
@@ -63,6 +64,9 @@ const getModuloConceptualDelPermiso = (permisoModulo: string): string => {
   if (moduloLower.includes("permisos")) {
     return "Permisos (Definición)";
   }  
+  if (moduloLower.includes("radios")) {
+    return "Radios";
+  }
   return permisoModulo;
 };