Refactor: Mejora la lógica de facturación y la UI

Este commit introduce una refactorización significativa en el módulo de
suscripciones para alinear el sistema con reglas de negocio clave:
facturación consolidada por empresa, cobro a mes adelantado con
imputación de ajustes diferida, y una interfaz de usuario más clara.

Backend:
- **Facturación por Empresa:** Se modifica `FacturacionService` para
  agrupar las suscripciones por cliente y empresa, generando una
  factura consolidada para cada combinación. Esto asegura la correcta
  separación fiscal.
- **Imputación de Ajustes:** Se ajusta la lógica para que la facturación
  de un período (ej. Septiembre) aplique únicamente los ajustes
  pendientes cuya fecha corresponde al período anterior (Agosto).
- **Cierre Secuencial:** Se implementa una validación en
  `GenerarFacturacionMensual` que impide generar la facturación de un
  período si el anterior no ha sido cerrado, garantizando el orden
  cronológico.
- **Emails Consolidados:** El proceso de notificación automática al
  generar el cierre ahora envía un único email consolidado por
  suscriptor, detallando los cargos de todas sus facturas/empresas.
- **Envío de PDF Individual:** Se refactoriza el endpoint de envío manual
  para que opere sobre una `idFactura` individual y adjunte el PDF
  correspondiente si existe.
- **Repositorios Mejorados:** Se optimizan y añaden métodos en
  `FacturaRepository` y `AjusteRepository` para soportar los nuevos
  requisitos de filtrado y consulta de datos consolidados.

Frontend:
- **Separación de Vistas:** La página de "Facturación" se divide en dos:
  - `ProcesosPage`: Para acciones masivas (generar cierre, archivo de
    débito, procesar respuesta).
  - `ConsultaFacturasPage`: Una nueva página dedicada a buscar,
    filtrar y gestionar facturas individuales con una interfaz de doble
    acordeón (Suscriptor -> Empresa).
- **Filtros Avanzados:** La página `ConsultaFacturasPage` ahora incluye
  filtros por nombre de suscriptor, estado de pago y estado de
  facturación.
- **Filtros de Fecha por Defecto:** La página de "Cuenta Corriente"
  ahora filtra por el mes actual por defecto para mejorar el rendimiento
  y la usabilidad.
- **Validación de Fechas:** Se añade lógica en los filtros de fecha para
  impedir la selección de rangos inválidos.
- **Validación de Monto de Pago:** El modal de pago manual ahora impide
  registrar un monto superior al saldo pendiente de la factura.

Backend/GestionIntegral.Api/Services/Reportes/ReportesService.cs

@@ -1,21 +1,31 @@
+using GestionIntegral.Api.Data.Repositories.Distribucion;
 using GestionIntegral.Api.Data.Repositories.Reportes;
+using GestionIntegral.Api.Data.Repositories.Suscripciones;
 using GestionIntegral.Api.Dtos.Reportes;
-using Microsoft.Extensions.Logging;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
 
 namespace GestionIntegral.Api.Services.Reportes
 {
     public class ReportesService : IReportesService
     {
         private readonly IReportesRepository _reportesRepository;
+        private readonly IFacturaRepository _facturaRepository;
+        private readonly IFacturaDetalleRepository _facturaDetalleRepository;
+        private readonly IPublicacionRepository _publicacionRepository;
+        private readonly IEmpresaRepository _empresaRepository;
+        private readonly ISuscriptorRepository _suscriptorRepository;
+        private readonly ISuscripcionRepository _suscripcionRepository;
         private readonly ILogger<ReportesService> _logger;
 
-        public ReportesService(IReportesRepository reportesRepository, ILogger<ReportesService> logger)
+        public ReportesService(IReportesRepository reportesRepository, IFacturaRepository facturaRepository, IFacturaDetalleRepository facturaDetalleRepository, IPublicacionRepository publicacionRepository, IEmpresaRepository empresaRepository
+            , ISuscriptorRepository suscriptorRepository, ISuscripcionRepository suscripcionRepository, ILogger<ReportesService> logger)
         {
             _reportesRepository = reportesRepository;
+            _facturaRepository = facturaRepository;
+            _facturaDetalleRepository = facturaDetalleRepository;
+            _publicacionRepository = publicacionRepository;
+            _empresaRepository = empresaRepository;
+            _suscriptorRepository = suscriptorRepository;
+            _suscripcionRepository = suscripcionRepository;
             _logger = logger;
         }
 
@@ -520,5 +530,25 @@ namespace GestionIntegral.Api.Services.Reportes
                 return (Enumerable.Empty<ListadoDistCanMensualPubDto>(), "Error al obtener datos del reporte (por publicación).");
             }
         }
+
+        public async Task<(IEnumerable<FacturasParaReporteDto> Data, string? Error)> ObtenerFacturasParaReportePublicidad(int anio, int mes)
+        {
+            if (anio < 2020 || mes < 1 || mes > 12)
+            {
+                return (Enumerable.Empty<FacturasParaReporteDto>(), "Período no válido.");
+            }
+            var periodo = $"{anio}-{mes:D2}";
+            try
+            {
+                // Llamada directa al nuevo método del repositorio
+                var data = await _reportesRepository.GetDatosReportePublicidadAsync(periodo);
+                return (data, null);
+            }
+            catch (Exception ex)
+            {
+                _logger.LogError(ex, "Error en servicio al obtener datos para reporte de publicidad para el período {Periodo}", periodo);
+                return (new List<FacturasParaReporteDto>(), "Error interno al generar el reporte.");
+            }
+        }
     }
 }